FlipTracker Training Guide
Complete step-by-step guide for administrators and operators
Overview
FlipTracker is a media intelligence platform that monitors YouTube channels, transcribes video content, and uses AI to detect contradictions (flips) in public statements made by speakers (politicians, public figures, etc.).
What FlipTracker Does
The system operates as a pipeline: you set up speakers and channels, then the platform automatically discovers, downloads, transcribes, and analyzes videos to find contradictions.
Logging In
Navigate to your FlipTracker URL followed by /admin/ in your browser.
Type your email address and password. These are provided by your administrator when your account is created.
If this is your first login via an invite link, you will be prompted to set a new password. Passwords must contain: 8+ characters, uppercase, lowercase, number, and a special character.
Dashboard
The Dashboard gives you a real-time overview of the entire system at a glance.
What You See
Stats include: number of speakers, active background jobs, total detected flips, verified flips, meme videos generated, credit balance (if billing is active), and server uptime.
Speakers
Speakers are the public figures being tracked for contradictions. Every video analysis, flip detection, and intelligence dossier is linked to a speaker.
Adding a Speaker
The button is at the top of the Speakers page.
Name (required) — full name of the public figure.
Party / Organization — political party or organization.
Designation — current title (e.g., "Member of Parliament").
Photo URL — link to a profile photo.
Bio — brief background information.
The speaker is now available for linking to channels, video analysis, and dossier creation.
| Name | Party | Designation | Channels | Flips | Actions |
|---|---|---|---|---|---|
| Rahul Gandhi | INC | Leader of Opposition | 5 | 23 | Edit |
| Amit Shah | BJP | Home Minister | 8 | 31 | Edit |
| Arvind Kejriwal | AAP | Former CM, Delhi | 3 | 18 | Edit |
Channels
Channels are the YouTube channels being monitored for new videos. Each channel can be linked to a speaker (as the channel owner) and can track appearances of multiple speakers.
Adding a Channel
Supported formats: youtube.com/@handle, youtube.com/channel/UCxxxx, youtube.com/c/name
If this is the speaker's own channel, select them from the dropdown. For news channels, select "None".
The system resolves the URL, fetches channel metadata (name, thumbnail, subscriber count), and adds it to your tracking list.
Scanning a Channel
Scanning fetches video listings from a YouTube channel and adds them to your Video Queue.
A modal dialog will appear with scan options.
Keywords — filter videos by keyword (optional).
Published After / Before — limit to a date range.
Max Results — choose 50, 100, 200, 500, or all videos.
A background job is created. New videos appear in the Video Queue as "Pending".
Tracking Speakers on a Channel
Use the "Track" button to specify which speakers appear on a channel (e.g., a news channel may feature multiple politicians). This helps the AI know whose statements to extract during analysis.
| Channel | Owner / Tracked | Subscribers | Last Scanned | Scanning | Actions |
|---|---|---|---|---|---|
| NDTV | News · 3 tracked | 32.1M | 2 hrs ago | On | Scan Track |
| Rahul Gandhi | Rahul Gandhi | 4.8M | 1 day ago | On | Scan |
Video Queue
The Video Queue shows all videos discovered from channel scans and their current processing status.
Video Processing Pipeline
Processing a Video
Use filters (status, speaker, date range) or the search bar to find specific videos.
This queues the video for the full pipeline: download audio, transcribe with Deepgram, then analyze with AI for statements and contradictions.
Switch to the Jobs section to see real-time progress. The video status will update automatically.
| Title | Speaker | Channel | Published | Status | Actions |
|---|---|---|---|---|---|
| Budget Session Day 3 Highlights | Rahul Gandhi | NDTV | 15 Mar 2026 | Done | |
| Press Conference on Economy | Amit Shah | BJP Official | 14 Mar 2026 | Transcribing | |
| Morning Debate Panel | Mixed | Republic TV | 13 Mar 2026 | Pending | Process Skip |
Transcripts
Full-text search across all transcribed video content. Use this to find specific statements, quotes, or topics across your entire video library.
Searching Transcripts
Type any keyword, phrase, or topic (e.g., "inflation", "border security", "farmer protest").
Results show video title, speaker name, and matching transcript segments with timestamps.
Click any result to see the full transcript with all segments and their timestamps.
Add Transcript (Legacy Import)
Bulk-import transcripts from external sources using an Excel mapping file and text files.
Step-by-Step Import
Create an .xlsx file with columns: filename, YouTube URL, speaker name. Each row maps a transcript text file to a video and speaker.
Drag and drop or click to upload the mapping file.
Upload the .txt transcript files referenced in the Excel. You can also use SFTP upload for large batches.
The system shows how many files matched, which speakers were found, and any errors.
The system downloads the videos, stores the transcripts, and optionally runs Deepgram verification on random samples.
Flips (Contradiction Detection)
Flips are AI-detected contradictions where a speaker said one thing at one point in time and something contradictory at another. This is the core output of FlipTracker.
Understanding a Flip
Each flip contains:
- Statement A — the original statement (with date and context)
- Statement B — the contradicting statement (with date and context)
- Severity — Minor, Moderate, Major, or Extreme
- Summary — AI-generated explanation of the contradiction
Reviewing Flips
Use filters for status (Detected, Verified, Rejected), severity, or speaker. Click a flip to see its details.
The detail panel shows Statement A and Statement B side by side with their dates, full text, and context.
Verify — confirms the flip is a genuine contradiction.
Reject — marks it as a false positive (not a real contradiction).
Intelligence Module
The Intelligence module provides deep research dossiers on speakers — structured knowledge bases, AI-powered analysis, pattern detection, and exportable reports.
Creating a Dossier
Select a speaker who doesn't already have a dossier.
Give the dossier a descriptive title and add analyst notes for context.
Statements, transcripts, and social media content already in the system are automatically added to the knowledge base.
Dossier Tabs
| Tab | Purpose |
|---|---|
| Overview | Speaker profile summary and key statistics |
| Discover | Search YouTube for new videos featuring the speaker across all tracked channels |
| Knowledge Base | All collected items — statements, tweets, video segments, notes. Filterable by type and searchable |
| Analysis | AI-generated analysis summaries, thematic breakdowns, and insights |
| Patterns | Detected narrative patterns, topic frequency, contradiction trends |
| Export | Download dossier as PDF report or JSON data |
Discovering New Videos
Set a date range and maximum results per channel.
The system searches your local database first (free, instant), then the YouTube API for new videos.
Selected videos are queued for download, transcription, and analysis. Use the keyword filter to narrow results.
Meme Videos
FlipTracker can auto-generate short highlight videos from detected flips — placing both contradictory statements side-by-side with visual effects.
Generating a Meme Video
Type the ID of a verified flip you want to create a video for.
A background job is created to generate the video. This may take a few minutes.
Once completed, click "Preview" to watch the video. You can also regenerate if needed.
Jobs
The Jobs section shows all background processing tasks in real-time. It auto-refreshes every 30 seconds.
Job Types
| Type | What It Does | Typical Duration |
|---|---|---|
| Download | Downloads audio from YouTube | 1-5 minutes |
| Transcribe | Converts audio to text (Deepgram) | 1-3 minutes |
| Analyze | AI analysis of transcript content | 2-5 minutes |
| Detect Flips | Finds contradictions across statements | 1-3 minutes |
| Scan Channel | Fetches new video listings from YouTube | 30-60 seconds |
| Generate Script | Creates meme video script | 1-2 minutes |
| Generate Video | Renders meme video | 3-10 minutes |
Managing Jobs
Cancel — stop a queued or claimed job before it starts processing.
Retry — re-queue a failed or cancelled job for another attempt.
| Type | Status | Progress | Created | Actions |
|---|---|---|---|---|
| Transcribe | Running | 60% | 2 min ago | |
| Download | Done | 100% | 5 min ago | |
| Analyze | Failed | 0% | 10 min ago | Retry |
Users
Manage your team members — invite new users, assign roles, and control access.
Inviting a New User
Available to administrators only.
The user will receive an email invite with a link to set their password.
Choose from predefined roles (Admin, Researcher, Editor, Viewer) or any custom role created in the Roles section.
The user appears as "Pending" until they accept the invite and set their password.
User Management
Resend Invite — for pending users who didn't receive or lost the invite email.
Change Role — update a user's role and permissions.
Disable/Enable — temporarily suspend or reactivate an account.
Remove — permanently delete a user account.
Teams
Organize users into collaborative teams. Teams can be used to assign work and manage access to specific speakers or channels.
Company Branding
The Teams page also lets administrators upload a company logo (PNG, JPG, or SVG, max 2MB). The logo appears in the sidebar for all users.
Creating a Team
Enter a team name and optional description.
Open the team and click "Add Member" to select users from your organization.
Roles & Permissions
Define custom roles with granular permissions to control exactly what each user can see and do.
Built-in Roles
| Role | Access Level |
|---|---|
| Admin | Full access to all features including user management |
| Researcher | Can manage speakers, channels, videos, and view analysis |
| Editor | Can review and verify flips, manage content |
| Viewer | Read-only access to dashboard, flips, and transcripts |
Creating a Custom Role
Enter an internal name (e.g., content_editor) and a display name (e.g., "Content Editor").
Open the role and check/uncheck individual permissions. Permissions are grouped by feature (speakers, channels, videos, etc.).
Go to Users and change a user's role to the new custom role.
Settings
View system health and status information.
API Server Status — shows whether the server is online.
Uptime — how long the server has been running since last restart.
Server Time — current server time (refreshes every 30 seconds).
Frequently Asked Questions
Processing Pipeline
Understanding the full end-to-end flow from channel scan to flip detection.
Stage Details
| Stage | What Happens | Output |
|---|---|---|
| Channel Scan | YouTube API fetches video listings from tracked channels | New videos added to queue as "Pending" |
| Download | Audio extracted from YouTube video | Audio file stored on server |
| Transcribe | Deepgram speech-to-text with speaker diarization | Timestamped transcript segments |
| Analyze | AI reads transcript and extracts speaker statements, topics, and context | Structured statements linked to speakers |
| Detect Flips | AI compares new statements against all previous statements by the same speaker | Contradictions (flips) with severity ratings |
Permissions Reference
Complete list of all permissions available in the system.
| Permission | Grants Access To |
|---|---|
| dashboard.read | View the dashboard and system stats |
| speakers.read | View speakers list |
| speakers.create | Add and edit speakers |
| speakers.delete | Delete speakers |
| channels.read | View channels list |
| channels.create | Add channels and resolve URLs |
| channels.scan | Trigger channel scans |
| channels.delete | Delete channels |
| videos.read | View video queue |
| videos.process | Queue videos for processing |
| transcripts.read | Search and read transcripts |
| flips.read | View detected flips |
| flips.verify | Verify or reject flips |
| intel.read | View intelligence dossiers |
| intel.create | Create dossiers and add items |
| intel.analyze | Run AI analysis on dossiers |
| intel.export | Export dossier reports |
| meme_videos.read | View meme videos |
| meme_videos.generate | Generate new meme videos |
| jobs.read | View background jobs |
| jobs.cancel | Cancel queued jobs |
| jobs.retry | Retry failed jobs |
| users.read | View user list |
| users.create | Invite new users |
| users.update | Edit user roles and status |
| users.delete | Remove users |
| teams.read | View teams |
| teams.create | Create teams and add members |
| roles.read | View roles and permissions |
| roles.manage | Create and edit custom roles |
| settings.read | View system settings |
For support, contact your system administrator.