Public links
--tunnel puts tvpipe's browser page on a public https link, for people who are not on your network.
09.1Watching from elsewhere
With the player, anyone with the link watches in their browser. That is preview, or play, screen and debug pattern with --to browser.
$ tvpipe preview movie.mp4 --tunnel
$ tvpipe screen --to browser --tunnel=opentunnel
tvpipe prints the link. In a terminal it also draws the link as a QR code, so a phone can open it by scanning the screen. --no-qr, or TVPIPE_NO_QR=1, turns that off.
When someone opens the link, tvpipe says who: their address, their country with Cloudflare, and their browser.
• 203.0.113.9 in DE (Safari 18 on iPhone) opened the public link
At most 4 people can watch over a link. Each of them gets a full copy of the stream, so your upload speed limits how many can watch.
09.2Sharing to your TV from elsewhere
With the share page, someone elsewhere opens the link and shares a tab, a window or a screen to your TVs.
$ tvpipe share --to "Living Room" --tunnel
Nothing reaches the TV until you allow it. tvpipe asks in the terminal and shows their address, their browser and what they want to share. Answer y to allow it. --yes skips the question.
Programs that use --machine or the Node SDK have no terminal to ask in. They need --yes, in the SDK yes: true, or remote shares never show.
09.3Any web app
tvpipe debug tunnel PORT puts a server of your own on a public link, and tvpipe debug qr prints QR codes. See Debug commands.
Party games do not need this: tvpipe game play starts its own link for the phones, OpenTunnel, else Cloudflare, reusing the last quick tunnel.
09.4Providers
Both are built in. Neither needs an account or another program.
| Option | Provider |
|---|---|
--tunnel, --tunnel=cloudflare | A Cloudflare quick tunnel on trycloudflare.com. Ready in about 7 seconds, with a new address every run. Cloudflare can see the page and the stream. |
--tunnel=opentunnel | OpenTunnel. The encryption ends in tvpipe, so the relay cannot read anything. The first use sets up this computer, which takes about 20 seconds once. |
09.5Safety
- Every link has a secret of its own and stops working when tvpipe stops.
- Your local link and its secret never leave the computer.
- A remote share only reaches your TV after you allow it.
09.6Limits
- Cloudflare's quick tunnels have no uptime guarantee and are not meant for heavy video.
- After a few dozen quick tunnels from one internet address in an hour, Cloudflare refuses new ones with “429 Too Many Requests” for an hour or more. Wait, or use
--tunnel=opentunnel. - OpenTunnel allows 30 new tunnels per hour per address, but a computer only creates one, on its first run.
The details are in docs/tunnels.md.