Repository navigation
Releases
Chopify v1.4.0 - Studio, captions, and any-length sources
Chopify v1.4.0 is the biggest release so far: a complete local Studio, Caption Studio, resumable any-length sources, and fully local audio/visual clip discovery. No paid APIs, uploads, or watermarks.
Install in one command
Windows (PowerShell)
irm https://raw.githubusercontent.com/mehbul/chopify/main/install.ps1 | iexmacOS / Linux
curl -fsSL https://raw.githubusercontent.com/mehbul/chopify/main/install.sh | bashHighlights
- Local browser Studio for queueing, review, caption editing, previews, and exports.
- Caption Studio with 13 presets, full typography control, emphasis, emoji, and a source-synced preview.
- Any-length sources with resumable downloads, transcription, discovery, and section rendering.
- Fully local audio and visual evidence for podcasts, streams, silent gameplay, and action-only footage.
- Resumable projects, batch queue, semantic search, podcast split-screen, SRT editing, and brand presets.
- One-command installers, a contributor guide, issue templates, and a 1280x640 social preview.
Full changelog
Added
- Local browser dashboard with project review, progress, logs, previews, caption
editing, candidate selection and downloadable exports. - Caption Studio with 13 presets, full typography/layout controls, word motion,
highlighting, boxed backgrounds, and a source-synced overlay with 5-second
preview. - Automatic per-cue emphasis for numbers, money, ALL-CAPS and power words, plus
optional deterministic emoji, capped at two emphasis words and one emoji per cue. - Reusable caption presets through brand JSON; project caption overrides persist
inproject.jsonand layer over preset and brand values. - Shared caption CLI flags and
--caption-jsonforchopify.pyand
render_clips.py. - Optional
hiddenandemphasisflags on transcript words; both burnt captions
and SRT honor them. - Direct local video input (MP4, MOV, MKV, WebM, M4V, AVI).
- Resumable projects with stage invalidation, per-clip checkpoints, and distinct
output names for render variants; partial failures retain successful clips. - Automatic long-source path: sources of 2 hours or more, 8 GB estimated download,
or unknown duration use an audio-first probe and resumable ingest. Short
sources keep the original single-pass workflow. - Long URLs download audio only, or lowest-resolution video when there is no
audio; an audio track with no speech also switches to the low-resolution video
so silent gameplay and streams can score from visual evidence. Local long files
are read in place. - Long-source Studio review: project detail exposes source metadata, progress,
per-clip render errors, and whether the full source is playable. Watch on a
long URL candidate queues a 480p preview from its downloaded section and plays
the result. - Resumable 30-minute transcription chunks with 30-second overlap merging and
global word times (transcript.partNNN.json). - Resumable 30-minute discovery blocks with
max_lenboundary context
(candidates.partNNN.json). - Selected-range section rendering for long URLs: 10-second padding, 30-second
merge gap, 10-minute cap,source_offsetglobal-to-local time mapping, and
automatic cleanup after a successful final render. - Per-clip section and render errors (
render_errors) keep successful outputs
and cached sections for retry. - Exhaustive sentence-seeded discovery with an AI-chosen duration ladder,
candidates.json/selection.jsondiagnostics, and paginated Studio review. - Fully local audio-evidence timeline with cached 1 Hz features, content
profiles, adaptive evidence weights, and a 7.0 text floor for speech-sparse
windows. - Action-only and speech-sparse clip discovery using audio event seeds, grid
seeds for varying tracks without peaks, and a clear failure for flat sources. - Fully local visual evidence from cached 2 fps analysis: motion spikes,
scene/UI changes, facecam presence, action arcs, and boundary quiet, plus a
sparse whole-source baseline. - Silent and no-commentary gameplay, PC-game, and stream support: flat audio is
treated as unavailable so visual action can score on its own. - Visual shortlisting before frame decoding, visual-only seeds for silent
footage, a 6.0 cap for flat action windows, and evidence-checked boundary
refinement. - Visual diagnostics in
candidates.jsonandselection.json:
visual_baseline,visual_ranges,visual_sections, and warnings. evidencefields incandidates.jsonandsegments.json, plus
evidence_availableand profile metadata inselection.json.- Guided CLI prompts for minimum score and preferred length, plus
--no-input
and--explainfor scripts and review. - Serial batch queue with isolated folders and aggregate failure reporting.
- Word/timestamp editing and clip-relative SRT, including retimed tightened cuts.
- Validated reusable JSON brand presets for fonts, colors, size, margins and logo.
Brand files now accept every Caption Studio field. - Semantic clip search with optional local Ollama embeddings and document caching.
- Vertical podcast split-screen with two adjustable fixed crop centers.
- Workflow, troubleshooting, local API, and machine-readable product documentation.
- Static documentation website with canonical/social metadata, JSON-LD, sitemap
and a GitHub Pages deployment workflow. - One-command installers for Windows and macOS/Linux, a contributor guide,
issue templates, and a 1280x640 social preview for the documentation site.
Changed
- Default minimum clip score is now 8.0 (was 6.5 heuristic / 8.0 LLM).
- Long sources select the audio-first, chunked, block-scanned, section-rendered
path automatically; there is no duration ceiling or mode toggle. - Render cache keys include the section offset and section identity, so long
project retries reuse finished clips without re-downloading their sections. - Every clip at or above the threshold is returned by default; the ten-clip cap
is now opt-in through--max-clips. - Clip length is selected from a duration ladder;
--preferred-lenis a soft
preference rather than a fixed target. - Default clip range is 15-300 seconds (was 20-75).
- Audio evidence adjusts the calibrated text score through the source profile
and evidence weight; content profiles never change the user-facing threshold. - Combined audio and visual evidence uses 60/40 weighting; one modality is
shrunk toward neutral, and text remains the final fallback. - Discovery cache keys include the visual feature version, so an analysis
upgrade invalidates only affected work. - Discovery and selection are cached separately, so changing the score
re-filters without rescanning the transcript. - Matching successful stages resume by default;
--no-resumeforces processing. - Caption style resolution is named preset, then brand preset, then per-project
override; aspect defaults fill unset font size and margin. - SRT cue grouping follows the caption style's words-per-cue value on project
renders. - Docs clarify setup downloads, fixed framing, language limits and score meaning.
Fixed
- Overlapping candidate windows are no longer blocked by marking covered
sentences as taken. - Zero passing clips now writes an empty segment list instead of a fallback clip.
- LLM reranking now adjusts the evidence-aware final score instead of the raw
text score, and no longer compounds an earlier adjustment on rerun. - Split-screen draft panels use even YUV420 dimensions to avoid crashes in older
ffmpeg/libass builds; padding preserves the intended preview resolution. - Changed URL downloads cannot reuse an older source file.
- LLM prompt definitions are initialized before standalone scorer execution.
- Render failures return nonzero instead of reporting success.
- Relative output paths resolve before ffmpeg changes its working directory.
- Identical clip titles cannot overwrite each other's project exports.
- A failed long-source section records a per-clip error instead of discarding
successful renders; remaining sections still render and retry later. - Long-source preview playback no longer draws the source caption overlay over
the already-rendered draft. - A stalled long-source section download falls back to a full-source download
and continues rendering withsource_offset=0.
v1.3.0
What's new in v1.3.0
- Complete-thought clips: every clip ends on terminal punctuation, never mid-thought.
- Keyword search (--search pricing): bypass virality scoring, clip around transcript matches.
- Review workflow (--clips 1,3,5): numbered candidate table, render only your picks.
- Preview drafts (--preview): fast 480p cuts before the full render.
- Dependency pre-flight: verifies ffmpeg/libx264/aac/packages with fix hints (--no-preflight to bypass).
See CHANGELOG.md and docs/USER-DEMAND-RESEARCH.md.
Full changelog: v1.2.0...v1.3.0
Chopify v1.2.0 - the self-contained release
Chopify v1.2.0 - the self-contained release
Chopify no longer needs an external LLM agent to pick clips, and the whole pipeline is now one command.
Highlights
- One command, link to clips -
python chopify.py "URL"chains download -> transcribe -> score -> render. - Built-in virality scoring - a deterministic, zero-dependency heuristic rates every transcript window on hook / shock / humour / controversy / insight / emotion / energy / complete-arc. Works fully offline.
- Optional local LLM scoring -
--llm qwen2.5:7bhands selection to a local Ollama model in strict JSON mode; falls back to the heuristic automatically if Ollama is not running. - Tighten cuts (
--tighten) - filler words (um, uh, you know) and long silences removed via word timestamps, with captions re-timed to the shortened timeline. - Caption style presets -
--style default | hormozi | mrbeast | podcast. - Ready-to-post metadata - every clip ships with
.meta.json(title, description, hashtags) plus the PNG poster. --loudnorm- broadcast-standard -14 LUFS audio.- Configurable output -
--out DIR/$CHOPIFY_OUT, default./clips(goodbye hardcodedC:\clips). - Tests & CI - 34 pytest tests and a GitHub Actions workflow on Windows.
Upgrade
git pull
pip install -r requirements.txt -r requirements-dev.txt
python chopify.py "https://youtube.com/watch?v=..." --aspect 9:16 --tightenFull changelog: #1
v1.1.0 - 16:9 default, multi-format, PNG posters
What's new in v1.1.0
- 16:9 full-frame output is now the default — keeps the whole screen, no crop.
- Multi-format:
--aspect 9:16(vertical, speaker-tracking auto-reframe) and--aspect 1:1(square). - PNG poster auto-exported next to every clip (
<clip>.png). - Demo GIF, README and infographic updated to match.
v1.0.0 - Viral Clip Pipeline
First public release.
What it does: turn long YouTube videos into scored, vertical 9:16, captioned short-form clips - fully local, no paid APIs.
Pipeline: yt-dlp -> faster-whisper (CPU medium, word timestamps) -> AI virality scoring (keep 8+/10) -> ffmpeg cut + OpenCV YuNet speaker-tracking 9:16 crop -> burnt CapCut word-by-word captions -> C:\clips
Highlights
- 100% local, zero paid APIs / cloud
- Dynamic speaker-tracking auto-reframe (snap-on-cut + edge-margin guard)
- Word-by-word burnt captions, hook-weighted virality scoring
Note: GPU transcription via whisper.cpp + Vulkan is unstable on AMD RDNA3, so it runs on CPU.