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.14Games to playParty games to play by name, downloaded when you play them.15Making party gamesBuild a game for tvpipe, check it, pack it into a zip, run it and share it.16Commands and optionsEvery command, and the options they share.17ConfigurationWhere tvpipe keeps its files.18DiagnosticsWhat to do when something does not work.19LatencyThe test pattern, measuring the delay, statistics.20ffmpeg and encodingWhen tvpipe needs ffmpeg.21Debug commandsThe test pattern, checking an input, a public link for any port, QR codes.