Skip to main content

​
What is boofstream?

boofstream is an overlay tool for Super Smash Bros. Melee tournament streams that connects to a Wii running Melee through a Slippi console relay. Built by viboof, it automates tedious streaming tasks so you can focus on producing engaging tournament content.
boofstream is beta software. Use at your own risk. Check the known issues before getting started.

Watch: boofstream in 4m20s

See boofstream in action with this quick video tutorial

​
Key features

Automatic scene switching

Seamlessly switch between your game and crowd cam scenes in OBS when matches start and end

Live score tracking

Scores update automatically as games end, detecting LRAS and Sheik/Zelda transforms

Character detection

Real-time character tracking with support for all 26 Melee characters and costume colors

Bracket integration

Pull player info, match details, and set data directly from Start.gg and Parry.gg

Customizable overlays

Outputs text files and images for easy integration with your existing OBS layouts

Browser-based UI

Manage everything through an intuitive web interface at localhost:1337

​
Who is boofstream for?

boofstream is designed for:
  • Tournament organizers running local or regional Melee events
  • Stream producers who want to automate score tracking and scene management
  • Content creators looking for professional tournament overlays
  • TO’s upgrading from manual score updates or other overlay solutions like TournamentStreamHelper

​
How it works

1

Connect to Slippi

boofstream connects to your Wii through Slippi’s console relay on port 53742 (configurable)
2

Detect game events

As games start and end, boofstream tracks characters, stocks, stage selection, and match outcomes
3

Update overlays and scenes

Text files and images are written to the out/ directory, and OBS scenes switch automatically
4

Sync with brackets

Optionally pull tournament data from Start.gg or Parry.gg to pre-fill player information

​
What gets generated?

boofstream creates output files in the out/ directory that you can add as sources in OBS:
  • program_state.json - Full state in TournamentStreamHelper-compatible format
  • p1/ and p2/ directories with individual text files (name, sponsor, score, etc.)
  • Character images with costume colors
  • Round, phase, and tournament information
boofstream is compatible with existing TournamentStreamHelper layouts, making migration seamless.

​
Real-world usage

boofstream has been used in production at:

​
Next steps

Quickstart

Get boofstream running in minutes

Installation

Detailed installation instructions for all platforms

Slippi connection

Set up the connection to your Wii

OBS integration

Configure automatic scene switching

​
Technology

boofstream is built with:
  • @slippi/slippi-js - Slippi replay file parsing and real-time data
  • @vinceau/slp-realtime - Real-time Slippi game state events
  • obs-websocket-js - OBS scene control
  • Start.gg and Parry.gg APIs - Tournament bracket integration
  • Express + Socket.io - Web server and real-time updates
  • Next.js - Browser-based management UI

View on GitHub

Check out the source code, report issues, or contribute

Build docs developers (and LLMs) love

Get started for freeTalk to us