A real-time FIFA World Cup 2026 sidebar widget for Übersicht on macOS.
Live scores · Full schedule · 20+ radio streams · German TTS commentary — all in one slick dark panel.

Platform Übersicht Python License

WM 2026 Widget

wm2026.jsx ← Übersicht widget (JSX / React-like)
 │ shell command every 3 s
 │ └─ curl ESPN API → today.json / schedule.json
 │ └─ python3 engine.py → feed.json, state.json
 │
 └─ fetch() every 3 s → wm2026_server.py (Flask, port 9876)
 ├─ /api/status current mpv state
 ├─ /api/play start a stream
 ├─ /api/stop stop mpv
 ├─ /api/volume adjust volume
 ├─ /api/streams available / reachable streams
 ├─ /api/ticker live scoreboard (ESPN, 30 s cache)
 ├─ /api/commentary ESPN play-by-play (live games only)
 ├─ /api/comments kicker.de live-ticker scrape (45 s)
 └─ /api/shift move Finder desktop icons (optional)

Data files live in ~/.wm2026/ and are never committed (see .gitignore).

# 1. Clone
git clone https://github.com/AlexDesign420/wm2026-widget.git
cd wm2026-widget
# 2. Install
./install.sh
# 3. Restart Übersicht (or "Refresh All Widgets")

The server starts automatically the first time the widget loads.

If you prefer to install step by step:

# Create data directory
mkdir -p ~/.wm2026
# Copy backend
cp engine.py wm2026_server.py sources.json ~/.wm2026/
# Copy widget
cp wm2026.jsx ~/Library/Application\ Support/Übersicht/widgets/
# Install Python deps
pip3 install flask requests beautifulsoup4

Edit sources.json (or ~/.wm2026/sources.json after install).
Each entry is either a static URL or a scrape target:

{
 "id": "my-station",
 "name": "My Radio",
 "country": "DE",
 "language": "de",
 "type": "static",
 "url": "https://example.com/stream.mp3"
}

The server checks all streams in parallel every 2 minutes and only shows reachable ones in the widget.

Toggle "Tor-Sound" in the widget to enable/disable the engine.py commentary.
To change the voice, edit VOICE = "Anna" in engine.py (run say -v ? for a list).

When the ticker side-panel slides open, the server can move your Finder desktop icons to make room. To enable this:

cp shift_config.example.json ~/.wm2026/shift_config.json

Then edit ~/.wm2026/shift_config.json — set the icon names and pixel positions to match your desktop layout. The feature is silently disabled if the file is missing.

The local server exposes a simple REST API (CORS enabled, localhost only):

• Scores & schedule — ESPN public API — no API key required
• Play-by-play — ESPN summary endpoint
• Live-ticker text — kicker.de (scraped)
• Streams — Public broadcaster HLS/Icecast streams (ARD, ZDF, BBC, NPR, ...)

Widget shows "Streams werden geprüft..."
The server needs a moment to probe all streams on first launch. Wait ~10 seconds.

No audio / "failed to start audio"
Make sure mpv is installed: brew install mpv. The server looks for it at /opt/homebrew/bin/mpv and /usr/local/bin/mpv.

Server doesn't start
Check ~/.wm2026/server.log. You can start it manually:

python3 ~/.wm2026/wm2026_server.py

Widget is blank
Übersicht sometimes needs a full restart after installing a new widget. Use ⌘Q and reopen.

MIT — see LICENSE.