reeln-plugin-streamn-scoreboard

A reeln-cli plugin that bridges game initialization to the streamn-scoreboard OBS plugin.

When reeln game init runs, this plugin writes initial game state to the scoreboard's 22 text output files — setting team names, clock time, scores, shots, faceoffs, fouls, period labels, penalty durations, sport, and clearing penalties. It also clears any stale timestamps.txt from a previous session.

When reeln game finish runs, the plugin copies timestamps.txt (written by OBS during the game) to chapters.txt in the game directory and populates context.shared["game_events"] for downstream plugins (e.g. Google plugin YouTube chapter insertion).

Install

reeln plugin install streamn-scoreboard

Or for development:

git clone https://github.com/StreamnDad/reeln-plugin-streamn-scoreboard
cd reeln-plugin-streamn-scoreboard
make dev-install

Configuration

Add the scoreboard plugin settings to your reeln-cli config:

{
  "plugins": {
    "settings": {
      "streamn-scoreboard": {
        "output_directory": "/path/to/scoreboard/output"
      }
    }
  }
}

Options

Output Files

Usage

Once installed and configured, the plugin activates automatically. Run:

reeln game init Eagles Hawks --sport hockey --level bantam

The plugin writes initial scoreboard state to the configured output directory. The OBS scoreboard's 100ms write loop takes over once the game is running.

After the game, run:

reeln game finish

The plugin copies event timestamps from the scoreboard output to chapters.txt in the game directory for downstream use (YouTube chapter descriptions, ffmpeg chapter injection).

Clock Resolution

The clock value is resolved with the following priority:

1. game_info.period_length — set via --period-length CLI flag or interactive prompt
2. home_profile.period_length — from the team profile when --level is used
3. Sport-based default — fallback from the table below

Supported Sports

Development

make dev-install    # editable install with dev deps
make test           # pytest with 100% coverage
make lint           # ruff check
make format         # ruff format
make check          # lint + type check + test

License

AGPL-3.0