TVS 4.2.0-beta (12-19-2024)

[zshall]

Update Notes - 12-19-2024 (4.2.0)

✨ New features

• Added channel permalinks. By default now TVS will populate the document hash with the channel number. When you refresh TVS the previous channel will be loaded. You can change the way this works by using persistCurrentChannel: localstorage to save the current channel to local storage instead of URL on change, or persistCurrentChannel: false to use the old behavior of not saving the channel on change. Permalinks will work regardless.
• Added toggle for animated channel change. In the config file set animateChannelChange: false to disable the "shake" effect when the screen changes.
• Added cache busting for the config file, since often this file is often cached more aggressively than we want. To disable this feature you'll need to edit the environment file under _app/env.js: use export const env={"PUBLIC_USE_CACHE_BUSTER":"false"} instead of true.
• Added webhook support for external integrations. This is for receiving data from TVS, not sending to it. TVS will call these webhooks when channel, volume or mute events occur to let your service know it. This is useful if you want to show the channel or volume information on an external display.
  • All webhooks are sent as GET requests.
  • The bracketed variables will be replaced at the time that the webhook is fired. If TVS is showing channel 12 then channel={channel} will become channel=12.

# webhooks: # Optional. You can set up webhooks to send data to external services when certain events happen.
#   channelChange: http://your-server/receive_update?channel={channel}&manual={isManualInput} # Optional. This is the URL that will be called when the channel changes. The channel number and whether it was a manual input will be sent as query parameters.
#   volumeChange: http://your-server/receive_update?volume={volume} # Optional. This is the URL that will be called when the volume changes. The volume level will be sent as a query parameter.
#   muteChange: http://your-server/receive_update?isMuting={isMuting} # Optional. This is the URL that will be called when the muting or unmuting. The mute state will be sent as a query parameter.

🐛 Bug fixes

• Fixed bug in bouncing logo engine where the logo wouldn't draw on load.
• Fixed bug with audio blips on channel changes when muted
• Fixed screen stretching function so that the entire TV container stretches, not the inside contents of the container.

Read this first!

Get started quickly:

• Put the files in the root directory of a web server. For now we require serving out of the root directory.
• Visit index.html and it should load the example configuration.

Basic keyboard controls:

• M toggles mute
• Up / Down control channels
• Left / Right control volume

In the browser you need to un-mute when the page loads because of autoplay restrictions.

Edit the example configuration file (config.tvs.yml) and make it your own.

Read the documentation: https://greenhillplaza.notion.site/Television-Simulator-99-c28584f069b94f58a71b5c9fe2484dcb

Join our community on Slack to ask for help or report issues: https://join.slack.com/t/greenhillplaza/shared_invite/zt-2dq8mx6sm-3YnobHETTmxUNE02TOSPRg

---

This discussion was created from the release TVS 4.2.0-beta (12-19-2024).