TVS 4.4.0-beta (1-12-2025)

[zshall]

Update Notes - 4.4.0

⚙️ Enhancements

• Images can now be constrained to aspect ratios if they don't fill the screen.

- number: 2
  name: Welcome
  abbr: HELLO
  image:
    src: placeholders/welcome.png # If you use more than one option for images you need to specify the source like this.
    aspectRatioBehavior: contain # Optional. The aspect ratio behavior of the image. Values are contain or cover. Defaults to cover.

✨ New features

• Ability to play background audio in the "no signal" channel

noSignalContent: # Optional. You can specify content to show when the TV is off the air.
  image: placeholders/no-signal.png # Required. The image to show when the TV is off the air.
  backgroundAudio: placeholders/bgm-3.mp3 # Optional. You can add background audio to the no signal screen.

• Added ability to specify custom screen dimensions in the config file. After modifying this value it will apply when your picture settings are reset.

# Screen dimensions defaults can be overridden here. If you don't specify these the TV will be 640x480 by default.
# Not all channel content will scale to fit the screen; some content will always render at its native resolution (640x480)
# **Note**: If you change these values, be sure to reset your picture settings using `alt + r` or you won't see the changes.
dimensions:
  screenWidth: 1280 # Optional. The width of the screen in pixels.
  screenHeight: 720 # Optional. The height of the screen in pixels.
  # scaleX: 100 # Optional. The scale of the screen percentage-wise on the X axis. Default is 100.
  # scaleY: 100 # Optional. The scale of the screen percentage-wise on the Y axis. Default is 100.

• Added customizable OSD behavior when displaying on different screen sizes:
  • Hybrid (default): centers the OSD where a standard 4:3 screen would be, with tasteful overflow for background graphics.
  • Stretch: fills the entire available space with the OSD.
  • Letterbox: centers and crops the OSD to 4:3 screen.

osd:
  theme: sat2007
  aspectRatioBehavior: stretch # Optional. The aspect ratio behavior of the screen. Values are stretch, letterbox, or hybrid. Defaults to hybrid.
  themeOptions: # certain themes have additional options that can be set like this:
    showMessageIcon: true
    showChannelLockIcon: true

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.4.0-beta (1-12-2025).