StreamWatch

Watch Live Streams Without the Browser

Lightweight & Fast

StreamWatch consumes a fraction of the CPU and RAM compared to a browser, ensuring a smooth experience.

Focus-Friendly

A clean, distraction-free terminal interface. No ads, no recommendations, just your favorite streams.

Efficient Workflow

Manage and launch live streams from a single, keyboard-driven command-line interface in seconds.

An intuitive and powerful terminal UI:

Get Started in Minutes

1. 1. Install with Pip:

   pip install streamwatch

2. 2. Run StreamWatch:

   streamwatch

   The app will create its configuration files on the first run.

3. 3. Add & Watch:

   Use the 'A' key to add stream URLs, 'F' to refresh the list, and the interactive menu to select and play.

Prerequisites: Requires Python 3.7+ and MPV Media Player.

Powerful Features for Your Terminal

• Live Status Display: See who's online with their username, platform, category, and viewer count.
• Interactive Navigation: Use arrow keys, number input, or search to quickly select streams.
• In-Playback Controls: Change quality, skip to the next/previous stream, and more, right from the terminal.
• Custom Aliases: Assign memorable names to your favorite streams for a personalized list.
• Full Stream Management: Easily add, remove, list, import, and export your streams.
• File-Based Management: Use a `streams.d` directory with simple `.txt` files to manage stream lists.
• Automatic Reconnection: Automatically tries to reconnect if a stream drops.
• Playback Hooks: Trigger your own custom scripts before and after a stream plays for ultimate automation.
• Polished UI: A modern and colorful terminal interface powered by Rich.

Full Documentation & Configuration

For comprehensive information on advanced configuration, command-line arguments, troubleshooting, and contributing, please refer to the project's official `README` on GitHub.