Running as a Kiosk

We’ll be using Chromium-based browsers for this guide. To run Television Simulator in a full-screen kiosk, you can use the following command-line command:

chromium --kiosk --autoplay-policy=no-user-gesture-required --unsafely-treat-insecure-origin-as-secure --disable-web-security --user-data-dir=some-data-dir http://(your TVS URL)

Caution

For safety, don’t run this as your main browser and be careful of the content you ingest. Don’t use this to go just anywhere on the web.

Here’s a breakdown of each option:

• chromium: the executable of the browser. Might be google-chrome or brave, ungoogled-chromium etc. (only you know which one you installed)
• --kiosk: Runs in kiosk mode, full screen with no menu bar or address bar. Use command + q commandq alt + f4 altf4 to quit.
• --autoplay-policy=no-user-gesture-required: Disables the autoplay restrictions that force TVS to start muted
• --unsafely-treat-insecure-origin-as-secure: Allows a regular HTTP connection to be treated as an HTTPS connection.
• http:// your TVS URL: the place TVS is hosted on your local network. Unless you trust a public instance and the people running it I would stick to a LAN IP (http://192.168.1.123:8080 or whatever your IP is).

CORS Mitigation

If a web service you rely on has no CORS headers, you might run into issues when trying to access it from Television Simulator since it runs in a browser.

• --disable-web-security: Allows you to access resources which have CORS restrictions.
• --user-data-dir=some-data-dir: Required if using --disable-web-security: Chromium runs in an isolated sandbox to try and protect you; it’ll save all user data somewhere else. Pick a folder path here and it looks like it’ll be created if it doesn’t exist.