TubeLogic
Overview

Welcome to TubeLogic

TubeLogic is an advanced visual analytics platform for YouTube creators, providing real-time pipelines and AI-driven growth insights.

The Analytics Pipeline

Unlike traditional static dashboards, TubeLogic 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, TubeLogic'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.

Live Data Sync

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

Visual Insights

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

User Interface

The Dashboard

The TubeLogic 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.
  • Real-time 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 Range → Filter Node → Metric Node

Smart Breakdowns

TubeLogic 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, TubeLogic 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

TubeLogic 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

Most temporal nodes support a Cumulative toggle. When enabled, the chart shows the running total over the period rather than the daily discrete values.

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 Universal 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.

Stat Node

Displays point-in-time stats or categorical breakdowns. Uses a Universal input handle. When in "Breakdown" mode, it generates Bar/Pie charts in the dashboard panels.

Tools: Traffic, Devices, Geography, Keywords, Tags, Demographics, OS, Overview.

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"

Visual Guide

The node features a clear dropdown for selecting presets. The active selection is highlighted in the node body, and the Cyan output port glows when successfully driving downstream nodes.

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

Likes, comments, shares, and combined engagement score.

Efficiency

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

Discrete vs Cumulative

Most metric nodes feature a Cumulative toggle. When enabled, the chart displays the running total over the selected period, 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"
Dynamic Breakdown

Stat Node

The Stat Node provides snapshots of your channel's state, ranging from high-level overviews to detailed categorical breakdowns.

Breakdown Categories

In Breakdown mode, the Stat node generates dynamic panels below the main line chart. Each panel supports a Bar/Pie toggle in its header.

  • Traffic Sources YouTube Search, Suggested, External, Browse, etc.
  • Geographic Top countries by views and watch time.
  • Device & OS Breakdowns of mobile, desktop, TV, and operating systems.
  • Keywords The top search terms driving viewers to your channel.
  • Demographics Age and gender distribution of your audience.

Channel Overview

When disconnected from a Date or Filter source, the Stat node provides a standalone Channel Overview. This is a text-based summary of your lifetime or recent performance across all key metrics.

Sample Prompts

"Where does my traffic come from?"
"What are the top search keywords for my channel?"
"Give me an overview of my performance this month"
Infrastructure

Persistence & Sync

TubeLogic 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, TubeLogic 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.