BroadCast Archipelago is a premium notification suite designed for Archipelago Multiworld sessions. It provides real-time tracking of sent and received items with a modern, fluid aesthetic that is entirely customizable.
- Player Avatars: Personalize your notifications by uploading custom images for each player.
- Friends Library: Save and reuse your favorite avatars across different slots or sessions.
- Independent Customization: Toggle custom avatars separately for your Desktop Overlay and OBS Mode.
- Smart Autocomplete: Search for items and groups with a real-time filtered list (appears below the search bar).
- Hint Point Tracking: Live tracking of available points and hint costs directly in the UI.
- Persistent Hint List: Organized history of all hints with visual "found/missing" status.
- Show Locations: Know exactly where an item was found with the new "Display Locations" toggle.
- History Integration: Locations are preserved in the event history for full session tracking.
- Multi-Tab Interface: dedicated tabs for Display, Settings, Hints, Room, and Custom.
- Live Adjustments: Toggle sync modes (Global, Personal, Filtered) without restarting.
- Timing Controls: Precisely adjust notification duration via sliders (separate for Overlay and OBS).
- Filtered Mode: Follow specific players or groups to reduce noise in massive Multiworlds.
- Dynamic Multi-Slot: Connect to multiple slots simultaneously using the
slot1:Pass, slot2:Passsyntax. - Instant Switching: Switch between active tracked players directly from the overlay.
- OBS Auto-Hide: Optional fade-out for browser sources to keep your stream layout clean.
- Independent Syncing: Set OBS to "Filtered" while keeping your Desktop Overlay on "Global".
- Optimized Rendering: Framer Motion powered 60 FPS fluid animations.
- Visual Drag & Drop: Move the overlay window directly by dragging the preview in the Control Center.
- Smart Handle (Auto-Flip): The control button automatically flips to the opposite side if it gets too close to the screen edge.
- Smart Slot Cache: The bridge remembers game links for slot names to eliminate "InvalidGame" errors.
- Network Optimization: Enhanced WebSocket handling with compression and local traffic priority.
- Diagnostic Tools: Real-time system logs and diagnostic indicators for quick troubleshooting.
This edition is fully optimized for Linux distributions, including immutable systems like Bazzite or SteamOS:
- 🏗️ Hybrid Mode: Native Python OBS server support if Node.js is unavailable.
- 🛡️ Sandbox Bypass: Pre-configured with
--no-sandboxto avoid SUID errors on Linux. - 📦 AppImage Support: Automatic detection of AppImage builds for a dependency-free installation.
- Control Center (
BroadCast-Archipelago.py): The visual configuration interface to position the overlay and manage connections. - The Bridge (
broadcast/bridge.py): The core engine maintaining the connection to the Archipelago server and handling data filtering. - Broadcast App (
broadcast-app): The visual layer (Vite + React + Framer Motion) delivering smooth 60 FPS animations.
- Run
INSTALLATION.batto install dependencies. - Launch
BroadCast-Archipelago.pywto configure and start.
- Grant permissions:
chmod +x INSTALLATION.sh - Run
./INSTALLATION.shand launch viapython3 BroadCast-Archipelago.py.
Tip
Headless Mode: Once configured, launch instantly without the UI by running python3 start_cli.py (Linux) or start_cli.bat (Windows).
- Global: Displays every event in the Multiworld.
- Filtered: Displays only items involving players in your "Tracked List".
- Personal: Displays only items you send or receive.
- Browser Source URL:
http://localhost:5173/?view=obs - Recommended Size: 400x600 (or match your Overlay dimensions)
