TVS 5.1.0-beta (4-30-2025)

[zshall]

Update Notes - 4-30-2025 (5.1.0)

✨ New features:

• Twitch engine added! You can now embed Twitch.tv streams using the channel's name. The Twitch player will respond to TVS volume controls. You need to be using a secure context to embed Twitch (per their rules) so running on localhost or on HTTPS with a domain name will work.

- number: 210
  abbr: TWITCH
  name: Twitch Stream
  twitch: twitchsports # You can embed Twitch streams using the channel's name

• Added support for dynamic references. If you define a refs section, you can define references to content and use it across multiple channels. You can even include references to other references as long as it's not a circular reference that'd cause an infinite loop.

refs: # Optional. You can define content here that can be reused in multiple places. This is useful for things like an ad that you want to show on multiple channels.
  ad1: # This is a reference to an ad that can be used in multiple places.
    image:
      src: placeholders/example-ad.gif # The image to show for the ad.
  
  intro: # This is a reference to an intro that can be used in multiple places.
    video: placeholders/tvs-intro-sd.m4v # The video to show for the intro.
  
  ad2:
    mix:
      a:
        ref: ad1 # You can use references inside other references; but be careful of circular references!
        mixMode: difference
      b:
        ref: intro
        mixMode: exclusion

channels:
- number: 190
  name: Referenced Content
  abbr: REF
  ref: ad1 # You can reference content defined in the refs section of the config file. This is useful for reusing content in multiple places.

- number: 191
  name: Loops with References
  abbr: REF2
  loop:
    content:
    - ref: ad1 # You can also use references in loops.
      duration: 3
    - ref: intro
    - image: placeholders/sequence/0.jpg
      duration: 3
    - image: placeholders/sequence/1.jpg
      duration: 3
    - image: placeholders/sequence/2.jpg
      duration: 3

- number: 192
  name: Layouts with References
  abbr: REF3
  h-split:
    a:
      ref:
        name: ad1 # You can also use references in mixes.
        overrides: # You can override the properties of the referenced content here. IMPORTANT: this only works if the referenced content doesn't use shorthand properties.
          # So for instance if you use `image: xyz.png` this won't work. You need to use `image: { src: xyz.png }` instead to do the override.
          aspectRatioBehavior: contain # Consult the properties of the referenced content for what you can override here.
    b:
      ref: intro

- number: 193
  name: References with overrides
  abbr: REF4
  ref:
    name: ad1 # You can also use references in mixes.
    overrides: # You can override the properties of the referenced content here. IMPORTANT: this only works if the referenced content doesn't use shorthand properties.
    # So for instance if you use `image: xyz.png` this won't work. You need to use `image: { src: xyz.png }` instead to do the override.
      aspectRatioBehavior: contain # Consult the properties of the referenced content for what you can override here.

- number: 194
  name: References with other references
  abbr: REF5
  ref: ad2

🕶️ Aesthetics:

• Improved error messaging has been implemented including the start of QR-based error codes where more info is available on the website.
• Animation added when Weather engine is loading

🐛 Bug Fixes:

• Version numbers display properly on About page

---

This discussion was created from the release TVS 5.1.0-beta (4-30-2025).