tvpipe tvpipeOperations Manual
Section 02Installation
02
Platforms
macOS
Linux
Windows

Installation

Install tvpipe with one command.

Where it goes

macOS and Linux: ~/.local/bin

Windows: %LOCALAPPDATA%\tvpipe\bin, added to your PATH

02.1Installing

$ curl -fsSL https://mitsuhiko.github.io/tvpipe/install.sh | sh

The installer downloads the release for your platform from GitHub and checks it before installing. The archives are also on the releases page.

02.2ffmpeg

Playing files, URLs, cameras and the screen needs ffmpeg. Sharing a browser tab or a web page does not.

PlatformInstall
macOSbrew install ffmpeg
Debian, Ubuntuapt install ffmpeg
Windowswinget install ffmpeg

tvpipe also uses ffprobe, which comes with ffmpeg. If ffmpeg is not on your PATH, point tvpipe to it with --ffmpeg PATH or the TVPIPE_FFMPEG environment variable.

Installer settings

TVPIPE_VERSION A version to install instead of the latest.

TVPIPE_INSTALL_DIR Another directory for the binary.

02.3Updating and other versions

Run the installer again to update. To install a specific version:

$ curl -fsSL https://mitsuhiko.github.io/tvpipe/install.sh | TVPIPE_VERSION=0.1.0 sh
PS> $env:TVPIPE_VERSION = "0.1.0"; irm https://mitsuhiko.github.io/tvpipe/install.ps1 | iex

Every release has these archives, with a SHA256SUMS file that the installers check them against:

PlatformArchive
macOS, Apple siliconaarch64-apple-darwin
macOS, Intelx86_64-apple-darwin
Linux, x86_64x86_64-unknown-linux-musl
Linux, ARM64aarch64-unknown-linux-musl
Windows, x64x86_64-pc-windows-msvc
Windows, ARM64aarch64-pc-windows-msvc

The Linux binaries are static and run on any distribution.

02.4Uninstalling

Delete the tvpipe binary and the config directory.

Needs

Rust 1.85 or newer and a C compiler.

02.5With Cargo

$ cargo install tvpipe-cli

This builds tvpipe from crates.io and puts it into ~/.cargo/bin. To build from the source code instead:

$ git clone https://github.com/mitsuhiko/tvpipe
$ cd tvpipe
$ cargo build --release

The binary is target/release/tvpipe.