Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

mitsuhiko/tvpipe

System Tools

Mirror video, audio, screens or browser tabs to AirPlay and Google Cast receivers from one command-line tool.

119
3
Rust
Apache-2.0
1 day old

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

  1. 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
  1. Playing files, URLs and capture devices also needs ffmpeg and ffprobe; the installation manual covers ffmpeg, release archives and building from source.
  2. Discover a receiver and — for Apple TV only — pair once:
tvpipe discover
tvpipe pair "Living Room"
  1. 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/ffprobe for 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 fairplay feature; 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

  1. 0xCodez/iphone-mirror-windowsWindows tool that receives iPhone AirPlay mirroring and optionally adds USB mouse and keyboard control.Python101
  2. typecraft-dev/oma-castA keyboard launcher for Omarchy that ranks apps and Omarchy commands by learned usage, Raycast-style.JavaScript418
  3. lxe/phoneuseMirror an unmodified iPhone on Linux via AirPlay and control it with Bluetooth mouse and keyboard or a CLI.Python102
  4. 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.TypeScript1,628
  5. paulirish/chrome-captureCapture Chrome tab video and audio at 60–120fps up to 2160p using Chrome's native AV1 MP4 recorder.TypeScript108