Overview
tvpipe is a command line tool that puts video and sound from your computer on a TV. It sends to Apple TV, Chromecast, other AirPlay and Google Cast receivers, and browser tabs.
01.1What it does
- Plays a video file or a URL on the TV.
- Mirrors a camera, a capture card or the screen.
- Shows a browser tab, a window or the whole screen.
- Puts a web page on the TV, such as a dashboard.
- Takes frames and sound from a game.
- Sends to several TVs at once.
- Runs party games that everyone plays with their phone.
01.2How it works
tvpipe uses the screen mirroring protocols of AirPlay and Google Cast. The TV does not download anything by itself. tvpipe encodes the picture and the sound and sends them to the TV while they play.
01.3What it does not do
- Receive. tvpipe only sends.
- Tell the TV to play a URL by itself.
- Play sound alone on HomePods or speaker groups.
01.4Sections of this manual
02InstallationInstall tvpipe with one command.03Quick startFind a TV, pair it once and play a file.04ReceiversFinding TVs, pairing and choosing where to send.05Playing mediaFiles, URLs, cameras and the screen.06Sharing the screenThe screen, a window or a browser tab, with sound.07A web page on the TVDashboards and slides, without a browser window.08Playing to a browserPreviews, OBS and video calls.09Public linksLet people elsewhere watch, or share to your TV.10Game inputFrames and sound from your own program.11From Node.jsStream from your own program with the @tvpipe/sdk npm package.12From RustStream from your own Rust program, a game for example, with the tvpipe crate.13Party gamesGames on the TV that everyone plays with their phone.14Making party gamesBuild a game for tvpipe playshare, check it, pack it into a zip, and run it.15Commands and optionsEvery command, and the options they share.16ConfigurationWhere tvpipe keeps its files.17DiagnosticsWhat to do when something does not work.18LatencyThe test pattern, measuring the delay, statistics.19ffmpeg and encodingWhen tvpipe needs ffmpeg, and checking an input.