streamwatch-cli Files

🚀 StreamWatch v0.3.0 is here, packed with major enhancements for a smoother, more informative, and user-friendly command-line streaming experience!

This release marks a significant evolution of the tool, including a new name, a more powerful interface, and many under-the-hood improvements.

🌟 What's New & Improved

Major User Experience Upgrades

• rebranding of the entire tool.
• Enhanced Stream Display: Live streams are now shown with Username, Platform, and Category/Game, providing much richer information at a glance.
• Arrow Key Navigation: Select live streams or options in dialogs using your ↑↓ arrow keys for a more intuitive experience. Direct number input is also supported.
• Interactive In-Playback Controls: While a stream is playing, control it directly from your terminal!
  • [S]top Stream
  • [N]ext / [P]revious Live Stream
  • [C]hange Quality (fetches available qualities and relaunches)
  • [M]ain Menu (stops current stream and returns to the main menu)
  • [D]onate to Developer (opens support link)
  • [Q]uit StreamWatch
• First-Time User Experience: A welcoming message and guidance for new users on their first launch.
• "Play Last" Quick Access: New [P] option in the main menu to quickly replay the last successfully watched stream.

Configuration & Robustness

• User Configuration File (config.ini):
  • Customize stream_quality, max_workers for checks, streamlink_timeouts, and the donation_link directly in a user-specific config.ini file.
  • StreamWatch creates this file with defaults on first run. (See README for location)
• Persistent Logging: Detailed logs are now saved to streamwatch.log in your user config directory, making troubleshooting much easier. (See README for location)
• Stream Reconnection Attempts: If a playing stream temporarily drops, StreamWatch will now attempt to reconnect for approximately 30 seconds before returning to the menu.

Platform Support & Display

• Expanded Platform Parsing: Significantly improved parsing and metadata extraction for ~20 top streaming platforms (including YouTube, Twitch, Kick, TikTok, BiliBili, various European broadcasters, and more) for more accurate username and category display.
• Refined YouTube Handling: Better distinction between channel URLs and video URLs, with improved channel name and live video title extraction.

General

• Colorful Interface: Enhanced visual appeal and readability using the rich library.
• Various bug fixes and performance tweaks.

✨ Key Changes Summary

• New Name: Project rebranded to StreamWatch. (Package on PyPI: streamwatch)
• Interactive Stream Selection: Use arrow keys!
• In-Terminal Playback Controls: Manage your stream without leaving the terminal.
• User config.ini: Customize your experience.
• Better Metadata Display: Know more about what's live.

💾 Installation / Upgrade

To install or upgrade to StreamWatch v0.3.0:

:::bash
pip install --upgrade streamwatch