rip-to-yt

Desktop UI (Windows) that combines a still image + an audio file into an MP4 (h264 video + MP3 audio), with a selectable kbps. Produces a portable .exe with ffmpeg bundled in — no installation required.

Download

Download rip-to-yt.exe (v1.1.0)

Portable — just download and run, no installation needed. See all releases on the releases page.

Run in development

python -m pip install -r requirements-dev.txt
python -m pytest                                  # tests
set PYTHONPATH=src && python -m rip_to_yt.main     # opens the window

Build the executable

powershell -ExecutionPolicy Bypass -File build.ps1

The result lands in dist\rip-to-yt.exe. The ffmpeg binaries live in vendor\ (outside git); build.ps1 copies them from the ffmpeg installed via chocolatey, or place vendor\ffmpeg.exe and vendor\ffprobe.exe manually.

Behavior

• Output is MP3; the chosen kbps is a cap: a source MP3 with a bitrate ≤ kbps is copied without re-encoding; lossless or higher-bitrate sources are re-encoded.
• The MP4 is saved to the chosen folder (default: Desktop) with the audio's name.
• The original audio file is never modified.
• Format: choose the output resolution — YouTube 16:9 (1920×1080), Reels/TikTok 9:16 (1080×1920), Post 1:1 (1080×1080), or Post 4:5 (1080×1350). Fit pads the image with black bars; Fill covers and crops. A live preview shows the result before generating.
• Trim (MM:SS): tick the checkbox to export only a slice of the track (the fields are disabled while unchecked). Typing the start auto-fills the end with start + 60 s (editable). The output name is suffixed with the format and, when trimmed, the range — e.g. song [Reels] 1.00-2.00.mp4.