File | Date | Author | Commit |
---|---|---|---|
.github | 2025-05-13 |
![]() |
[89f7d4] Create FUNDING.yml |
assets | 2025-06-25 |
![]() |
[616877] assets and readme update |
docs | 2025-06-24 |
![]() |
[fb9faf] Fixes: README.md update |
streamwatch | 2025-06-24 |
![]() |
[0ae706] streamwatch v.0.3.0 |
.gitignore | 2025-05-12 |
![]() |
[aed35c] Initial commit |
LICENSE | 2025-05-12 |
![]() |
[aed35c] Initial commit |
README.md | 2025-06-25 |
![]() |
[616877] assets and readme update |
activate_dev.sh | 2025-06-24 |
![]() |
[0ae706] streamwatch v.0.3.0 |
requirements-frozen.txt | 2025-06-24 |
![]() |
[0ae706] streamwatch v.0.3.0 |
requirements.txt | 2025-06-24 |
![]() |
[0ae706] streamwatch v.0.3.0 |
setup.py | 2025-06-25 |
![]() |
[e421fe] Release StreamWatch v0.3.0 |
StreamWatch is a fast, efficient, and distraction-free command-line tool for managing and watching your favorite live streams—no browser required!
streams.json
and config.ini
.rich
for a beautiful terminal experience.StreamWatch uses Streamlink under the hood, so it supports any platform Streamlink does. Enhanced display features are available for:
If your platform isn't listed, StreamWatch will still try to display what it can, and playback will work if Streamlink supports the URL.
pip install streamwatch
This will install StreamWatch and all dependencies, including Streamlink.
git clone https://github.com/snowballons/streamwatch-cli.git
cd streamwatch-cli
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
Run StreamWatch from source:
streamwatch
config.ini
, and an empty streams.json
.
https://twitch.tv/streamer1, https://youtube.com/@channel2, https://kick.com/user3
streams.json
.If the stream ends or you close the player, StreamWatch returns you to the menu. If a stream drops, it will try to reconnect for about 30 seconds.
StreamWatch uses two main files:
streams.json
)~/.config/streamwatch/streams.json
%APPDATA%\\StreamWatch\\streams.json
config.ini
)streams.json
.Example:
[Streamlink]
quality = best
timeout_liveness = 10
timeout_metadata = 15
max_workers_liveness = 4
max_workers_metadata = 2
twitch_disable_ads = true
[Misc]
donation_link = https://buymeacoffee.com/snowballons
first_run_completed = true
last_played_url =
~/.config/streamwatch/logs/streamwatch.log
%APPDATA%\\StreamWatch\\logs\\streamwatch.log
Contributions, bug reports, and feature requests are welcome!
StreamWatch is open-source software licensed under the MIT License. See the LICENSE file for details.
Happy Streaming! 📺