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.
- Zero Click Interference: Empty and transparent areas of the overlay now pass mouse clicks directly through to your game, tracker, or desktop underneath. No more invisible window blocking your mouse!
- Smart Mouse Capture: Interactive elements (launcher button, settings panel) automatically capture mouse events when hovered.
- Direct Drag & Move: Grab and move the overlay smoothly by holding the grip handle directly, without needing to hover or click on the launcher button first.
- Targeted DataPackage: The bridge now queries
GetDataPackagewith the specific list of active games ({"cmd": "GetDataPackage", "games": ...}), drastically reducing network payload and ensuring compatibility with Archipelago 0.5.x and 0.6.x+ servers. - Secure WebSockets (WSS): Added robust SSL/TLS support for secure server connections (
wss://).
- Effortless Styling: Customize notification colors (Progression, Useful, Junk, Trap), borders, glowing effects, and fonts by placing a
custom.cssfile next to the launcher (template provided incustom.example.css). No rebuild required!
- 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.
- Default Browser Source URL:
http://localhost:5173/?view=obs - Specific Player Filter (Multi-POV / Tournament / Restream):
- Add
&player=PlayerNameto display only events for a specific player:http://localhost:5173/?view=obs&player=PlayerName - Multi-Player / Duo Team Filter: You can also filter for multiple players separated by commas:
http://localhost:5173/?view=obs&player=Player1,Player2
- Add
- Recommended Size: 400x600 (or match your Overlay dimensions)
