gitwtfhub

wtf is auto-clip?

errnex/auto-clip — explained in plain English

Analysis updated 2026-05-18

28PythonAudience · vibe coderComplexity · 3/5Setup · moderate

TL;DR

A local Python tool that turns a long YouTube video into short vertical clips with subtitles for TikTok, Reels, and Shorts, using AI to pick the best moments.

Mindmap

mindmap
  root((Auto Clip))
    What It Does
      Downloads YouTube video
      Transcribes with Whisper
      AI picks best moments
      Cuts vertical clips
    Tech Stack
      Python
      yt-dlp
      Whisper
      FFmpeg
    Use Cases
      Short-form content creation
      Automatic subtitling
    Audience
      Content creators
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Convert a long YouTube video into ten to twenty short vertical clips automatically.

REASON 2

Add subtitles and center-bottom captions to short-form video clips without manual editing.

REASON 3

Pick highlight moments from a video transcript using AI or a local rule-based fallback.

REASON 4

Remove silence from clips automatically before export.

What's in the stack?

Pythonyt-dlpWhisperFFmpegAuto-Editor

How it stacks up

errnex/auto-clipalicankiraz1/codexqbamirmushichge/vibemotion
Stars282828
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/53/53/5
Audiencevibe coderdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10 or 3.11, FFmpeg, and works on Windows, API keys are optional thanks to a local fallback analyzer.

Wtf does this do

This project is a local Python tool that automates turning a long YouTube video into a set of short clips formatted for platforms like TikTok, Instagram Reels, and YouTube Shorts. Everything runs on your own machine: the download, transcription, clip selection, cutting, subtitle adding, and export all happen locally without sending video content to an external server. The workflow starts by downloading the YouTube video using a tool called yt-dlp, then extracting its audio and transcribing it with OpenAI Whisper running locally. Whisper produces a text transcript and a subtitle file. An AI analyzer then reads the transcript and selects ten to twenty interesting moments to clip. By default the project tries AI providers in order, including Gemini, GPT, Claude, DeepSeek, Qwen, and others, falling back to a local rule-based analyzer if none of the API providers are available or configured. Each selected clip is cut to a vertical 9:16 aspect ratio at 1080 by 1920 resolution, with large white subtitles and a black outline placed at the center-bottom of the frame. The tool also applies a light automatic zoom effect, adds a short intro text from the clip's opening line, and optionally runs an automatic silence-removal pass using a separate tool called Auto-Editor. Finished clips land in an output/clips/ folder alongside a JSON metadata file for each clip. Running the tool on Windows requires Python 3.10 or 3.11, FFmpeg, and the packages listed in requirements.txt. Whisper model size is configurable: smaller models run faster on slower machines (tiny, base, small, medium, large in order from lightest to heaviest). API keys are optional since the local fallback analyzer can produce a clip plan without any external service. The README is written in Indonesian.

Yoink these prompts

Prompt 1
Help me set up this tool with Python 3.10 and FFmpeg on Windows.
Prompt 2
Which AI providers does this tool try for selecting clip moments, and how do I configure API keys for them?
Prompt 3
Explain how the local fallback analyzer works when no AI API key is available.
Prompt 4
How do I change the Whisper model size to make transcription faster on a slower machine?

Frequently asked questions

wtf is auto-clip?

A local Python tool that turns a long YouTube video into short vertical clips with subtitles for TikTok, Reels, and Shorts, using AI to pick the best moments.

What language is auto-clip written in?

Mainly Python. The stack also includes Python, yt-dlp, Whisper.

How hard is auto-clip to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is auto-clip for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.