• Features
• Supported Sites
• Quick Start
• Requirements
• Usage
  • Console Commands
  • Remote Controller
  • Web Interface
• Docker Support
• Configuration
• Disclaimer

✅ Multi-Platform Support - 13+ streaming platforms (Chaturbate, StripChat, BongaCams, and more) ✅ Web Dashboard - Modern web interface for easy management ✅ Docker Ready - Pre-configured Docker & docker-compose setup ✅ Resolution Selection - Choose your preferred video quality ✅ Auto-Recording - Automatically starts recording when streamers go live ✅ Multiple Interfaces - CLI, Web UI, and ZeroMQ remote control ✅ FFmpeg Powered - Reliable video recording and processing

Currently not supported:

• Amateur.TV (They use Widevine now)
• Cherry.tv (They switched to Agora)
• ImLive (Too strict captcha protection for scraping)
• LiveJasmin (No nudity in free streams)
• ManyVids Live (They switched to Agora)

There are hundreds of clones of the sites above, you can read about them on this site.

# Clone the repository
git clone https://github.com/axsddlr/StreaMonitor.git
cd StreaMonitor

# Start with docker-compose
docker-compose up -d

# Access web interface at http://localhost:5000

# Clone the repository
git clone https://github.com/axsddlr/StreaMonitor.git
cd StreaMonitor

# Install dependencies
pip install -r requirements.txt

# Run the application
python3 Downloader.py

# Access web interface at http://localhost:5000

• Python 3.12+ (Python 3.8+ may work but not tested)
• FFmpeg - Must be installed and available in PATH
• 5GB+ disk space - For recordings

All dependencies are listed in requirements.txt:

• Flask (Web interface)
• requests (HTTP client)
• BeautifulSoup4 (HTML parsing)
• FFmpy (FFmpeg wrapper)
• m3u8 (HLS playlist parser)
• And more...

Install with:

pip install -r requirements.txt

The application has the following interfaces:

• Console
• External console via ZeroMQ (sort of working)
• Web interface

Start the downloader (it does not fork yet)
Automatically imports all streamers from the config file.

python3 Downloader.py

On the console you can use the following commands:

add <username> <site> - Add streamer to the list (also starts monitoring)
remove <username> [<site>] - Remove streamer from the list
start <username> [<site>] - Start monitoring streamer
start * - Start all
stop <username> [<site>] - Stop monitoring
stop * - stop all
status - Status display 
status2 - A slightly more readable status table
quit - Clean exit (Pressing CTRL-C also behaves like this)

For the username input, you usually have to enter the username as represented in the original URL of the room. Some sites are case-sensitive.

For the site input, you can use either the full or the short format of the site name. (And it is case-insensitive)

Add or remove a streamer to record (Also saves config file)

python3 Controller.py add <username> <website>
python3 Controller.py remove <username>

Start/stop recording streamers

python3 Controller.py <start|stop> <username>

List the streamers in the config

python3 Controller.py status

You can access the web interface on port 5000. If set password in parameters.py username is admin, password admin, empty password is also allowed. When you set the WEBSERVER_HOST it is also accesible to from other computers in the network

Pull from GitHub Container Registry:

docker pull ghcr.io/axsddlr/streamonitor:latest

Run with docker-compose (Recommended):

docker-compose up -d

Run with Docker:

docker run -d \
  -p 5000:5000 \
  -v $(pwd)/downloads:/app/downloads \
  -v $(pwd)/config.json:/app/config.json \
  -e STRMNTR_HOST=0.0.0.0 \
  ghcr.io/axsddlr/streamonitor:latest

The web interface will be available at http://localhost:5000

Configure via environment variables (see parameters.py for all options):

You can set some parameters in the parameters.py.

This project is licensed under the MIT License - see the LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.

• Inspired by Recordurbate
• Built with Python, Flask, and FFmpeg
• Community contributors and testers