mitsuhiko/tvpipe
System ToolsMirror video, audio, screens or browser tabs to AirPlay and Google Cast receivers from one command-line tool.
What it does
tvpipe pipes video and audio to AirPlay and Google Cast receivers — Apple TV, smart TVs, Chromecast, Google TV — and to browser tabs. It speaks the ecosystems' real-time mirroring protocols instead of handing the receiver a URL, so playback stays a fraction of a second behind the source. It is a single self-contained binary with its own mDNS, protocol stacks and H.264/AAC encoders, and it also ships a Rust library, a Node SDK, and a --machine mode for other languages.
Typical uses: replaying a local file or URL across one or several TVs, mirroring a screen or a single window with system audio, pushing a web page to a TV, or previewing a stream in a browser tab for OBS or a video call.
Quick start
- Install on macOS/Linux with the install script, or on Windows with the PowerShell installer:
curl -fsSL https://mitsuhiko.github.io/tvpipe/install.sh | sh
- Playing files, URLs and capture devices also needs
ffmpegandffprobe; the installation manual covers ffmpeg, release archives and building from source. - Discover a receiver and — for Apple TV only — pair once:
tvpipe discover
tvpipe pair "Living Room"
- Play a file to it:
tvpipe play --to "Living Room" movie.mp4
The same receiver name can be repeated with --to to feed two TVs from one encode, and screen/share handle screen, window, browser tab or web page mirroring. A step-by-step walkthrough is in the quick-start manual.
Public links
--tunnel exposes a browser preview or a share page on a public HTTPS link, with no account needed. The default Cloudflare Quick Tunnel gets a new *.trycloudflare.com hostname each run and terminates TLS itself, so it can read page and stream; --tunnel=opentunnel terminates TLS inside tvpipe instead. Links carry a per-run token, allow at most 4 viewers, and remote shares need terminal confirmation and expire after 60 minutes by default (--tunnel-ttl).
Constraints
- Encoding and capture go through
ffmpeg/ffprobefor files, URLs and devices; suitable MP4/MOV/MKV files are sent without re-encoding. - Screen and window mirroring with computer sound are captured by a Chromium-based browser that tvpipe starts, or by ffmpeg.
- Pairing is Apple TV-only; Cast receivers are used without it.
- Building from source needs Rust 1.85+ and a C compiler.
- Source is Apache-2.0, except the FairPlay crate, which is LGPL-3.0-or-later and is enabled by the
fairplayfeature; the distributed binary includes it and is therefore under LGPL-3.0-or-later terms.
HotRepo's take
The project is too new for a daily leaderboard placement, but in the first tracked day on the Rust new list it went from 100 to 107 stars (7 gained over a roughly 1.5-hour window). Those numbers only describe early attention, not adoption; the more interesting signal is the scope behind the CLI: five workspace crates, a Node SDK, documented protocols and a machine mode, which suggests a broadcast utility meant to be driven by other programs rather than a one-off script.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- 0xCodez/iphone-mirror-windowsWindows tool that receives iPhone AirPlay mirroring and optionally adds USB mouse and keyboard control.
- typecraft-dev/oma-castA keyboard launcher for Omarchy that ranks apps and Omarchy commands by learned usage, Raycast-style.
- lxe/phoneuseMirror an unmodified iPhone on Linux via AirPlay and control it with Bluetooth mouse and keyboard or a CLI.
- vega-org/vega-appAn Android player for local and remote video that can cast to Google Cast or DLNA screens with selectable audio and subtitle tracks.
- paulirish/chrome-captureCapture Chrome tab video and audio at 60–120fps up to 2160p using Chrome's native AV1 MP4 recorder.