Installation

Installation

Clippy drives ffmpeg (which provides ffprobe) and yt-dlp. On Windows it can fetch both for you, plus its own required transition asset (static.mp4); elsewhere, install them with your package manager.

Windows, no Python needed

Download clippy.exe from the latest release and run it. Everything — the CLI, the TUI, the overlay font — is inside the one file.

Then let Clippy fetch what it needs:

clippy deps      # downloads ffmpeg + yt-dlp into bin, and static.mp4 into transitions
clippy doctor    # confirms the setup

clippy deps downloads ffmpeg and yt-dlp from their own publishers and checks each against the checksum they publish, so a truncated or tampered file is rejected rather than half-installed. Clippy itself ships neither: common Windows ffmpeg builds are GPL, and bundling one would push that licence onto this otherwise-MIT project. static.mp4 is Clippy's own asset, checked against a checksum pinned in the source — swap it out any time for your own branding.

clippy doctor checks ffmpeg, ffprobe, and yt-dlp are all present and runnable, that your Twitch (or Discord) credentials are set, that transitions/static.mp4 exists, and that the output folder is writable. Run it any time you're not sure what's wrong.

With pip

Grab the wheel from the latest release:

pip install clippy-x.y.z-py3-none-any.whl

Or install from source:

git clone https://github.com/zebadrabbit/Clippy.git
cd Clippy
pip install -e ".[tui,dev]"

Requires Python 3.10+. On macOS/Linux, install ffmpeg and yt-dlp yourself:

# macOS
brew install ffmpeg yt-dlp

# Debian/Ubuntu
sudo apt install ffmpeg yt-dlp

static.mp4 still needs to be in your transitions/ folder — clippy deps is Windows-only for the automatic download; elsewhere, place one there yourself (see transitions/README.md in the repo) or point TRANSITIONS_DIR at a folder that has one.

Next

Once clippy doctor reports all checks passing, head to First run for the guided setup wizard.