streamcondor 1.0.17

System tray app that monitors livestreams and launches them in your favorite player via Streamlink.

StreamCondor 🦅

Monitor → Click → Watch. No browser, no bullshit. → screenshots on GitHub

StreamCondor is a lightweight system-tray app that monitors livestreams and opens them with Streamlink.

Features

• 🔔 Real-time stream monitoring
• 🎯 Multi-platform support (Twitch, YouTube, and other Streamlink-supported sites)
• 🖥️ System tray integration with status icons
• 🎨 Custom player support (mpv, VLC, or your preferred player)
• ⚙️ Per-stream quality, notification, streamlink and player options overrides
• 🕒 Last online / last watched tracking
• 🌐 Favicon fetching and caching
• 📋 Quick launch from clipboard URL

Supported OS: Linux, Windows, macOS (desktop environments with a system tray)

Requirements

• Python 3.12+
• A desktop environment with system tray support
• Streamlink-compatible media player (optional, but recommended)

Install (PyPI)

pip install streamcondor

Run:

streamcondor

Run from source

git clone https://github.com/tarzasai/StreamCondor.git
cd StreamCondor
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt
pip install -e .
streamcondor

Alternative without editable install:

PYTHONPATH="$PWD/src" .venv/bin/python -m streamcondor.main

Command-line options

-c, --config PATH         Path to custom configuration file
-l, --log-level LEVEL     DEBUG | INFO | WARNING | ERROR (default: INFO)
    --denoise-logging     Reduce dependency log noise

Example:

streamcondor --log-level DEBUG --denoise-logging

Configuration

StreamCondor stores a JSON config file per user.

• Linux: ~/.config/StreamCondor.json
• Windows: %APPDATA%\StreamCondor.json
• macOS: ~/Library/Application Support/StreamCondor.json

If the file does not exist, StreamCondor creates one with defaults.

Minimal example:

{
	"check_interval_mins": 5,
	"default_quality": "best",
	"default_notify": false,
	"streams": {
		"https://www.twitch.tv/some_channel": {
			"url": "https://www.twitch.tv/some_channel",
			"name": "some_channel",
			"type": "twitch"
		}
	}
}

Development

Bootstrap a local development environment:

./setup_dev.sh

Run tests (recommended from repository root):

PYTHONPATH=src .venv/bin/python -m pytest

Or use the helper script:

./run_tests.sh

Troubleshooting

• No tray icon: verify your desktop environment provides a system tray (some Wayland setups need extra integration).
• Stream does not open: ensure streamlink and your target media player are installed and available in PATH.
• Plugin/auth-related issues: check your Streamlink user config and plugin setup.
• To troubleshoot with logs:

streamcondor --log-level DEBUG

Reporting issues

Open an issue at https://github.com/tarzasai/StreamCondor/issues and include:

• OS and desktop environment
• Steps to reproduce
• Relevant terminal logs

License

MIT License - see LICENSE for details.

Acknowledgments

• Streamlink
• PyQt6
• Contributors and testers

This is a third-party tool and is not affiliated with any streaming platform.

KDE Tip (Optional)

If you use KDE Plasma (KWin), you may also like Director: https://github.com/tarzasai/kwin-script-director

Director is a KWin script that automatically arranges windows, keeps one primary window large, and parks the others on a screen edge so you can keep them visible.

This is only relevant for KDE/KWin users.

Screenshots