Installation

Prerequisites

• Rust toolchain — install via rustup (stable, edition 2024).
• SQLite — bundled; no system library needed.
• For the web interface: ffmpeg and ffprobe (for video thumbnails and trickplay sprites).
• Optional: ffsubsync on $PATH for automatic subtitle/audio synchronization. The container images include it.

Tessera searches $PATH, ~/.local/bin, ~/bin, Homebrew's standard directories and the usual system binary directories. This also works when the web server is started by a service manager with a minimal $PATH. Add custom locations with the platform-separated TESSERA_TOOL_PATH environment variable.

From source

git clone <tessera repository URL>
cd tessera

# CLI only
cargo install --path tessera-cli

# Web interface
cargo install --path tessera-web

Both binaries end up in ~/.cargo/bin/. Make sure that directory is on your $PATH.

Verifying the installation

tessera --version
tessera-web --version

Updating

cd tessera
git pull
cargo install --path tessera-cli
cargo install --path tessera-web