Skip to content

Latest commit

 

History

History
106 lines (85 loc) · 4.6 KB

README.md

File metadata and controls

106 lines (85 loc) · 4.6 KB
Raw

StreaMonitor

A Python3 application for monitoring and saving (mostly adult) live streams from various websites.

Inspired by Recordurbate

Supported sites

Site name Abbreviation Aliases Quirks Selectable resolution
Bongacams BC Yes
Cam4 C4 Yes
Cams.com CC Currently only 360p
CamSoda CS Yes
Chaturbate CB Yes
Dreamcam VR DCVR No
Flirt4Free F4F Yes
MyFreeCams MFC Yes
SexChat.hu SCHU use the id as username No
StreaMate SM PornHubLive, PepperCams,... Yes
StripChat SC XHamsterLive,... Yes
StripChat VR SCVR for VR videos No
XLoveCam XLC No

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.

Requirements

  • Python 3
    • Install packages listed in requirements.txt with pip.
  • FFmpeg

Usage

The application has the following interfaces:

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

Starting and console

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)

"Remote" controller

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

Web interface

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

Docker support

You can run this application in docker. I prefer docker-compose so I included an example docker-compose.yml file that you can use. Simply start it in the folder with docker-compose up.

Configuration

You can set some parameters in the parameters.py.

Disclaimer

This program is only a proof of concept and education project, I don't encourage anybody to use it.
Most (if not every) streamers disallow recording their shows. Please respect their wish.
If you don't, and you record them despite this request, please don't ever publish or share any recordings.
If you either record or share the recorded shows, you might be legally punished.
Also, please don't use this tool for monetization in any way.