< back to main

// VidConverter Linux

A no-nonsense desktop media converter that wraps FFmpeg in a friendly GUI and a scriptable CLI. Point it at a video or audio file, pick a format and a quality profile, hit convert. Zero Python dependencies — it rides entirely on the standard library and whatever FFmpeg you already have installed. MIT licensed, source on GitHub.

VidConverter's GUI — format picker, quality profiles, and live progress

## // WHAT IT DOES //

Formats. WebM (VP9/VP8 + Opus/Vorbis), MP4 (H.264/H.265 + AAC), MKV, MOV (including ProRes for editing), AVI, FLV, animated GIF with optimized palettes, audio-only extraction (MP3 / AAC / FLAC / WAV), professional audio (AIFF, 24-bit and 32-bit-float WAV), and TIFF/PNG image sequences.

Quality profiles. Each format ships with tuned presets — High Quality, Balanced, Fast, and format-specific specials (ProRes, HEVC, VP8). Build your own and save them; custom profiles persist between sessions and the advanced panel exposes codec, CRF, preset, and audio settings if you want to drive manually.

GUI and CLI, same engine. The Tk GUI has a built-in file browser, live progress, and an output-extension that follows your chosen format. The CLI does the same work headless — single files, shell-glob batches (--batch *.mp4), or a JSON manifest that gives every file its own format and settings.

YouTube fetch. A companion yt_fetch CLI grabs videos by URL via yt-dlp and hands them straight to the converter — audio-only (auto-MP3) or full video, with format/profile flags. Because no one should need an account to save a clip.

## // HOW IT WORKS //

It's a thin, transparent layer over FFmpeg — it builds the command, runs it, and parses progress back into the UI. No re-encoding magic, no lock-in, no telemetry. The whole app is Python standard library; FFmpeg does the heavy lifting, so output is exactly what FFmpeg would give you, just without memorizing flags.

## // GETTING STARTED //

Grab the Windows or macOS build below, or clone the repo and run python vidconverter.py on any platform (Windows, macOS, Linux). FFmpeg must be on your system — winget install Gyan.FFmpeg on Windows, brew install ffmpeg on macOS, or your package manager of choice. A Linux build of v1.0.0 will land under the same release entry once it's cut.

// RELEASES //

v1.0.0

First public release. Windows (x64) and macOS (Apple Silicon) builds are up; a Linux build of the same v1.0.0 will be added under this entry once it's cut. MIT licensed; full source on GitHub.

What's in it

A FFmpeg front-end with a Tk GUI and a matching CLI. Convert to WebM, MP4, MKV, MOV (incl. ProRes), AVI, FLV, animated GIF, audio-only (MP3 / AAC / FLAC / WAV), professional audio (AIFF, 24-bit / 32-bit-float WAV), and TIFF/PNG image sequences. Tuned quality profiles per format (High / Balanced / Fast + format-specific specials), plus savable custom profiles and a manual codec/CRF/preset panel. Batch conversion via shell globs or a JSON manifest, a built-in file browser, live progress, and a companion yt_fetch CLI that pulls videos by URL through yt-dlp and converts them in one step.

Install

Windows — unzip VidConverter-1.0.0-win64.zip anywhere and run VidConverter.exe. It's portable; nothing is written to Program Files and settings live in settings.json next to the exe. FFmpeg must be on your PATH — winget install Gyan.FFmpeg, or grab a build from gyan.dev and add its bin\ folder to PATH. The build is unsigned, so the first launch may trip SmartScreen — click More info → Run anyway. To verify the download, check its SHA-256 against the hash listed above:

Get-FileHash .\VidConverter-1.0.0-win64.zip -Algorithm SHA256

The companion yt_fetch YouTube-downloader CLI is the separate optional download above — it bundles yt-dlp, with the same FFmpeg-on-PATH requirement.

macOS — unzip and drag VidConverter.app to Applications. The first launch is unsigned, so right-click → Open (or clear the quarantine flag) to get past Gatekeeper. FFmpeg must be installed on the system — brew install ffmpeg. Settings are stored under ~/Library/Application Support/VidConverter/.

Run from source instead (any platform): clone the repo and python vidconverter.py. Zero Python dependencies beyond the standard library; FFmpeg does the encoding.

filetypesize
VidConverter-1.0.0-win64.zip sha256 cd49d50411afcfa983f37c0198fd847cbfe2badb8e2d9781da2c139d18b3bc59 Windows · x64 (portable) 10.3 MB
VidConverter-1.0.0-macos.zip macOS App · Apple Silicon (arm64) 9.5 MB
VidConverter-yt_fetch-1.0.0-win64.zip sha256 d1e377eafa7e15c50ad8ea1ca654959d50ad5326069ce524f4ebf576226b3dd4 yt_fetch CLI · Windows x64 (optional) 22.6 MB

// VIDCONVERTER DEVLOG

all entries →