# ScrollClip Studio — Desktop Application Master User Manual & Workflow Guide > **Official Hardware Workstation Documentation** > *Version: 1.4.0 • Offline-Ready Native Desktop Studio for macOS & Windows* > *Powered by ScrollClip Neural Architecture & Google Gemini AI Viral Intelligence* --- ## Welcome to ScrollClip Studio ScrollClip Studio is a dedicated, on-device desktop video workstation designed to convert long-form videos into high-retention 9:16 vertical shorts (TikTok, YouTube Shorts, Instagram Reels) with zero cloud upload delays, zero monthly subscription fees, and unlimited local rendering. This manual provides an exhaustive, button-by-button reference for every screen, configuration parameter, pipeline phase, and editing tool available within the desktop application. --- ## Table of Contents - [Chapter 1: Installation, System Environment & Machine Activation](#chapter-1-installation-system-environment--machine-activation) - [1.1 Hardware & Operating System Specifications](#11-hardware--operating-system-specifications) - [1.2 First Launch & Secure Credential Verification](#12-first-launch--secure-credential-verification) - [1.3 Workstation License Activation Dialog](#13-workstation-license-activation-dialog) - [1.4 System Environment & AI Setup Check](#14-system-environment--ai-setup-check) - [Chapter 2: Settings Page — Complete Parameter & Button Reference](#chapter-2-settings-page--complete-parameter--button-reference) - [2.1 General Settings Tab](#21-general-settings-tab) - [2.2 Processing & AI Settings Tab](#22-processing--ai-settings-tab) - [2.3 Subtitle Styling Settings Tab](#23-subtitle-styling-settings-tab) - [2.4 Performance & Hardware Acceleration Tab](#24-performance--hardware-acceleration-tab) - [2.5 Storage & Cache Management Tab](#25-storage--cache-management-tab) - [2.6 License & Device Management Tab](#26-license--device-management-tab) - [Chapter 3: Project Ingestion & Configuration (Input Step)](#chapter-3-project-ingestion--configuration-input-step) - [3.1 Media Source Input (URL vs. Local File)](#31-media-source-input-url-vs-local-file) - [3.2 Media Metadata Probing](#32-media-metadata-probing) - [3.3 Reel Generation Configuration Panel](#33-reel-generation-configuration-panel) - [3.4 Subtitle Styler Sidebar](#34-subtitle-styler-sidebar) - [3.5 Project History & Session Resumption](#35-project-history--session-resumption) - [3.6 Triggering Generation](#36-triggering-generation) - [Chapter 4: The 5-Stage Automated Processing Pipeline](#chapter-4-the-5-stage-automated-processing-pipeline) - [4.1 Stage 1: Media Ingestion & Asset Caching](#41-stage-1-media-ingestion--asset-caching) - [4.2 Stage 2: Audio Demuxing & Loudness Leveling](#42-stage-2-audio-demuxing--loudness-leveling) - [4.3 Stage 3: Neural Speech-to-Text Transcription](#43-stage-3-neural-speech-to-text-transcription) - [4.4 Stage 4: Gemini AI Viral Intelligence & Hook Analysis](#44-stage-4-gemini-ai-viral-intelligence--hook-analysis) - [4.5 Stage 5: Dynamic 9:16 Speaker Tracking & Preview Rendering](#45-stage-5-dynamic-916-speaker-tracking--preview-rendering) - [4.6 Console Diagnostics & Pipeline Controls](#46-console-diagnostics--pipeline-controls) - [Chapter 5: Review & Multi-Clip Selection](#chapter-5-review--multi-clip-selection) - [5.1 Virality Score Ranking & Indicators](#51-virality-score-ranking--indicators) - [5.2 Interactive Clip Previews & Fullscreen Player](#52-interactive-clip-previews--fullscreen-player) - [5.3 Viral Hook & Social Intelligence Inspector](#53-viral-hook--social-intelligence-inspector) - [5.4 Step Navigation & Hand-Off Actions](#54-step-navigation--hand-off-actions) - [Chapter 6: The Full Editor Studio](#chapter-6-the-full-editor-studio) - [6.1 Studio Layout Overview](#61-studio-layout-overview) - [6.2 Left Panel: Multi-Clip Queue & Selection](#62-left-panel-multi-clip-queue--selection) - [6.3 Center Panel: Canvas, Scrubber & Mode Toggles](#63-center-panel-canvas-scrubber--mode-toggles) - [6.4 Bottom Panel: Word-by-Word Interactive Transcript Editor](#64-bottom-panel-word-by-word-interactive-transcript-editor) - [6.5 Right Panel: Subtitle Styler & AI Intelligence Card](#65-right-panel-subtitle-styler--ai-intelligence-card) - [6.6 Fast Style Re-render vs. Deep Pipeline Re-run](#66-fast-style-re-render-vs-deep-pipeline-re-run) - [6.7 Single Clip & Batch Export Queue](#67-single-clip--batch-export-queue) - [Chapter 7: Troubleshooting, Support & Pro Tips](#chapter-7-troubleshooting-support--pro-tips) - [7.1 GPU Acceleration & Hardware Diagnostics](#71-gpu-acceleration--hardware-diagnostics) - [7.2 Handling Protected or Geo-Restricted Videos](#72-handling-protected-or-geo-restricted-videos) - [7.3 Official Customer Support Channels](#73-official-customer-support-channels) --- ## Chapter 1: Installation, System Environment & Machine Activation ### 1.1 Hardware & Operating System Specifications ScrollClip runs locally on your workstation to deliver unlimited video processing with maximum privacy. | Component | Minimum Specification | Recommended Workstation | | :--- | :--- | :--- | | **macOS** | macOS 12 (Monterey) or later | macOS 14 (Sonoma) or macOS 15 (Sequoia) | | **Mac Processor** | Intel Core i5 or Apple M1 | Apple Silicon M2, M3, or M4 (Pro / Max / Ultra) | | **Windows OS** | Windows 10 (64-bit, Build 19041+) | Windows 11 (64-bit) | | **Windows Processor** | Intel Core i5 (8th Gen+) or AMD Ryzen 5 | Intel Core i7/i9 (12th Gen+) or AMD Ryzen 7/9 | | **Graphics (GPU)** | Integrated Graphics (Intel UHD / Iris Xe) | Dedicated GPU: NVIDIA GeForce RTX 3060+ or AMD Radeon RX 6700+ | | **Memory (RAM)** | 8 GB Unified / DDR4 RAM | 16 GB to 32 GB RAM | | **Disk Space** | 4 GB free storage | 20 GB free high-speed NVMe / SSD storage | --- ### 1.2 First Launch & Secure Credential Verification Upon starting ScrollClip Studio: 1. **Startup Splash Screen**: A high-speed splash screen initiates, verifying local system credentials and loading your customized Material Design 3 color palette. 2. **Credential Cache**: ScrollClip checks your operating system's secure local key store to identify whether an active lifetime workstation license exists. 3. If no active license is found, the **Activation Dialog** automatically displays to guide your one-time machine registration. --- ### 1.3 Workstation License Activation Dialog The **Activation Dialog** is a secure modal interface that binds your software license to your physical computer. ``` ┌─────────────────────────────────────────────────────────────┐ │ SCROLLCLIP STUDIO │ │ WORKSTATION ACTIVATION │ ├─────────────────────────────────────────────────────────────┤ │ Enter your checkout email and permanent lifetime license │ │ key received in your purchase confirmation. │ │ │ │ License Email: │ │ [ customer@example.com ] │ │ │ │ License Key: │ │ [ SC-PRO-XXXXXXXX-XXXX ] │ │ │ │ [ ACTIVATE WORKSTATION ] (Cyan MD3 Elevated Button) │ │ │ │ 🔒 Cryptographic Machine Binding • 100% Offline Capable │ └─────────────────────────────────────────────────────────────┘ ``` #### Fields & Component Controls: - **`License Email` (Input Field)**: Enter the exact email address used during your purchase checkout. - **`License Key` (Monospace Input Field)**: Paste your lifetime key (`SC-PRO-XXXXXXXX-XXXX`). The field automatically strips leading/trailing spaces and hyphens. - **`Activate Workstation` (Primary Button)**: - Connects to the licensing endpoint to verify authenticity. - Generates a local cryptographic hardware signature based on your motherboard, CPU architecture, and machine identifier. - Stores a secure offline license certificate in your system keystore. - Once validated, the desktop app functions **100% offline without requiring continuous internet access**. --- ### 1.4 System Environment & AI Setup Check After activation (or via **Settings → Setup Check**), ScrollClip launches an automated environment validator to ensure all local processing engines are operational: 1. **Core Media Engine**: Validates the native multimedia decoder, video demuxer, and multi-threaded audio filter pipelines. 2. **Universal Web Ingestion Engine**: Confirms stream extraction capability for YouTube and public web video sources. 3. **Neural Speech Recognition Engine**: - Detects locally installed speech models. - **In-App Model Downloader**: - **Standard Neural Model (465 MB - Recommended)**: Ultra-fast transcription; processes 30 minutes of video in under 45 seconds on Apple Silicon and modern PCs. - **High-Fidelity Neural Model (1.5 GB)**: Maximum phonetic precision; ideal for multi-accent or heavy background audio tracks. - Features 1-click download with an interactive progress indicator and automatic checksum validation. 4. **Precision Face Tracking & Speaker Vision Engine**: Verifies local neural computer vision weights used to detect faces and calculate dynamic 9:16 speaker panning trajectories. 5. **Google Gemini AI Viral Intelligence Check**: - Validates your Google Gemini API key. - Provides an inline key input with a **"Validate Key"** test button. 6. **Hardware GPU Acceleration Test**: Pings your GPU to verify hardware encoding readiness (Apple Silicon Metal engine or Dedicated PC GPU encoder). --- ## Chapter 2: Settings Page — Complete Parameter & Button Reference The Settings Page (`SettingsPage.tsx`) provides centralized control over video processing, subtitle typography, hardware acceleration, and workstation licenses. It is organized into **6 dedicated tabs**: ``` [ General ] [ Processing & AI ] [ Subtitle Styling ] [ Performance ] [ Storage ] [ License ] ``` --- ### 2.1 General Settings Tab - **`Theme Mode` (Segmented Button Group)**: - `Dark`: Ultra-dark aesthetic (`#121212`) designed for high-contrast video editing. - `Light`: High-key clean interface for bright room environments. - `System`: Automatically synchronizes with your OS dark/light mode preference. - **`Theme Seed Color` (Color Picker)**: Choose any primary accent color. ScrollClip's dynamic engine algorithmically generates all 30+ Material Design 3 design tokens, surface tints, and active focus rings based on this seed. - **`Hardware Acceleration` (Switch Toggle)**: Enables direct GPU pipeline pass-through for frame demuxing and visual compositing. - **`Check for Updates on Launch` (Switch Toggle)**: When enabled, ScrollClip queries official release channels on launch and alerts you if a newer build is available. - **`Default Export Directory` (Path Display & "Browse Folder" Button)**: Opens your native file explorer (macOS Finder or Windows File Explorer) to select the destination folder where rendered viral shorts are saved. --- ### 2.2 Processing & AI Settings Tab - **`Default Clip Duration` (Select Dropdown)**: - Options: `⚡ Smart (Auto)`, `15s`, `30s`, `60s`, `90s`, `120s`, `150s`. - Determines the default segment length when a new video is loaded. - **`Default Speech Recognition Language` (Select Dropdown)**: - Options: `Auto-Detect Language` (default) plus 12 native language choices (English, Spanish, Indonesian, Portuguese, French, German, Japanese, Korean, Chinese, Arabic, Hindi, Russian). - **`Google Gemini AI API Key` (Secure Text Field & Actions)**: - Enter your free or paid Google Gemini API key. - **`Fetch Live Models` (Button)**: Connects to the Gemini endpoint and updates the model dropdown with all currently active models. - **`Gemini Model Selection` (Dropdown)**: Choose between `gemini-2.5-flash` (recommended for blazing speed and high virality accuracy), `gemini-3.5-flash`, or `gemini-2.5-pro`. - **`Framing Mode` (Segmented Button Group)**: - `Face Detection`: Centers strictly on detected human faces. - `Centered Crop`: Fixed 9:16 center cutout (ideal for single-subject webcam tutorials). - `Dynamic Active Speaker Tracking`: Advanced vision-based tracking that smoothly follows speaking subjects between cuts. - **`YouTube Cookies Import` (File Picker & Status Card)**: - Allows uploading a standard browser session cookies file (`cookies.txt`) to process private, unlisted, or age-restricted YouTube videos. --- ### 2.3 Subtitle Styling Settings Tab - **`Default Preset` (Preset Carousel / Card Picker)**: - `MrBeast`: Bold yellow-and-white uppercase kinetic captions with thick black outlines. - `Hormozi`: Dynamic green and white captions with active word bounce. - `Neon Cyber`: Cyan and magenta glowing captions designed for tech and gaming content. - `Minimalist`: Clean modern sans-serif subtitles with elegant semi-transparent backing. - `Karaoke`: Smooth left-to-right color wipe across active words. - **`Font Family` (Dropdown)**: Choose from bundled modern fonts (Inter, Montserrat, Poppins, Outfit, Bebas Neue, SF Pro, Roboto). - **`Font Size` (Slider: 24px – 96px)**: Sets the default caption typography scale. - **`Highlight Color` (Color Picker)**: The vibrant accent color applied to the word currently being spoken. - **`Outline / Stroke Width` (Slider: 0px – 16px)**: Adjusts border thickness to ensure readability over any background footage. - **`Subtitle Vertical Position` (Segmented Button: `Top`, `Center`, `Bottom`)**: Places the caption block on the screen, with an additional **`Y-Offset Slider`** for pixel-perfect vertical alignment. - **`Animated Emojis` (Switch Toggle)**: Automatically inserts contextual animated emojis (🔥, 🚀, 💡, 😱) above highlighted keywords. - **`Keyword Color Highlighting` (Switch Toggle)**: Highlights critical emotional words in accent colors. --- ### 2.4 Performance & Hardware Acceleration Tab - **`Hardware Acceleration Engine` (Select Dropdown)**: - `Apple Silicon GPU (Metal Accelerated)`: Ultra-fast native hardware encoding for Mac M1/M2/M3/M4. - `Dedicated PC GPU (Hardware Accelerated)`: Uses dedicated GPU video pipelines for zero-CPU rendering on Windows. - `High-Efficiency Software Mode`: Multi-core CPU fallback when no compatible GPU is detected. - **`Test GPU Hardware` (Elevated Button)**: Runs a real-time micro-benchmark and reports available GPU encoding capabilities directly in the app. - **`CPU Thread Allocation` (Slider: 1 to 16 Cores)**: Regulates how many CPU cores are dedicated to transcription and video rendering, leaving headroom for other desktop tasks. - **`Concurrency & Chunk Mode` (Dropdown)**: Controls whether multiple reels are rendered sequentially or in parallel. - **`Max Export Resolution` (Segmented Buttons)**: - `1080x1920 (FHD @ 60fps)`: Recommended standard for TikTok, Reels, and Shorts. - `1080x1920 (FHD @ 30fps)`: Smaller file size with standard broadcast cadence. - `720x1280 (HD)`: Rapid draft preview quality. --- ### 2.5 Storage & Cache Management Tab - **`Storage Breakdown Visualizer` (Multi-Segment Progress Meter)**: - Displays storage utilization across 4 categories: - **Video Cache**: Downloaded source files. - **Audio Cache**: Extracted 16kHz WAV and audio stem files. - **Temporary Renders**: Intermediate video chunks. - **Neural AI Weights**: Downloaded speech and face tracking models. - **`Open Cache Folder` (Outline Button)**: Instantly reveals the local app data folder in your OS file manager. - **`Clear Cache` (Tonal Red Button & Confirmation Modal)**: Purges temporary audio/video files safely without deleting completed exports or AI models. --- ### 2.6 License & Device Management Tab - **`License Key Display` (Monospace Box with 1-Click Copy)**: Shows your active lifetime key (`SC-PRO-XXXXXXXX-XXXX`). - **`Workstation Quota Indicator`**: Displays current active workstations vs. allowed seats (e.g. `1 / 1 Device(s) Active`). - **`Machine Hardware ID`**: Unique anonymous hardware token associated with your computer. - **`Ping License Server` (Button)**: Manually verifies server lease and updates account status. - **`Deactivate Workstation` (Button & Warning Dialog)**: Instantly releases your license from the current machine so you can activate ScrollClip on a new computer. --- ## Chapter 3: Project Ingestion & Configuration (Input Step) The **Input Step** (`InputStep.tsx`) is the launchpad for new projects. It allows you to provide media, preview its properties, and configure generation rules in seconds. ``` ┌───────────────────────────────────────────────────┬───────────────────────────────┐ │ MEDIA SOURCE INGESTION │ REEL CONFIGURATION │ │ │ │ │ [ Paste YouTube or Video Link URL ] │ Target Duration: │ │ [ PASTE FROM CLIPBOARD ] │ [ ⚡ Smart ] [ 30s ] [ 60s ] │ │ │ │ │ ─────────────────── OR ─────────────────── │ Reel Count: │ │ │ [=====o================] 3 │ │ ┌─────────────────────────────────────────────┐ │ │ │ │ DRAG & DROP MASTER VIDEO FILE │ │ Language: [ Auto-Detect v] │ │ │ MP4, MOV, MKV, or WEBM │ │ │ │ │ │ │ [x] Dynamic Face Tracking │ │ │ [ BROWSE LOCAL FILES ] │ │ [x] Kinetic Subtitles │ │ └─────────────────────────────────────────────┘ │ [x] Contextual Emojis │ │ │ │ │ [PROBE BADGE]: 1920x1080 • 59.94 fps • 18m 42s │ [ GENERATE VIRAL REELS → ] │ └───────────────────────────────────────────────────┴───────────────────────────────┘ ``` ### 3.1 Media Source Input (URL vs. Local File) 1. **Web URL Ingestion**: - Paste any valid YouTube or public video URL into the top text field. - Click **`Paste from Clipboard`** (Clipboard Icon Button) to auto-fill. - ScrollClip's universal ingestion engine checks the URL and queries available streams. 2. **Local Video File Ingestion**: - Drag and drop any video file directly from your desktop into the large dashed dropzone. - Or click **`Browse Local Files`** to open your OS file selector. - Supported formats: `.mp4`, `.mov`, `.mkv`, `.webm`, `.avi`, `.m4v`. Supports resolutions up to **4K (3840x2160) at 60 fps**. --- ### 3.2 Media Metadata Probing Once a file or URL is entered, the **Media Probe Engine** inspects the video stream and displays an interactive inspection badge: - **Resolution**: e.g., `3840x2160 (4K UHD)` or `1920x1080 (FHD)` - **Framerate**: e.g., `59.94 fps` or `29.97 fps` - **Total Duration**: e.g., `24m 18s` - **Audio Channels**: e.g., `Stereo (2 Channels) • 48.0 kHz` - **Video Codec**: e.g., `H.264 / AVC` or `HEVC / H.265` --- ### 3.3 Reel Generation Configuration Panel The right sidebar gives you granular control over the reels to be generated: 1. **`Clip Duration Preset` (Segmented Button Group)**: - `⚡ Smart (Auto)`: Google Gemini AI analyzes topic boundaries and speech momentum to dynamically decide where each clip starts and ends. - `15s`, `30s`, `60s`, `90s`, `120s`, `150s`: Enforces strict duration targets. 2. **`Smart Max Duration Cap Slider` (When Smart is Selected)**: Caps the maximum length of an auto-detected clip (30s, 60s, 90s, 120s, or 150s). 3. **`Clip Count Slider` (Range: 0 to 15)**: - Setting to `0` (default) allows Gemini AI to extract only genuinely high-retention moments without padding. - Setting to a specific number (e.g. `5`) instructs the engine to extract exactly that number of top-scoring clips. 4. **`Speech Recognition Language` (Select Dropdown)**: Select your video's audio language or leave on `Auto-Detect`. 5. **Feature Switches**: - `Dynamic Speaker Tracking`: Uses face detection to keep the active speaker centered in the 9:16 frame. - `Kinetic Subtitles`: Generates word-level animated captions. - `Contextual Emojis`: Injects relevant animated emojis into captions. - `Keyword Highlighting`: Colorizes punchy keywords. 6. **`Export Quality Preset` (Segmented Button)**: - `Social`: Optimal bitrate and size for social platforms. - `High`: Maximum master bitrate for archiving. - `Fast`: High-speed encoding for rapid drafting. --- ### 3.4 Subtitle Styler Sidebar Switching to the **Subtitle Styler** tab in the sidebar reveals a live interactive preview of your selected caption theme. You can switch presets (MrBeast, Hormozi, Neon, Minimalist, Karaoke) and preview how words will pop and bounce before triggering generation. --- ### 3.5 Project History & Session Resumption Clicking the **`Project History`** drawer at the bottom shows all past projects stored in your local project database: - Shows project title, original source file, clip count, and timestamp. - **`Open Project` (Button)**: Instantly re-opens a project with all cached transcripts and clips intact. - **`Delete Project` (Trash Icon Button)**: Removes the project entry and frees up storage. - **`Clear History` (Text Button)**: Purges all project history entries. --- ### 3.6 Triggering Generation Once configured, click the prominent **`Generate Viral Reels`** button (Cyan Elevated Button with Sparkles Icon). ScrollClip transitions immediately into the automated 5-stage processing pipeline. --- ## Chapter 4: The 5-Stage Automated Processing Pipeline The **Generate Step** (`GenerateStep.tsx`) executes the multi-stage AI pipeline locally on your machine. Progress is visualized through a comprehensive stage tracker: ``` [ Stage 1: Ingestion ] ──▶ [ Stage 2: Audio ] ──▶ [ Stage 3: Speech ] ──▶ [ Stage 4: Gemini AI ] ──▶ [ Stage 5: Render ] ``` ### 4.1 Stage 1: Media Ingestion & Asset Caching (`downloading`) - If a web URL was provided, the universal ingestion engine downloads the highest-quality video stream and caches it locally. - If a local file was provided, the core media engine validates file integrity and generates working proxies if necessary. ### 4.2 Stage 2: Audio Demuxing & Loudness Leveling (`extracting`) - Demuxes the primary audio stream into a pristine, uncompressed 16kHz mono WAV file. - Applies standard **EBU R128 loudness normalization**, eliminating volume spikes and ensuring crystal-clear speech recognition. ### 4.3 Stage 3: Neural Speech-to-Text Transcription (`transcribing`) - Feeds normalized audio into the **ScrollClip Neural Speech Recognition Engine**. - Generates **millisecond-accurate word-level timestamps** for every uttered word. - Analyzes phonetic inflection to classify emotional speech moments (Excitement, Tension, Humor, Surprise, Authority). ### 4.4 Stage 4: Gemini AI Viral Intelligence & Hook Analysis (`highlighting`) - Transmits timestamped transcript segments to **Google Gemini AI**. - Performs 3-step intelligence analysis: 1. **Hook Identification**: Isolates the critical first 3 seconds that grab viewer attention. 2. **Virality Scoring**: Rates each segment from 0% to 100% based on retention probability, curiosity loops, and narrative completeness. 3. **Social Metadata Generation**: Generates viral video titles, engaging social captions, and high-ranking hashtags. ### 4.5 Stage 5: Dynamic 9:16 Speaker Tracking & Preview Rendering (`rendering`) - Activates the **ScrollClip Precision Face Tracking & Speaker Vision Engine**. - Tracks human faces across every video frame, smoothly shifting the 9:16 crop window to follow the active speaker. - Burns kinetic animated subtitles, emojis, and styling into preliminary MP4 preview clips. ### 4.6 Console Diagnostics & Pipeline Controls - **Progress Bar**: Displays total elapsed percentage and current stage progress. - **Terminal Logs Drawer**: An expandable drawer displaying real-time standard output and console diagnostics from the pipeline. - **`Cancel Generation` (Tonal Red Button)**: Safely terminates all active background threads and returns to the Input step. - **`Retry Pipeline` (Button)**: Appears if a network error or missing API key interrupts processing. --- ## Chapter 5: Review & Multi-Clip Selection Upon pipeline completion, the **Review Step** (`ReviewStep.tsx`) presents all generated viral clips ranked by virality potential. ``` ┌───────────────────────────────────────────────────────────────────────────────┐ │ GENERATED 4 VIRAL CLIPS (RANKED) │ ├───────────────────────────────────────────────────────────────────────────────┤ │ ┌─────────────────────┐ ┌──────────────────────────────────────────────────┐ │ │ │ │ │ [ 94% VIRALITY SCORE ] Clip #1 • 00:42 │ │ │ │ 9:16 VIDEO │ │ Hook: "The one secret to scaling your brand..." │ │ │ │ PREVIEW │ │ Reason: Immediate curiosity loop with high │ │ │ │ [▶ PLAY / PAUSE] │ │ emotional payoff at 00:28. │ │ │ │ [⛶ FULLSCREEN] │ │ Emotion: 🔥 High Excitement │ │ │ │ │ │ Title: Stop Doing Content Wrong in 2026 │ │ │ └─────────────────────┘ │ │ │ │ │ [ ✏️ EDIT REEL IN STUDIO ] [ 📁 REVEAL IN FINDER ] │ │ │ └──────────────────────────────────────────────────┘ │ └───────────────────────────────────────────────────────────────────────────────┘ ``` ### 5.1 Virality Score Ranking & Indicators Each clip is badged with an intelligent score calculated by Gemini AI: - **Green (80% – 100%)**: **Top Viral Potential**. High viewer retention hook with a strong emotional peak. - **Yellow (60% – 79%)**: **Strong Engagement**. Solid narrative structure suitable for educational or discussion reels. - **Red (< 60%)**: **Moderate Engagement**. Informative content that may require manual hook trimming in the editor. --- ### 5.2 Interactive Clip Previews & Fullscreen Player - **Play / Pause**: Click anywhere on a video card or click the play button to preview the rendered 9:16 vertical video with burned captions. - **Fullscreen Preview Modal**: Click the **Maximize Icon Button** to open a full-height cinematic preview modal. Press `Escape` on your keyboard to exit. --- ### 5.3 Viral Hook & Social Intelligence Inspector Below each video preview, the card displays: - **Hook Sentence**: The opening line that grabs viewer attention. - **AI Reasoning**: Why this clip was selected and where the emotional climax occurs. - **Emotional Tag**: Categorized badge (e.g., `⚡ Mindset Shift`, `🔥 High Energy`, `💡 Breakthrough Insight`). - **Social Media Pack**: Viral titles, ready-to-post captions, and optimized hashtag bundles. --- ### 5.4 Step Navigation & Hand-Off Actions - **`Edit Reel in Studio` (Primary Elevated Button with Pencil Icon)**: Launches the full **Editor Studio** with this clip loaded for word-level editing and restyling. - **`Reveal in Finder / Explorer` (Folder Icon Button)**: Opens your operating system file manager directly to the exported video file. - **`Back to Input` (Outline Button)**: Returns to the Input step to process another video. --- ## Chapter 6: The Full Editor Studio The **Editor Studio** (`EditorStudio.tsx`) is the heart of ScrollClip. It gives you complete creative control over captions, speaker framing, typography, and export queues. ``` ┌───────────────┬───────────────────────────────────────────┬───────────────────────────┐ │ CLIP QUEUE │ CENTER CANVAS │ INSPECTOR PANEL │ │ ├───────────────────────────────────────────┤ │ │ [Clip #1 94%] │ [← Back] Project Title [WYSIWYG|Render] │ [ Subtitles ] [ AI Config]│ │ [Clip #2 88%] │ │ │ │ [Clip #3 76%] │ ┌───────────────────┐ │ Style Presets: │ │ │ │ │ │ [MrBeast] [Hormozi] [Neon]│ │ │ │ 9:16 VERTICAL │ │ │ │ │ │ CANVAS │ │ Typography: │ │ │ │ │ │ Font: Inter Black │ │ │ │ [KINETIC CAPTION]│ │ Size: [====o=====] 48px │ │ │ │ │ │ Highlight: [ #69C9D0 ] │ │ │ └───────────────────┘ │ │ │ │ [▶] 00:14 / 00:42 [=========] │ Viral Intelligence: │ │ ├───────────────────────────────────────────┤ • Viral Hook Score: 94% │ │ │ TRANSCRIPT TIMELINE (WORD-BY-WORD) │ • [Copy Post Caption] │ │ │ [The] [one] [secret] [to] [scaling]... │ • [Copy Hashtag Bundle] │ │ └───────────────────────────────────────────┴───────────────────────────┘ ``` ### 6.1 Studio Layout Overview The studio uses a professional **3-column responsive layout**: - **Left Column**: Clip Queue and switching. - **Center Column**: 9:16 Video Player Canvas, Scrubber Timeline, and Word-Level Transcript Editor. - **Right Column**: Subtitle Styler and Viral Social Intelligence Inspector. --- ### 6.2 Left Panel: Multi-Clip Queue & Selection - Displays thumbnail previews of all generated clips for the current project. - Click any clip card to switch the active video player and transcript instantly. - Displays virality badge, clip duration, and start/end timecodes. --- ### 6.3 Center Panel: Canvas, Scrubber & Mode Toggles #### Top Control Bar: - **`Back to Review` (Arrow Button)**: Returns to the multi-clip review step. - **`Preview Mode Toggle` (Segmented Button: `WYSIWYG` vs. `Rendered`)**: - **`WYSIWYG Mode` (What You See Is What You Get)**: Plays video with live vector subtitles overlaid in real-time. Any changes to fonts, colors, or wording update **instantly with zero rendering delay**. - **`Rendered Mode`**: Plays the pre-baked MP4 file directly from disk. - **`Rerender with New Styles` (Button with Refresh Icon)**: Re-burns the video with your updated styles in seconds. - **`Rerun Full Pipeline` (Button)**: Opens a modal allowing you to supply custom AI prompt instructions or adjust speaker tracking sensitivity. #### Video Player Canvas: - Displays your video in an exact **9:16 vertical ratio**. - **Play / Pause**: Click canvas or press `Spacebar`. - **Seekbar Scrubber**: Drag slider to seek to any frame. - **Timecode Display**: Shows current position and total clip duration (`00:14.250 / 00:42.800`). --- ### 6.4 Bottom Panel: Word-by-Word Interactive Transcript Editor The **Transcript Editor** gives you millisecond-level authority over your subtitles: - **Click to Seek**: Click any word chip in the transcript to jump the video player directly to that spoken word. - **Double-Click to Edit Text**: Double-click any word chip to fix spelling, capitalize names, or add punctuation. - **Timestamp Adjusters**: Fine-tune word start and end timestamps down to the millisecond. - **Split Caption Line (Enter Key)**: Press enter while editing a word to split the caption into a new visual line. - **Delete Word / Remove Filler (Backspace / Delete Key)**: Remove filler words ("um", "uh", "you know") from the caption track without cutting video audio. --- ### 6.5 Right Panel: Subtitle Styler & AI Intelligence Card #### Tab 1: Subtitle Styler Panel - **Style Presets**: Apply pre-configured viral styles with 1 click: - `MrBeast`: Bold yellow-and-white uppercase kinetic captions. - `Hormozi`: Dynamic green-accented captions with active word bounce. - `Neon`: Glowing cyber cyan & magenta text. - `Minimalist`: Clean modern sans-serif with subtle background boxes. - `Karaoke`: Smooth left-to-right color wipe across active words. - **Typography Controls**: - `Font Family`: Choose from bundled modern fonts. - `Font Size Slider`: Fine-tune text size. - `Text Transform`: Force UPPERCASE or lowercase styling. - **Color Customization**: - `Text Color`: Default word color. - `Highlight Color`: Active spoken word color. - `Stroke Color & Width`: Outer border contrast. - `Drop Shadow`: Shadow distance, blur, and opacity. - **Positioning & Motion**: - `Vertical Alignment`: Top, Center, Bottom. - `Y-Offset Slider`: Pixel-accurate vertical nudge. - `Animation Effect`: Word Pop, Bouncing Spring, Karaoke Wipe, or Soft Fade. #### Tab 2: Viral Intelligence Card - **Virality Score Meter**: Real-time gauge of audience retention probability. - **Hook Breakdown**: Detailed critique of the opening hook. - **Suggested Viral Titles**: 3 high-converting title options with **1-Click Copy Buttons**. - **Social Caption Generator**: Pre-written post caption tailored for TikTok, Instagram Reels, and YouTube Shorts. - **Hashtag Bundle**: Curated high-volume hashtags ready for 1-click clipboard copy. --- ### 6.6 Fast Style Re-render vs. Deep Pipeline Re-run - **Fast Style Re-render (`Rerender with New Styles`)**: - Uses cached audio stems, face tracking data, and transcript timings. - Only re-burns the visual subtitle overlay. - **Takes only 3 to 10 seconds** on modern hardware! - **Deep Pipeline Re-run (`Rerun Full Pipeline`)**: - Re-executes the speech recognition and Gemini AI analysis with custom prompt instructions. - Used when you want to discover entirely different moments in the long-form video. --- ### 6.7 Single Clip & Batch Export Queue 1. **`Export Current Reel` (Primary Button)**: - Renders the active clip to your configured export folder in full 1080x1920 FHD. 2. **`Batch Export Queue` (Button & Modal)**: - Checkmark multiple clips (or select "Export All"). - ScrollClip processes the export queue in the background using hardware GPU acceleration. 3. **`Export Success Modal`**: - Confirms render completion. - Shows file path and size. - Provides 1-click shortcuts: **"Open Video"** and **"Reveal in Finder / Explorer"**. --- ## Chapter 7: Troubleshooting, Support & Pro Tips ### 7.1 GPU Acceleration & Hardware Diagnostics - **Windows NVIDIA Systems**: Ensure you have installed the latest NVIDIA GeForce Game Ready or Studio Driver. The app will automatically leverage your NVENC hardware encoder. - **Windows AMD Systems**: Confirm AMD Adrenalin software is up to date to enable AMD AMF GPU encoding. - **Apple Silicon Macs (M1/M2/M3/M4)**: Hardware acceleration operates out of the box via native Metal pipelines with zero driver installation required. --- ### 7.2 Handling Protected or Geo-Restricted Videos If a YouTube video fails to ingest due to age-verification or private channel restrictions: 1. Open **Settings → Processing & AI → YouTube Cookies Section**. 2. Export your browser session cookies file using any standard browser extension. 3. Click **"Import Cookies File"** in ScrollClip. 4. Retry the video URL — ScrollClip will authenticate seamlessly. --- ### 7.3 Official Customer Support Channels If you encounter activation issues, hardware questions, or need guidance: - **Option 1: Customer Portal Support Desk (Recommended)** Log in to your Customer Portal at **[https://getscrollclip.com/dashboard](https://getscrollclip.com/dashboard)**: - Submit direct support tickets to technical specialists. - Track ticket status, view staff responses, and upload diagnostic log files. - Manage your registered machines and deactivate seats for hardware migration. - **Option 2: Direct Email Assistance** Email our dedicated customer assistance desk directly at: **`assist@getscrollclip.com`** *(Include your license key and checkout email for priority routing).* --- *© ScrollClip. All rights reserved. Built for creators, agencies, and viral video editors worldwide.*