Diagnostics
What to try when a TV does not show up or the picture does not appear.
18.1What tvpipe prints
tvpipe prints what happens for people: a title, a line per step, links with their QR codes, and on a terminal a status line at the bottom. An error says what to try next.
q stops, and while a TV, a browser or phones are watching it asks first: press q again to stop, any other key to keep going. Ctrl-C never asks, and a second Ctrl-C quits at once. On Windows, q needs Enter.
$ tvpipe play --to "Nowhere TV" movie.mp4
tvpipe · Playing movie.mp4
✗ No receiver named "Nowhere TV" answered on this network
See which receivers are on this network: tvpipe discover18.2More detail
-v prints the debug log and --debug adds every protocol message, which is a lot. TVPIPE_LOG=info, or error, warn, debug and trace, prints the log at that level.
$ tvpipe -v play --to TV movie.mp418.3Colours and QR codes
Colours follow NO_COLOR and CLICOLOR=0, and CLICOLOR_FORCE or FORCE_COLOR force them. With TERM=dumb, in a pipe or in a log file, tvpipe prints plain lines without a status line. --no-qr or TVPIPE_NO_QR=1 hides the QR codes.
18.4Common problems
| Problem | What to do |
|---|---|
| No receivers found | Make sure the computer and the TV are on the same network. Try --interface, or give --to the address. |
| Windows asks to allow tvpipe | Allow it. Apple TVs need to reach tvpipe on your computer. |
| No sound in a browser tab | Click the page once. |
An Apple TV fails with fairplay-required | This tvpipe was built without FairPlay. Use a release, or build it with the default features. |
| tvpipe does not stop | Press Ctrl-C a second time. |
A site does not show with share URL | It refuses controlled browsers. See limitations. |
| macOS: your browser does not open, or links go nowhere, while tvpipe runs | tvpipe's own browser takes them. Start your browser before tvpipe. See limitations. |