Tubient
Overview

Welcome to Tubient

Tubient is an advanced visual analytics platform for YouTube creators, providing high-fidelity pipelines and AI-driven growth insights.

The Analytics Pipeline

Unlike traditional static dashboards, Tubient uses a pipeline architecture. You define your analysis by connecting functional nodes on a visual canvas. This approach gives you total flexibility to filter, combine, and visualize metrics exactly how you need them.

Whether you're tracking hourly subscriber surges or deep-diving into the search keywords of your latest viral hit, Tubient's nodes provide the building blocks for professional-grade channel analysis.

Key Capabilities

AI Orchestration

Describe what you want to see in plain English, and our Gemini-powered assistant will build the pipeline for you instantly.

High-Fidelity Sync

Direct integration with YouTube Data and Analytics APIs ensures you're always looking at high-fidelity performance metrics.

Visual Insights

Switch between temporal trends and categorical snapshots (Geo, Traffic, Search) without losing your context.

User Interface

The Dashboard

The Tubient dashboard is split into two primary interaction zones, designed to keep your data at the top and your logic at the bottom.

Active Viewing Area (Top)

The top 40% of the screen is dedicated to your Live Chart. All temporal metrics (data that changes over time) are plotted here as color-coded lines. When you add nodes that provide "snapshot" data (like geographic breakdowns), separate panels dynamically appear below the main line chart.

  • Temporal Chart: Multi-series lines for views, subscribers, watch time, etc.
  • Snapshot Panels: Categorical data shown as Bar or Pie charts. Each panel features an independent toggle to switch its visualization mode.
  • Interactive Legend: Click series legend labels to toggle visibility.

Pipeline Canvas (Bottom)

The bottom area is a high-performance interactive canvas powered by our visual engine. This is where your logic lives. Nodes are connected from left to right, matching the flow of data processing.

Common Flow: Date RangeFilter NodeMetric Node or Numeric Node

Smart Breakdowns

Tubient uses an intelligent detection system to manage complex data relationships. When you connect a Filter Node to a Metric Node:

  • Interactive Mode: If the metric supports per-video data (e.g., Views, Subscribers), the Filter Node displays interactive color dots. Clicking a video title isolates its data in the chart.
  • Aggregate Mode: If the metric is a channel-wide average (e.g., CTR, Average View Duration), the Filter Node hides its dots, and the Metric Node displays a single aggregate line.
  • Visual Clarity: To reduce clutter, the aggregate dot on a Metric Node automatically hides when it is successfully connected to an interactive filter, signaling that the data is now being driven by individual items.
Onboarding

Interactive Walkthrough

To help you get started, Tubient features a guided 6-step tour that highlights the most important areas of the dashboard.

Tour Highlights

  • Temporal Chart: Understanding the persistent line chart at the top.
  • Pipeline Canvas: How to connect and manage nodes.
  • AI Assistant: Building dashboards using natural language.
  • Session History: Saving and restoring your work.
  • Resource Usage: Monitoring your YouTube and AI quotas.
  • Global Settings: Customizing your experience (themes, fonts).

How to Reset

If you need to revisit the tour at any time, you can reset it from the Onboarding section in the Global Settings panel.

  1. Open Settings from the sidebar.
  2. Scroll down to the Onboarding section.
  3. Click Reset & Close. The tour will restart immediately.
Visualization

Temporal vs Snapshot

Tubient handles two distinct types of data, and visualizes them accordingly to ensure clarity.

Temporal Charts (Line)

Temporal charts show how a metric trends over a specific time window. These are the primary lines you see at the top of the dashboard.

Examples: Daily Views, Cumulative Subscribers, Watch Time Growth

Metric nodes support an interactive Cumulative toggle directly on the node body. When enabled, the chart shows the running total over the period (marked with a symbol), helping you visualize total growth. When disabled, it shows discrete daily values to highlight spikes and trends.

Snapshot Charts (Bar/Pie)

Snapshot charts represent the "State of the Channel" for a given period. Unlike temporal charts, these focus on proportions and categorical distribution. Each snapshot panel includes an independent toggle in its header, allowing you to flip between a Bar chart for precise value comparison and a Pie chart for understanding percentage share.

  • Traffic Sources YouTube Search vs External vs Suggested
  • Device Types Mobile vs Desktop vs Tablet vs TV
  • Geographic Views and Watch Time by Country
  • Search Keywords The top keywords people type to find you
AI Assistant

Talk to your Data

The AI Chat (powered by Gemini) is the fastest way to build your dashboard. Instead of drag-and-dropping nodes manually, you can simply ask for the insights you need.

"Show me my subscriber growth over the last 90 days"

The AI will interpret this query, select the Channel Subscribers tool, set the time range to 90 days, enable cumulative tracking, and automatically create the nodes on your canvas.

Example Queries to Try:

  • Performance: "How is my watch time trending this month?"
  • Audience: "Show me a breakdown of where my viewers are from."
  • Discovery: "What are the top search terms for my channel?"
  • Comparison: "Show me subs gained vs lost for the last year."
  • Deep Dive: "Show me the CTR for my 5 latest videos."

Intelligence Features

Context Caching: We cache your large analytics instructions on the server, providing faster responses and 90% lower credit costs.

Intelligent Parameters: The AI automatically resolves "this week", "last year", or "all time" into the correct numeric values for the YouTube API.

@Mentions: Type @ in the chat input to search for specific videos. This allows you to link specific content directly to downstream metric nodes.

Intent Matching: Asking for "growth" or "total" automatically triggers cumulative charts, while asking for "daily" or "net" triggers discrete line charts.

Reference

Node Reference

Date Range

The primary driver of the pipeline. It outputs a time window from its Cyan port. Any node requiring a date input can be connected here. If no connection is present, nodes default to a 28-day window.

Presets: 7 Days, 28 Days, 90 Days, 365 Days, All Time.

Filter Node

Narrows your analysis to specific videos. It accepts a Cyan date input and outputs a list of videos from its Amber port. You can select individual videos to isolate them in a chart.

Tools: Top Videos, Latest Videos, Top Growth, Worst Retention, Best Retention, Playlists.

Metric Node

The temporal plotting engine. Uses a Red input handle. If connected to an Amber data source, it plots per-video lines; if connected to a Cyan date source, it shows channel-wide totals with a stable color indicator dot.

Metrics: Views, Subscribers, Likes, Comments, Shares, CTR, Watch Hours, AVD.

Numeric Node

Calculates point-in-time metrics based on an input. Uses an Orange input handle. These nodes display a single prominent number (e.g., total views in a period) but do not generate trend lines in the main chart.

Metrics: Period Views, Subscribers Gained, Watch Hours, etc.

Stats Node

Displays standalone channel overview data. These nodes are standalone and do not accept input handles. They provide a high-level summary of your channel's public state.

Tools: Channel Overview, Total Subscribers, Total Videos.

Time Control

Date Range Node

The Date Range Node is the primary driver of your analytics pipeline. It defines the temporal window for all connected nodes.

Core Functionality

Every analysis starts with a time frame. The Date Range node outputs a standardized date object from its Cyan handle. When you connect this to other nodes, they automatically sync their data fetching to match this period.

  • Input: None (Primary Source)
  • Output: date-out (Cyan handle)
  • Presets: 7 Days, 28 Days, 90 Days, 365 Days, All Time

Sample Prompts

"Show me data for the last 90 days"
"What's my performance this week?"
"Show me everything from the last year"
Content Selection

Filter Node

The Filter Node narrows your analysis to specific videos or playlists based on performance or recency.

Capabilities & Tools

Filter nodes act as "selectors" for your channel's content. They accept a date input and provide a list of videos to downstream metric nodes.

  • Top Videos Rank videos by total view volume within the period.
  • Latest Videos Focus on your most recent uploads and their immediate impact.
  • Top Growth Identify videos driving the most new subscribers.
  • Retention Analysis Find videos with the best (or worst) audience retention percentages.
  • Playlists List specific playlists or analyze playlist-wide performance.

Interactive Filtering

Once a Filter node is connected to a Metric node, it displays a list of videos. Click any video title to isolate its data line in the main chart. The associated color dot helps you track multiple video trends simultaneously.

Sample Prompts

"Which videos grew my channel the most this month?"
"Show me my 5 latest uploads"
"Rank my playlists by view count"
Analytics Plotter

Metric Node

The Metric Node is the engine that generates time-series lines for the persistent chart at the top of your dashboard.

Available Metrics

Views & Subs

Total views, net subscribers, and growth trends.

Watch Time

Total watch hours and average view duration (AVD).

Engagement

The sum of Likes, Comments, and Shares, providing a combined interaction score.

Efficiency

Click-through rate (CTR) and gains vs losses breakdown.

Discrete vs Cumulative

Metric nodes feature a Cumulative toggle located on the node body. When enabled, the chart displays the running total over the selected period (indicated by a in the title), helping you visualize total growth. When disabled, it shows the discrete daily values to highlight spikes and trends.

Sample Prompts

"Show me my cumulative subscriber growth"
"Plot my daily watch hours for the last 90 days"
"Compare subscribers gained vs lost this year"
Point-in-Time

Numeric Node

The Numeric Node calculates specific totals or values for a given period or video filter, displaying the result as a prominent headline figure.

Functionality

Numeric nodes are used when you need a single answer (e.g., "Total views last month") rather than a trend line. They accept input from Date or Filter nodes and update dynamically as the upstream source changes.

  • Input: in (Orange handle)
  • Output: None (Terminal Node)
  • Visual: Bold numeric value with metric label.

Sample Prompts

"How many views did I get in the last 28 days?"
"What is the total subscriber gain for my top videos?"
"Total watch hours this year"
Overview Snapshot

Stats Node

The Stats Node provides a high-level summary of your channel's public information and lifetime performance.

Standalone Overview

Unlike other nodes, Stats nodes are standalone. They do not accept input connections and instead fetch the most relevant channel-wide information automatically. They are perfect for keeping your current "headline" stats visible on your canvas at all times.

  • Channel Overview A multi-metric summary of subscribers, views, and video counts.
  • Total Subscribers Your current lifetime subscriber count.
  • Total Videos The total number of public videos on your channel.

Sample Prompts

"Give me an overview of my channel"
"What are my total stats?"
Infrastructure

Persistence & Sync

Tubient ensures your work is never lost. We use a multi-layered sync system to keep your dashboards available across all your devices.

Cloud Synchronization

Your progress is automatically synchronized with your private cloud database at regular intervals and whenever you switch sessions. This includes:

  • Current node positions and connections
  • Active chart configurations and visibility toggles
  • Your entire conversation history with the AI
  • Channel-specific settings and preferences

Multi-Channel Support

If you manage multiple YouTube channels under one Google account, Tubient keeps them perfectly separated. Switching channels in the menu will instantly load that channel's last active session and history.

Pro Tip: All session data is ephemeral and can be managed via the History Panel. You can restore points in time or delete entire sessions to start fresh.

Note: To protect your active workflow, the most recent session in your history cannot be deleted. Additionally, selecting your already active session from the history list will close the panel without reloading, keeping your current progress intact.