tvpipe tvpipeOperations Manual
Section 04Receivers
04
Commands
discover
pair, unpair
Option
--to

Receivers

A receiver is where tvpipe sends to: an Apple TV or AirPlay TV, a Chromecast or Google TV, or a browser tab on your computer.

Options

--timeout SECS How long to look. Default 3.

--json Every receiver with its addresses and what each protocol announces, for scripts.

--interface ADDR Also look on the network of this local address, for computers on several networks.

04.1Finding receivers

$ tvpipe discover
NAME          ADDRESS       PROTOCOLS             MODEL
Living Room   192.168.1.20  airplay(mirror),raop  AppleTV6,2
Kitchen       192.168.1.31  cast                  Chromecast

You do not need to run discover before streaming. --to with a name finds the receiver by itself.

Both protocols

TVs that speak AirPlay and Cast get Cast, unless you write airplay: before the name.

04.2Choosing with --to

FormMeaning
"Living Room", livA name. Not case sensitive, and the start is enough.
192.168.1.20A Cast receiver at this address.
192.168.1.20:7000An AirPlay receiver at this address.
airplay:NAME, cast:NAMEA name, with the protocol to use.
browserA browser tab on this computer. See Playing to a browser.

04.3Several receivers

Repeat --to to send to several receivers at once. They all get the same stream.

$ tvpipe play --to "Living Room" --to Kitchen movie.mp4
Option

--reconnect SECS How long to keep trying. Default 120, 0 turns it off.

04.4When a TV drops out

If a TV drops out while streaming, for example because it left the Wi-Fi or got a new address, tvpipe connects it again and the other receivers keep playing. A receiver given by name is looked up again, one given as an address is tried at that address. It comes back with the next full picture.

A TV where someone stopped mirroring on purpose stays off.

Caution

The pairing is a private key in credentials.txt in the config directory. Do not share that file.

04.5Pairing with an Apple TV

An Apple TV asks for a PIN the first time. tvpipe pair makes the TV show it and asks you to type it. --pin passes it directly.

$ tvpipe pair "Living Room"
$ tvpipe unpair "Living Room"

unpair forgets the pairing on this computer. Cast receivers need no pairing.