reeln-plugin-google
reeln-plugin-google is a plugin for reeln-cli that automates the YouTube side of live sports streaming. If you use OBS to stream games and spend time manually creating broadcasts, uploading highlights, organizing playlists, and cutting Shorts — this plugin handles all of that automatically.
It uses the YouTube Data API v3 with OAuth 2.0 (Desktop app flow) so your credentials stay local. Everything is feature-flagged and off by default — you opt into exactly the capabilities you want.
What it does
1.
2. Start streaming in OBS → OBS connects to the broadcast via your stream key
3.
4.
5.
Configuration example
All flags default to false. Enable only what you need.
Requirements
reeln-plugin-google is a plugin for reeln-cli that automates the YouTube side of live sports streaming. If you use OBS to stream games and spend time manually creating broadcasts, uploading highlights, organizing playlists, and cutting Shorts — this plugin handles all of that automatically.
It uses the YouTube Data API v3 with OAuth 2.0 (Desktop app flow) so your credentials stay local. Everything is feature-flagged and off by default — you opt into exactly the capabilities you want.
What it does
- Livestream creation — When you start a game session (reeln game init), the plugin creates a YouTube broadcast bound to your existing OBS stream key. You get the livestream URL back immediately, ready to share. No more manually creating broadcasts in YouTube Studio before every game.
- Playlist management — Automatically creates a per-game playlist and adds your livestream to it. When you upload highlights later, those get added to the same playlist. Great for organizing a season's worth of content without manual curation.
- Highlights upload — After you merge your game highlights (
reeln highlights merge), the plugin uploads the video to YouTube with auto-generated metadata from game info (teams, date, venue). If you have an LLM plugin generating titles and descriptions, it picks those up automatically. - Shorts upload — After rendering short clips (
reeln render short), the plugin detects Shorts and uploads them with #Shorts in the title. Each Short is tracked separately so other plugins (like a Discord notifier) can share them. - Game session cleanup — At the end of a game (
reeln game finish), cached auth and state reset cleanly for the next session.
1.
reeln game init → YouTube broadcast created, playlist ready2. Start streaming in OBS → OBS connects to the broadcast via your stream key
3.
reeln highlights merge → Merged video uploaded to YouTube + added to playlist4.
reeln render short → Each Short uploaded automatically5.
reeln game finish → State reset for next gameConfiguration example
YAML:
{
"plugins": {
"enabled": ["google"],
"settings": {
"google": {
"client_secrets_file": "~/.config/reeln/client_secrets.json",
"create_livestream": true,
"manage_playlists": true,
"upload_highlights": true,
"upload_shorts": false,
"privacy_status": "unlisted"
}
}
}
}All flags default to false. Enable only what you need.
Requirements
- Python 3.11+
- reeln-cli installed
- A Google Cloud project with the YouTube Data API v3 enabled and OAuth Desktop credentials (setup guide in the README)
- OBS Studio (for the streaming side — the plugin creates the broadcast, OBS connects to it)
