tvpipe tvpipeOperations Manual
Section 07A web page on the TV
07
Command
share URL
Needs
Chrome, Edge, Chromium, Brave or Firefox

A web page on the TV

Give share a URL and tvpipe opens it in a hidden browser of its own and puts it on the TV, with sound.

Size

The page gets the shape of the TV, laid out at up to 1920×1080. --size sets another layout. --resolution (auto, 720p, 1080p, 4k) sets how sharp it is on the TV: the layout stays, tvpipe renders it at a higher scale. auto goes up to 1080p as far as the TV allows; 4K only when you ask for it.

07.1Showing a page

# a dashboard, reloaded every 30 minutes
$ tvpipe share https://status.example.com --to TV --reload 30

# a local file
$ tvpipe share ./slides.html --to TV

Starting takes about a second. If the page reloads or navigates, the TV shows a short gap of about half a second. If the page or the browser crashes, tvpipe starts it again.

# a 1280×720 dashboard, sharp on a 4K TV
$ tvpipe share https://status.example.com --to TV --size 1280x720 --resolution 4k

--visible, --profile, --reload, --browser and --resolution only work with a URL. 4K needs a TV that takes it (an Apple TV is asked for its full decoder size; a Chromecast that allows only 1080p gets 1080p) and a computer with a hardware video encoder. Firefox renders at the page's own size.

Profiles

tvpipe never uses your own browser profile. Without --profile every run gets a new one, deleted afterwards, or by the next run if tvpipe was killed.

07.2Pages that need a login

Log in once in a visible window and keep the profile. Later runs use it without a window.

$ tvpipe share https://grafana.example.com --to TV --visible --profile ~/tvpipe-grafana
$ tvpipe share https://grafana.example.com --to TV --profile ~/tvpipe-grafana

With --visible, closing the window stops tvpipe.

Order
  1. --browser PATH
  2. TVPIPE_BROWSER
  3. Chrome, Edge, Chromium, Brave
  4. Firefox

07.3Which browser

Any Chromium based browser works, and Firefox. tvpipe uses the first one it finds, so Firefox only when no Chromium based browser is installed. --browser firefox picks Firefox.

$ tvpipe share https://status.example.com --to TV --browser firefox

Firefox shows the page with its sound too. Its own speakers stay quiet while tvpipe shares. Pages that set their content security policy in a <meta> tag cannot share in Firefox. On Linux, a Firefox installed as a Snap cannot read tvpipe's profile in /tmp: use Firefox from Mozilla or your distribution's package.

07.4Limitations

Some sites refuse browsers that are controlled by a program. tvpipe does not hide that, so those sites do not work, and tvpipe reports their answer (401, 403 or 429). Video calls are an example. For those, open the call in your normal browser and present a browser tab in it.

On macOS, the system treats tvpipe's hidden browser as a running copy of that browser, Chrome for example. While it runs and your own Chrome does not, opening Chrome from the Dock or Spotlight, or a link from another app, goes to tvpipe's browser, and nothing seems to happen. Start your browser before tvpipe and keep it open, or stop tvpipe first. Another way is to give tvpipe a browser you do not use yourself with --browser. The same goes for tvpipe screen and the window of tvpipe game play, where --window=open uses your usual browser instead.