Tiny Vid

Tiny Vid is a desktop app for compressing video with real time preview on macOS, Windows, and Linux using ffmpeg.

Supports H.264, H.265, VP9, and AV1. Web version: handy.tools

Build

Run from repo root. Installer artifacts go to releases/<platform>/.

Build targets

Build command	Profile	Platform	FFmpeg source
yarn build	n/a	Any	System FFmpeg
yarn build:standalone	gpl	macOS	Built from source (local build script)
yarn build:standalone	gpl	Windows	BtbN GPL build
yarn build:standalone:lgpl	lgpl-vt	macOS only	Built from source (LGPL + VideoToolbox)

FFmpeg requirements:

• system mode (yarn build, yarn dev) uses your local FFmpeg from PATH.
• standalone mode bundles FFmpeg for the selected profile.

Before first build, install the Tauri prerequisites for your platform: Tauri v2 prerequisites.

Run in dev mode

• yarn dev (system)
• yarn dev:standalone (standalone + gpl)
• yarn dev:standalone:lgpl (standalone + lgpl-vt, requires VideoToolbox)

tv CLI

yarn tv is the lower-level script runner behind the build/dev/test wrappers (scripts/tv.ts).

Use yarn tv --help or yarn tv <command> --help for command-level help.

Common uses:

Task	Command
Run every supported test set	yarn tv test matrix
Prepare FFmpeg binaries by profile	yarn tv ffmpeg prepare --profile gpl
Build FFmpeg from source by profile	yarn tv ffmpeg build --profile lgpl-vt

Useful flags:

• --dry-run prints commands without executing them.
• --verbose prints extra output.
• --mode system|standalone applies to build, dev, and test.
• --profile gpl|lgpl-vt is required when --mode standalone.
• --suite applies to tv test; discovery is system-only and integration-contract is standalone-only.

License

MIT for this project. See LICENSE. Some build variants bundle GPL-licensed or LGPL-licensed FFmpeg; see THIRD_PARTY.md.