tvpipe tvpipeOperations Manual
Section 05Playing media
05
Command
play
Needs
ffmpeg

Playing media

tvpipe play plays a file or a URL on the TV, or mirrors a camera or the screen.

05.1Files and URLs

$ tvpipe play --to TV movie.mkv
$ tvpipe play --to TV --loop intro.mp4
$ tvpipe play --to TV https://example.com/stream.m3u8

--loop starts over at the end. --no-audio sends only the picture.

tvpipe reads files at playback speed. A live source already arrives at that speed, and --no-realtime turns the pacing off for it.

Tip

For the screen, a window or a browser tab, Sharing the screen is simpler and sends the sound too.

05.2Screens and cameras

Everything after -- goes to ffmpeg as its input, so anything ffmpeg can capture works.

PlatformMirror the screen
macOStvpipe play --to TV -- -f avfoundation -i 1:0
Linuxtvpipe play --to TV -- -f x11grab -i :0.0
Windowstvpipe play --to TV -- -f gdigrab -i desktop

On macOS, ffmpeg -f avfoundation -list_devices true -i "" lists the screens and cameras.

05.3Size and quality

$ tvpipe play --to TV --size 1280x720 --fps 30 --bitrate 4000 movie.mp4

By default tvpipe picks what the input and the TV support. These options set limits, they never make the picture larger. All options are in Options.