๐ Overview
KLYPTON is a powerful Windows application for creating viral-optimized video clips from long-form YouTube content. It combines advanced scene analysis algorithms, AI-powered content understanding, and an intuitive clip editing interface to help you extract the most engaging moments from any video.
Key Capabilities
- ๐ฌ Process up to 100 YouTube videos in a single batch
- ๐ Scene Analysis System: 15+ data sources including motion, audio, speech rate, face detection, AI sentiment, and YouTube's Most Replayed heatmap
- ๐ฅ Viral Score Algorithm: Hook + Sustain + Synchrony formula for detecting shareability
- ๐ฏ Category Profiles: 15 pre-tuned detection profiles matching YouTube categories, plus custom profile creation
- โจ AI-powered clip selection, titles, summaries, and transcript enhancement using OpenAI
- ๐ Keyword-based clip extraction from subtitles
- โ๏ธ Interactive Clip Editor with synchronized video, transcript, and analysis chart
- ๐ Transcript editing tools with AI-fix for capitalization/punctuation
- ๐จ Video and audio enhancements (speed, color, EQ, noise reduction)
- ๐ง Custom watermarks and burn-in subtitles
- ๐ VPN integration
- ๐ Clip Regression Analysis for reverse-engineering optimal detection settings
๐ Getting Started
Quick Start Guide
- 1Get URLs: Either manually enter YouTube URLs or use the Fetch feature to search for videos
- 2Choose Clip Method: Select "Interactive Clip Editor" for full scene analysis, or other methods (AI-Automatic, AI-Keywords, Subtitle Keywords)
- 3Enable Scene Analysis: Check "Scene/viral analysis" for the powerful analysis chart (recommended)
- 4Configure Settings: Set keywords (if needed), video quality, and other options
- 5Click GO: Start processing your videos
- 6Create Clips: In the Interactive Clip Editor, use the Scene Analysis controls or manually select clips
- 7Continue: Click Continue to render and save your clips
๐ก Tip: Start with a single video to familiarize yourself with the Scene Analysis chart and controls before running batch jobs.
Recommended Workflow for Viral Clips
- 1Enable Scene/viral analysis checkbox before processing
- 2In the Interactive Clip Editor, select the appropriate Category Profile for your content type
- 3Adjust CLIP ENERGY sliders to weight the signals that matter most for your content
- 4Set # of clips, Length, and Min sep
- 5Click UPDATE to auto-generate clips based on the analysis
- 6Fine-tune clip boundaries manually if needed
- 7Optionally run Analyze Clips to get insights and save as a custom profile
Application Status Indicators
The app uses various emojis and indicators to communicate status:
- โ Ready - Application is ready for new jobs
- ๐ Starting job - Processing has begun
- โฌ๏ธ Downloading - Fetching video and transcript
- ๐ Analyzing - Running scene/viral analysis scan
- โ๏ธ Creating clips - Segmenting video
- ๐ฌ Video ready - Processing complete
- โ ๏ธ Warning - Non-critical issue
- โ Error - Critical issue
๐ Outputs & Files
KLYPTON saves all output locally on your machine. The main output location is the projects/ folder (one subfolder per video/job).
- ๐ icon: Click the folder icon to open the
projects/folder.
What Youโll See in a Project Folder
Exact filenames vary depending on which tasks you enabled, but common outputs include:
- Video assets: downloaded full video plus created clips and/or a summary video.
- Metadata:
container_metadata.jsonand other job summary/metadata files. - Transcripts/subtitles:
_user-fixedfiles are created when you make manual transcript edits._ai-fixedfiles are created when you run โจ AI Transcript Fix (typically also creating.txtand.srtversions).
- Scene analysis export:
scene_detection_chart_data.csv(if you save chart data).
Custom Viral Profiles Output
Custom viral profiles and clip regression data are stored in custom-viral-profiles/:
cvp_*.json(profile definitions)cvp_*_clip_data.csv(regression scan data)
โ๏ธ Settings Reference
This section mirrors the in-app ? help text from the main โTasks / Settingsโ panel in the app (the goal is to match what you see there, not to teach prompt engineering or advanced tuning).
Clip Creation
Clip Creation Method
Interactive Clip Editor
Select your exact clip start and end points within the video timeline or transcript. Optionally use Scene/viral analysis to find potentially viral clips.
Edit and clean up the transcript โ manually or use โจAI auto-fix โ save SRT sub file.
โจAI - Automatic
Uses OpenAI to summarize the entire video and determine the most meaningful clips. Requires an API key.
โจAI - Keywords
Uses OpenAI to determine clips from meaningful content around your keywords. Requires an API key.
Subtitle Keywords
Creates clips wherever your keywords are found in the video's subtitle file.
No clips needed
Select this if you don't need to have clips made but have other tasks to do (e.g. watermark, audio files, etc).
Default: Interactive Clip Editor w/ Scene analysis
Scene/viral analysis
Scans video for motion variances, audio variances and other dimensions, and builds a Scene Analysis chart plotting these data.
Use Scene Analysis to highlight clips with the highest viral potential according to preset algorithms per video category, or build your own trainable detection formula.
Set Data interval based on video length and PC's abilities โ 0.25s for most detail (recommended). 'Auto' = 0.25 videos <60 min, 0.50 <180 min, 1.00 >180.
Default: Scene analysis ON, Data interval 0.25
Clip Settings
Clip Min -s
Minimum number of seconds for a clip (7-600). Clips will be created that are this long or longer.
Default: 10 (min=7, max=600)
Default: 10 (min=7, max=600)
Clip Max -s
Maximum number of seconds for a clip (12-600). Clips will be created that are this short or shorter.
Default: 60 (min=12, max=600)
Default: 60 (min=12, max=600)
Min Sep -s
Enforce minimum distance between clips. This will remove clips that are too close together (0-600 seconds).
Example with Min Sep set to 30 seconds:
โข Clip A ends at 1:30
โข Clip B starts at 1:45 โ DISCARDED (too close)
โข Clip C starts at 2:30 (60s gap from A) โ KEPT
Min Sep vs Max Gap:
โข Min Sep (runs first) โ REMOVES clips that are too close
โข Max Gap (runs second) โ MERGES clips that are too close
Set to 0 to disable (recommended for most use cases).
Default: 0 (min=0, max=600)
Example with Min Sep set to 30 seconds:
โข Clip A ends at 1:30
โข Clip B starts at 1:45 โ DISCARDED (too close)
โข Clip C starts at 2:30 (60s gap from A) โ KEPT
Min Sep vs Max Gap:
โข Min Sep (runs first) โ REMOVES clips that are too close
โข Max Gap (runs second) โ MERGES clips that are too close
Set to 0 to disable (recommended for most use cases).
Default: 0 (min=0, max=600)
Max Gap -s
Merges clips you think are too close together (0-60 seconds).
โข Lower value = More but shorter separate clips
โข Higher value = Fewer but longer merged clips
Min Sep vs Max Gap:
โข Min Sep (runs first) โ REMOVES clips that are too close
โข Max Gap (runs second) โ MERGES clips that are too close
Set to 0 to disable merging.
Default: 5 (min=0, max=60)
โข Lower value = More but shorter separate clips
โข Higher value = Fewer but longer merged clips
Min Sep vs Max Gap:
โข Min Sep (runs first) โ REMOVES clips that are too close
โข Max Gap (runs second) โ MERGES clips that are too close
Set to 0 to disable merging.
Default: 5 (min=0, max=60)
Final Max -s
Max allowed length for created summary video.
Must be >= Max Seconds.
If created summary video is longer than this, clips will be trimmed down bit by bit until they meet this target:
1) Trimmed a little on both sides of the keyword(s).
2) If still needed, clips less than 10s will be cut.
3) If still needed, lowest-keyword-dense clips will be cut.
Default: 300 (min=clip max, max=1200)
Must be >= Max Seconds.
If created summary video is longer than this, clips will be trimmed down bit by bit until they meet this target:
1) Trimmed a little on both sides of the keyword(s).
2) If still needed, clips less than 10s will be cut.
3) If still needed, lowest-keyword-dense clips will be cut.
Default: 300 (min=clip max, max=1200)
Max # Clips
For clip detection based on keywords โ Subtitle Keywords and โจAI-Keywords โ this sets a maximum clip limit.
Default: Auto
Fade In/Out -s
Duration (in seconds) of the fade-in / fade-out effect.
Value applied to intro and outro of final video.
Half of value applied to middle clips to acheive same effect.
Default: 1 (min=0, max=3)
Value applied to intro and outro of final video.
Half of value applied to middle clips to acheive same effect.
Default: 1 (min=0, max=3)
Clip Ordering
Combine clips into single summary video in this order.
Default: Normal
Default: Normal
Basic Extraction
Download video assets
Extract and download the video, transcript, and video metadata to the project folder.
Note: Certain tasks already will download the video, transcript, and metadata file automatically, but check this if you're running simple tasks that don't require all these files but you want them anyway.
โจ AI Summary Creation
Enable AI Summary + Word Count
Check to enable AI Summary creation and set word count target.
Default word count: 50 (min=25, max=500)
Default word count: 50 (min=25, max=500)
Always create AI summary
Create an AI summary even for jobs where no keyword matches are found.
Default: unchecked
Default: unchecked
โจ AI Title Creation
Enable AI Title + Max Characters
Check to enable AI Title creation and set max character count.
Default character count: 75 (min=20, max=200)
Default character count: 75 (min=20, max=200)
Always create AI title
Create an AI title even for jobs where no keyword matches are found.
Default: unchecked
Default: unchecked
Video
Video quality
Preferred video download quality.
Default: 480p (SD)
Default: 480p (SD)
Adjust / fix video
Adjusts video output in created video files (clips, summary video, full video).
Default: unchecked
Default: unchecked
Audio
Create audio files (eg mp3)
Check to create audio files (mp3, wav, etc) of your clips and summary video.
Default: unchecked
Default: unchecked
Adjust / fix audio
Adjusts audio output in created video files and audio-only files.
Default: unchecked
Default: unchecked
Text / Watermark
Add text or watermark
Add a text or image watermark to your clips, summary video, and full video.
Default: unchecked
Default: unchecked
Subtitles
โจ AI-fix transcript
Uses OpenAI to add proper capitalization and punctuation to auto-generated YouTube captions.
Creates
Default: unchecked
Creates
_ai-fixed files (and associated .txt/.srt exports).Default: unchecked
Highlight keywords
Highlight keywords in the
Default: unchecked
.txt transcript files created for clips, summary video, and full video.Default: unchecked
Create extra subtitle files
Choose additional subtitle formats (e.g., SRT, VTT).
Default: unchecked
Default: unchecked
Burn-in subtitles
Add burned-in subtitles to your clips, summary video, and/or full video.
Default: unchecked
Default: unchecked
Region & Access
Use browser cookies
Use browser cookies when fetching YouTube content. Helpful if you see sign-in / bot-check errors.
Default: unchecked
Default: unchecked
Use VPN / IP rotation
Use integrated VPN to rotate IP between jobs to reduce throttling/blocks.
Default: unchecked
Default: unchecked
Misc
Transcript min word
Minimum spoken-word threshold for transcript-dependent tasks.
0 = disabled
Default: 100
0 = disabled
Default: 100
Use existing assets
Reuse previously downloaded assets for the same video URL to save time/bandwidth.
Default: checked
Default: checked
Avoid fetching table URLs
Avoid URLs that already exist in the Completed Videos table (in addition to other dedupe checks).
Default: checked
Default: checked
๐ URL Management
Fetching URLs
KLYPTON offers three methods to gather YouTube URLs:
1. Keyword Search
Search YouTube for videos matching your topic:
- Enter search terms in the search field
- Set the number of URLs to fetch (1-100)
- Apply optional filters:
- Upload Date: Last hour, today, week, month, or year
- Duration: Under 4 min, 4-20 min, or over 20 min
- Sort By: Relevance, date, view count, or rating
- Click Fetch to retrieve URLs
2. Playlist Import
Import all videos from a YouTube playlist:
- Paste a YouTube playlist URL
- Click Fetch to retrieve all video URLs
- View playlist metadata including title, creator, and video count
3. Channel Import
Import recent videos from a YouTube channel:
- Paste a YouTube channel URL
- Click Fetch to retrieve video URLs
- View channel metadata including subscriber count and total views
๐๏ธ Preview Mode
Preview Mode provides a visual card-based interface for managing your URLs before processing:
- Click Preview Mode button to switch views
- View thumbnail, title, duration, and upload date for each video
- Sort videos by various criteria (views, duration, upload date, etc.)
- Select/deselect videos for batch operations
- Remove unwanted videos before processing
โ ๏ธ Note: Preview Mode requires fetching metadata from YouTube, which may take time for
large URL lists.
Bad URLs Collector
The Bad URLs feature helps you maintain a list of problematic videos to avoid in future searches:
- Automatically adds removed URLs when "add to Bad URLs" is checked
- Prevents these URLs from appearing in future fetch operations
- Accessible via the red button that appears when URLs are collected
- Can be cleared or edited at any time
โ๏ธ Clip Creation Methods
Interactive Clip Editor with Scene Analysis
The Interactive Clip Editor (ICE) is KLYPTON's most powerful featureโa comprehensive scene analysis workstation for creating viral-optimized clips. It combines video playback, synchronized transcript display, a multi-trace analysis chart, and sophisticated clip detection algorithms.
Core Capabilities
- Video Player: HTML5 player with frame-accurate playback controls, synchronized with transcript and chart
- Transcript View: Clickable word-level transcript for precise clip boundary selection
- Timeline Visualization: Visual clip representation with drag-and-drop reordering
- Scene Analysis Chart: Interactive Plotly chart with 15+ data sources for viral potential analysis
- Auto-Clip Generation: Algorithm-driven clip detection based on customizable energy formulas
Creating Clips Manually
- Transcript Selection: Click words to set start (green) and end (red) points, then add to clip list
- Timeline C-key: Click on timeline position and press C to set start, then again for end
- Clip Boundary Editing: Double-click existing clips to fine-tune boundaries using โผ markers
Auto-Generating Clips
- Select Scene Type: Viral (balanced), Motion (visual focus), or Audio (sound focus)
- Set Number of Clips, Length, and Minimum Separation
- Adjust Energy Input sliders to weight different signals
- Click UPDATE to populate clips based on analysis
๐ก Pro Tip: Enable "Scene/viral analysis" checkbox before starting to pre-scan the video for motion and audio data that powers the analysis chart.
โจ AI-Automatic
Uses OpenAI to analyze the entire video transcript and automatically identify the most meaningful segments.
- No keywords required - AI determines important content
- Best for: Creating highlights without specific topics in mind
- Requires: OpenAI API key
- AI analyzes context, topic transitions, and information density
โจ AI-Keywords
Uses OpenAI to intelligently create clips around your specified keywords with context awareness.
- Keywords guide AI to relevant sections
- AI determines optimal clip boundaries around keywords
- Best for: Topic-specific summaries with intelligent context
- Requires: OpenAI API key and keywords
Subtitle Keywords
Creates clips based on exact keyword matches in the video's subtitle file.
- Faster processing - no AI required
- Predictable results based on keyword occurrences
- Best for: Quick extraction of specific topics
- Three matching modes:
- Exact: Perfect word match only
- Related: Beginning of word match
- Contains: Wildcard match anywhere in words
๐ก Tip: Use "None" as the clip creation method if you only want to download videos or
create audio files without making clips.
๐ Scene Analysis System
The Scene Analysis system is KLYPTON's advanced viral clip detection engine. It scans video and audio streams to build multi-dimensional data that powers intelligent clip selection.
Scene Analysis Chart
An interactive Plotly-based visualization showing all analysis traces over the video timeline:
- Zoom & Pan: Click-drag to zoom sections; Z to zoom in, X to unzoom, Shift+X to reset
- Legend Control: Click trace names to show/hide; double-click to isolate a single trace
- Playhead Sync: Chart follows video playback; click chart to seek video
- Hover Info: Detailed tooltips showing values at any point
- Visual Themes: Toggle thin/thick lines, light/dark backgrounds
- Clip Visualization: Color-coded bands show clip positions and scores
Energy Inputs (15 Sources)
The chart displays up to 15 data sources, each contributing to the overall CLIP ENERGY calculation:
Always Available (from original scan)
| Trace | Description |
|---|---|
| Frame Diff | Frame-to-frame visual change intensity. Low = static, High = motion/cuts |
| Frame Diff ฮ | Rate of change in frame diff. Detects sudden motion starts/stops |
| Audio LUFS | Perceived loudness (-70dB to 0dB). Industry-standard audio measurement |
| Audio LUFS ฮ | Sudden volume changesโyelling, impacts, dramatic moments |
| Audio Pitch | Fundamental frequency (85-400Hz for speech). Higher = excitement |
| Audio Centroid | Spectral brightnessโsharp/tinny vs deep/bassy sounds |
| Audio Flatness | Tonal vs noise-like. Low = clear speech/music, High = ambient noise |
Optional Scans (on-demand)
| Trace | Description | Trigger |
|---|---|---|
| Object Motion | Subject movement isolated from camera motion | Optical Flow scan |
| Center Motion | Movement in frame center where subjects appear | Optical Flow scan |
| Global Motion | Camera movement (pan, tilt, zoom, shake) | Optical Flow scan |
| Face Prominence | Largest face size relative to frame (0-1) | Face scan |
| Speech Rate | Words per minute from transcript (100-200 normal) | Transcript required |
| Keywords | Your search terms appearing in transcript | Keywords + transcript |
| AI Sentiment | GPT-analyzed viral potential per segment | AI Sentiment scan |
| YT Most Replayed | Official YouTube heatmap data showing replay hotspots | Available from YT metadata |
Derived Signals (computed from above)
| CLIP ENERGY | Weighted combination of all enabled inputsโthe primary viral detection signal |
| SYNCHRONY | How much signals rise/fall together. High = coordinated real events, Low = random noise |
| Cuts | Detected scene transitions and hard cuts (visual โ markers) |
Viral Score Algorithm
The ViralScore formula determines clip ranking using three components:
ViralScore = (HOOK ร weight) + (SUSTAIN ร weight) + (SYNCHRONY ร weight)
- HOOK: Attention-grabbing opening. Measures energy rise/fall in the first portion of the clip (configurable % and max seconds)
- SUSTAIN: Engagement-keeping body. Measures consistent energy after the hook with peak bonuses
- SYNCHRONY: Cross-modal coherence. Higher when audio and visual signals align (real events vs artifacts)
Hook Pattern Options
- Maximum: Highest average energy in hook window
- Minimum: Lowest average energy (for calm intros)
- Max Rise: Biggest energy increase (building momentum)
- Max Drop: Biggest energy decrease (after peak)
- Max Diff: Highest rise OR drop (maximum contrast)
Category Profiles
Different content types require different detection strategies. KLYPTON includes 15 pre-tuned profiles matching YouTube's official categories:
| Category | Focus | Key Signals |
|---|---|---|
| ๐ฌ Film & Animation | Cinematic reveals, emotional beats | Motion, AI Sentiment, YT Replayed |
| ๐ Autos & Vehicles | Speed, engine sounds, action | Object Motion, LUFS Delta, Pitch |
| ๐ต Music | Drops, choruses, beat alignment | LUFS, LUFS Delta, Pitch, Centroid |
| ๐พ Pets & Animals | Reactions, cute/chaotic moments | Object Motion, LUFS Delta, short hooks |
| โฝ Sports | Fast motion, impacts, crowd bursts | Motion, LUFS Delta, high sustain |
| โ๏ธ Travel & Events | Scenic reveals, crowd moments | Global Motion, Sentiment, Face |
| ๐ฎ Gaming | Clutch plays, reactions | Motion, LUFS, Speech Rate, Face |
| ๐ฅ People & Blogs | Talking head, emotional moments | Face Prominence, Speech Rate, Sentiment |
| ๐ Comedy | Punchlines, reaction timing | Speech Rate, LUFS spikes, short hooks |
| ๐ญ Entertainment | Broad appeal, variety | Balanced all signals |
| ๐ฐ News & Politics | Key statements, breaking moments | Speech Rate, Keywords, Sentiment |
| ๐จ Howto & Style | Demonstrations, reveals | Speech + Visual balance |
| ๐ Education | Key explanations, structured | Speech Rate, Keywords dominant |
| ๐ฌ Science & Tech | Demos, explanations | Speech, structured content |
| ๐ Nonprofits | Emotional appeals | Sentiment, Speech, Face |
Custom Viral Profiles
Create and save your own detection profiles tuned to specific content types:
- Click Create Custom Viral Profile button
- Enter a descriptive name (e.g., "tech_reviews_fast_paced")
- Add 3 relevant hashtags for categorization
- Optionally add a description
- Adjust all sliders and formula weights to your preferences
- Click Save Profile
Custom profiles are saved as JSON files in the custom-viral-profiles/ folder and appear in the profile dropdown.
๐ก Tip: Use the Analyze Clips feature to reverse-engineer optimal settings from your manually curated clips.
Cut Detection
KLYPTON detects scene cuts and transitions to improve clip quality:
- Cut Threshold (%): Sensitivity for detecting cuts. Lower = more cuts detected (soft transitions). Higher = only major scene changes
- Cut Impact (%): How much cuts affect CLIP ENERGY. 0% = ignore transition energy, 100% = full contribution
- Cuts OK in Hook: Whether to allow scene transitions in the opening hook section. Unchecked favors natural energy builds
Detected cuts appear as โ markers on the chart and can be used to avoid clips that start/end mid-transition.
Clip Regression Analysis
After manually curating clips, use Analyze Clips to reverse-engineer optimal settings:
- Computes per-clip metrics: hook deviation, slope, variability, peak location
- Compares your clips against full video baseline
- Provides insights into what makes your selected clips special
- Exports detailed CSV data for further analysis
- Helps fine-tune custom viral profiles based on your editorial choices
Results appear in the expandable Clip Analysis panel below the chart controls.
๐ Transcript Tools
KLYPTON includes powerful tools for viewing, editing, and enhancing video transcripts.
Transcript Edit Mode
Directly edit transcript words within the Interactive Clip Editor:
- Press Ctrl+E to toggle edit mode (or click the edit icon)
- Click any word to edit its text
- Delete words that are incorrect or unwanted
- Changes are saved to a
_user-fixedversion of the transcript - Original timing data is preserved
- Press Ctrl+E again to exit edit mode
โ ๏ธ Note: Running AI-fix will overwrite user edits. We recommend running AI-fix first, then making manual corrections.
โจ AI Transcript Fix
Uses OpenAI to add proper capitalization and punctuation to auto-generated YouTube captions:
- Improves readability of raw auto-captions
- Preserves word-level timing data
- Creates
_ai-fixedversion of transcript - Automatically generates .txt and .srt versions
- Essential for burn-in subtitles and professional output
Usage: Check the โจAI-fix checkbox in the transcript header and click to process.
๐ก Cost Tip: GPT-4o produces ~99% accuracy but costs more. GPT-4o-mini is cheaper but may struggle with longer transcripts. For a 10-minute video, expect ~$0.15 with GPT-4o.
Make SRT
Export the current transcript as an SRT subtitle file:
- Click Make SRT button in transcript header
- Creates properly formatted .srt file in project folder
- Uses the best available transcript version (AI-fixed > user-fixed > original)
- Perfect for uploading back to YouTube or other platforms
โ๏ธ Clip Settings
Timing Controls
| Setting | Default | Range | Description |
|---|---|---|---|
| Clip Min | 10s | 7-600s | Minimum duration for any clip. Shorter segments will be extended or discarded. |
| Clip Max | 60s | 12-600s | Maximum duration for any clip. Longer segments will be trimmed. |
| Min Sep | 0s | 0-600s | Minimum separation between clips. Removes clips too close together. |
| Max Gap | 5s | 0-60s | Maximum gap to merge clips. Combines clips within this distance. |
| Final Max | 300s | up to 1200s | Maximum total duration of final summary video. |
โ ๏ธ Processing Order:
- Min Sep runs first - removes clips that are too close
- Max Gap runs second - merges remaining clips that are close enough
- Final Max trims total duration if needed
Fade Effects
Control smooth transitions between clips:
- Fade In/Out: Applied to first and last clips (default: 1 second)
- Middle clips automatically use half the fade duration for smooth transitions
- Set to 0 to disable fade effects
Clip Ordering
Choose how clips are arranged in the final video:
- Normal: Chronological order as they appear in the original
- Reverse: Last clips first
- Random: Randomized order
โจ AI Features
OpenAI Setup
- Click the โจAPI button in the header or settings panel
- Enter your OpenAI API key
- Select model (GPT-4o-mini recommended, GPT-4o, etc.)
- Adjust temperature (0 = focused, 1 = creative)
- Choose tone for summaries and titles
๐ API Key Required: You need an OpenAI API key to use AI features. Get one at platform.openai.com
AI & Privacy
Your OpenAI API key is stored locally on your machine (in your appโs local configuration) and is used only when you enable AI features.
- If you donโt configure an API key (or disable AI options), KLYPTON wonโt call OpenAI.
- When you use AI features, KLYPTON sends the minimum required text context to OpenAI (typically transcript text) to produce the requested output.
- This guide intentionally does not cover prompt (re)engineering details.
AI Title Generation
Generate engaging, SEO-friendly titles based on video content:
- Maximum character length: 20-200 (default: 75)
- Can include first keyword for SEO
- Multiple tone options: journalistic, casual, click-baity, etc.
- Regenerate titles anytime with ๐ button in completed videos table
AI Summary Generation
Create concise text summaries of video content:
- Word count: 25-500 words (default: 50)
- Customizable tone and format
- Option to always generate even without keyword matches
- Available tones include:
- Journalistic, Formal, Casual
- Technical, Actionable, Key Takeaways
- ELI5 (Explain Like I'm 5)
- SEO-optimized for keywords
AI Sentiment Analysis
Uses GPT to analyze transcript segments for viral potential:
- Evaluates emotional hooks, surprise, controversy, humor
- Scores each segment 0-1 for shareability
- Appears as "AI Sentiment" trace on the Scene Analysis chart
- Can be weighted in the CLIP ENERGY calculation
- Triggered on-demand within the Interactive Clip Editor
When to use: For content where emotional/narrative peaks matter more than visual motion (vlogs, commentary, interviews).
๐ฌ Video & Audio Processing
Video Quality Settings
| Quality Option | Resolution | Best For |
|---|---|---|
| Highest Available | Up to 4K | Maximum quality, larger files |
| 1080p (Full HD) | 1920x1080 | High quality, reasonable size |
| 720p (HD) | 1280x720 | Good quality, smaller files |
| 480p (SD) | 854x480 | Default - balanced quality/speed |
| Smallest Available | Varies | Fastest processing, minimal storage |
Video Enhancements
Speed Adjustment
- Speed range: 0.25x to 4x
- Option to maintain pitch (prevents chipmunk effect)
- Useful for time-lapse or slow-motion effects
Color & Lighting
- Brightness: -0.5 to +0.5 adjustment
- Contrast: -2.0 to +2.0 adjustment
- Saturation: 0 to 3.0 (0 = grayscale)
Rotate & Flip
- Rotate: 90ยฐ, -90ยฐ, or 180ยฐ
- Flip: Horizontal or Vertical
- Useful for correcting orientation issues
Audio Enhancements
Audio Leveling
- Target Loudness: -24 to -14 LUFS
- Loudness Range: 1-20 LRA
- True Peak: -3 to 0 dB
- Normalizes audio for consistent volume
Noise Reduction
- Strength: 0-100
- Removes background noise, hiss, and hum
- Three presets: Low (hiss), Medium (hum), High (fan noise)
Equalizer
- 6-band EQ: 60Hz, 250Hz, 1kHz, 4kHz, 8kHz, 16kHz
- Presets: Podcast Clarity, Vocal Boost, Bass Boost, etc.
- Volume and balance controls
๐ต Audio Files: Check "Create audio files" to export MP3/WAV versions of your clips,
summary video, and full-length video.
๐ Subtitle Features
Export Formats
KLYPTON can export subtitles in multiple formats:
| Format | Extension | Best For |
|---|---|---|
| TXT | .txt | Plain text transcripts (always created) |
| SRT | .srt | Universal compatibility, most players |
| VTT | .vtt | Web video (YouTube, Vimeo), supports styling |
| ASS | .ass | Advanced styling, animations, custom fonts |
| TTML | .ttml | Streaming services (Netflix, Amazon) |
| CSV | .csv | Spreadsheets, data analysis |
๐ฅ Burn-in Subtitles
Permanently embed subtitles into the video:
- Font customization: Choose from curated fonts or system fonts
- Positioning: 9-point grid alignment
- Styling options:
- Font size: 10-80pt
- Colors and opacity
- Shadow and outline effects
- Box background option
- Special features:
- Bold keywords automatically
- Adjustable margins
- Preview before applying
Keyword Highlighting
Highlight keywords in transcript files:
- Keywords wrapped in triple backticks: ```keyword```
- Adds "_kwh" suffix to filenames
- Includes keyword density statistics:
- Individual keyword counts
- Density percentages
- Total keyword statistics
๐ง Watermarks
Add custom branding to your videos with text or image watermarks:
Text Watermarks
- Custom text with font selection
- Color picker with opacity control
- Optional outline for visibility
- Default: "KLYPTON" in red
Image Watermarks
- Support for PNG, JPEG, GIF formats
- Automatic transparency support
- Upload custom logos or graphics
Watermark Controls
- Positioning: 9-point grid alignment
- Scale: 5-50% of video size
- Opacity: 5-100% transparency
- Rotation: -90ยฐ to +90ยฐ
- Desaturation: 0-100% (for subtle branding)
- Tiling: Repeat watermark across video
๐ง Advanced Features
๐ VPN Integration
KLYPTON integrates with Private Internet Access (PIA) VPN for enhanced access:
Benefits
- Bypass geographic restrictions
- Avoid throttling and rate limiting
- Automatic IP rotation between jobs
- Access to region-locked content
IP Rotation Options
| Timing | Description |
|---|---|
| Automatic | Rotates when errors detected (429, 403, etc.) |
| Every batch | Once before processing multiple URLs |
| Every job | Before each individual video |
| Every operation | Before jobs, fetches, and previews |
โ ๏ธ Note: Requires PIA VPN subscription and client installed on your system.
๐ช Browser Cookies
Use browser cookies for enhanced YouTube access:
- Helps avoid rate limiting
- Access to age-restricted content
- Better video quality availability
- Setup: Export cookies from browser as
youtube-cookies.txt
Batch Processing
Process multiple videos efficiently:
- Up to 100 videos per batch
- Automatic error recovery
- Progress tracking for each job
- Option to check existing project folders
- ESC key to abort batch at any time
๐ก Performance Tip: Enable "Check project folders first" to reuse previously downloaded
assets and save bandwidth.
๐ Completed Videos Table
Track all processed videos with comprehensive details:
Table Information
- DateTime: When the job was processed
- Video URL: Original YouTube link (clickable)
- Length: Duration and word count
- Keywords: Keywords used and match counts
- Clip Method: How clips were created (Interactive, AI, Subtitle, etc.)
- Clips: Number of clips created
- Summary Video: Duration, word count, resolution
- Titles: Original and AI-generated
- Summary: AI-generated summary (expandable)
- Output Path: Project folder location (clickable to open)
- Result: Job status (๐ข Complete, ๐ก Partial, ๐ด Failed)
Table Actions
- Sort by Date: Toggle ascending/descending by job timestamp
- Sort by Result: Group by completion status (success/partial/failed)
- Export: Save table data as CSV file for external analysis
- Clear: Remove all entries (with confirmation)
- Regenerate AI (๐): Click to create new AI titles or summaries for any row
- Copy Cells: Click any cell content to copy to clipboard
- Expand Summary: Click ๐ป to show full AI summary, ๐บ to collapse
๐ก Tip: Table data persists across sessions. Use the Export feature to backup your processing history or import into spreadsheets for analysis.
โจ๏ธ Keyboard Shortcuts
Global Shortcuts
| Shortcut | Action |
|---|---|
| Ctrl + Shift + โ | Copy last URL to URL box |
| Ctrl + Shift + Enter | Clean and deduplicate URLs |
| Ctrl + Shift + A | Open OpenAI settings |
| Ctrl + Enter | Start processing (GO) |
| ESC | Close popup / Abort current batch |
| Shift + ESC | Maximize log window |
Interactive Clip Editor Shortcuts
| Shortcut | Action |
|---|---|
| Space | Play/Pause video |
| โ / โ | Seek 10 seconds (when Seek Lock enabled) |
| Shift + โ / โ | Seek 30 seconds |
| โ / โ | Seek 1 second (when Seek Lock enabled) |
| C | Set clip start/end point at timeline position |
| L | Toggle Scroll Lock (chart follows playhead) |
| S | Toggle Seek Lock (enable arrow key seeking) |
| Z | Zoom chart one level |
| X | Unzoom chart one level |
| Shift + X | Reset chart to full view |
| Ctrl + E | Toggle Transcript Edit Mode |
Chart Interactions
| Click + Drag | Zoom to selected region |
| Click legend item | Show/hide that trace |
| Double-click legend | Isolate trace (hide all others) |
| Double-click clip | Zoom chart to clip region |
| Click chart | Seek video to that position |
๐ Troubleshooting
Common Issues and Solutions
โ "No transcript found"
- Video may not have captions available
- Try enabling browser cookies
- Check if video is age-restricted
โ ๏ธ "HTTP Error 429" or "403"
- YouTube rate limiting detected
- Enable VPN with IP rotation
- Use browser cookies
- Reduce batch size
๐ซ "Too few spoken words"
- Video transcript below minimum threshold
- Lower "Transcript min word" setting
- Video may be music or non-speech content
โฑ๏ธ Processing takes too long
- Use lower video quality (480p recommended)
- Disable video/audio enhancements
- Process fewer videos at once
- Enable "Check project folders first"
- Use 0.50s or 1.00s data interval instead of 0.25s for very long videos
โจ AI features not working
- Verify OpenAI API key is valid
- Check API credit balance
- Try different AI model
- Review custom prompts for errors
๐ Scene Analysis chart not appearing
- Ensure "Scene/viral analysis" checkbox was enabled before starting
- Wait for analysis scan to complete (check log for progress)
- For very long videos, processing may take several minutes
๐ CLIP ENERGY sliders not adding to 100%
- Use arrow keys while focused on sliders for precise adjustment
- The total must equal 100% for the algorithm to work correctly
- Check the warning indicator at the top of the CLIP ENERGY section
๐ Optional scans (Face, Optical Flow, AI Sentiment) not running
- Click the โ arrow next to the trace label to trigger the scan
- Wait for the scan progress indicator to complete
- Some scans require significant processing time for long videos
๐ Transcript Edit changes not saving
- Ensure you're in Transcript Edit Mode (Ctrl+E to toggle)
- Click outside the edited word to confirm the change
- Check that the _user-fixed file was created in the project folder
๐ฅ Clips generated don't match expectations
- Try a different Category Profile matching your content type
- Adjust the Hook/Sustain/Synchrony formula weights
- Modify CLIP ENERGY slider weights to emphasize relevant signals
- Enable "Bind to word" or "Bind to sentence" for cleaner clip boundaries
- Use Analyze Clips to understand what signals your preferred clips share
๐ก Log Messages: The SSE log provides detailed information about each operation. Check
it for specific error messages and warnings. Look for spinners indicating ongoing processes.
KLYPTON - Advanced Video Analysis & Clip Creation Tool
For educational and fair use purposes only. Respect copyright and YouTube's Terms of Service.