Interscore

An overlay for OBS Studio that displays scores and other info about streamed sports games.

About

The OBS overlay is a single HTML file launched via the Browser source. The DOM contents are controlled via the WebSocket protocol using a CLI server program, meant for admins. Another client uses Qt6 and is meant for the referees and the public display in the hall. The can change the HTML contents by using the server as the middleman.

Tournament metadata (competing teams, timer lengths, game plan) is fed using a JSON file.

The overlay supports multiple "widgets" showing goals and the timer, teams participating in the tournament, currently playing teams and even red and yellow cards.

This project was made for our personal use in a Cycleball tournament under hilarious deadlines.

Usage

1. git clone --recursive https://github.com/hiimsergey/interscore && cd interscore
2. Ensure your OBS edition supports Browser Source.
3. Compile the frontend script and the binaries with make js b-install r-install.
4. Fill out input.json given the template at input.template.json.
5. Open frontnend/index.html in OBS Studio and set appropriate dimensions.
6. Launch the interscore binary.
7. Give the interscore-rentnerend binary to your nearest referee.
8. Reload the HTML page so that you see Client upgraded to WebSocket connection! in the backend terminal.
9. Press ? (followed by Enter/Return) in the backend terminal to see possible actions.

Demonstrations

• https://www.youtube.com/watch?v=3LFNC_H9lVw (a little unstable but brings the idea across)

TODO

right after performance

• tidy up assets folder (especially logo.svg)
• remoteend:
  • idiomatic restructuring
  • tight packing of five switches
  • server sends back active widgets
  • layout: change port above switches
  • remoteend looks for first match, without hard coded ip
• frontend:
  • replace "ADS" with "AD"
• website:
  • rewrite:
    • fully mobile-friendly
    • more images:
      • widgets
    • tutorial page

Neon Lila Mercedes Liste

Bis Deployment

• Windows Support

Nice to Have

• Ability to mark teams as not attending
• GUI for the JSON
• auto color_dark

TODO new

• FINAL REMOVE input.json and project.seer and assets
• FINAL screenshots of backend options and rentnerend windows

frontend

• team logos for gamestart
• Fix Font Problems wth Umlaute in Cards section
• Widget spawn animation fixen(manchmal kaputt)
• FINAL animate line by line
• FINAL comment all relevant CSS
• FINAL handle dealing multiple cards

rentnerend

• change yellow/red card icons
• FINAL Cards for Coaches
• FINAL change all icons to nice looking icons
• FINAL Feedback/Suggestions Site + Widget
• FINAL Halbzeituhr
• FINAL Add possibility of teams missing
• FINAL Add referees
• FINAL Ads in public window
• FINAL FINAL JSON-Creator GUI for non-technical users
• FINAL FINAL port to windows/mac
• FINAL³ Idee: Ansagen durch KI bei der Hälfte

backend

• OBS Replays sind noch bisschen buggy irgendwie
• FINAL abstract program so it's applicable for other games
• FINAL make json_load resilient to bad input.json
• FINAL FINAL graceful Ctrl-C handling
• Time is not send when hot reloading/sending json

meta

• How does the tiebreak work?