tvpipe tvpipeOperations Manual
Section 18Diagnostics
18
Flags
-v, --debug
Variable
TVPIPE_LOG

Diagnostics

What to try when a TV does not show up or the picture does not appear.

Marks

✓ done

• a note

! a warning

✗ an error

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 discover

18.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.mp4

18.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

ProblemWhat to do
No receivers foundMake sure the computer and the TV are on the same network. Try --interface, or give --to the address.
Windows asks to allow tvpipeAllow it. Apple TVs need to reach tvpipe on your computer.
No sound in a browser tabClick the page once.
An Apple TV fails with fairplay-requiredThis tvpipe was built without FairPlay. Use a release, or build it with the default features.
tvpipe does not stopPress Ctrl-C a second time.
A site does not show with share URLIt refuses controlled browsers. See limitations.
macOS: your browser does not open, or links go nowhere, while tvpipe runstvpipe's own browser takes them. Start your browser before tvpipe. See limitations.