pystemon's Introduction

pystemon

Monitoring tool for PasteBin-alike sites written in Python

Copyleft AGPLv3 - Christophe Vandeplas - [email protected]
Feel free to use the code, but please share the changes you've made by doing Pull Requests!

Features:

search for regular expressions in pasties
flexible design, minimal effort to add another paste* site
use custom download functions for complex pastie sites
uses multiple threads per unique site to download the pastes
waits a random time (within a range) before downloading the latest pastes, time customizable per site
(optional) only trigger on X hits in the same pastie
(optional) exclude matching pasties if exclusion regex matches
(optional) allow additional email recipients per search pattern
(optional) uses random User-Agents
(optional) uses random proxies
removes a proxy if it is unreliable (fails 5 times)
(optional) compress saved files with Gzip. (no zip to limit external dependencies)
can run as daemon
multitude of outputs: file, email, sqlite, redis, mongodb, telegram

Python Dependencies

Python dependencies can be installed with: pip3 -r requirements.txt. Optional ones are:

PyMongo (For Mongodb support)
redis (For redis support)

Usage

Usage: pystemon.py [options]
Options:
      -h, --help            show this help message and exit  
      -c FILE, --config=FILE  
                            load configuration from file  
      -d, --daemon          runs in background as a daemon  
      -k, --kill            kill pystemon daemon
      -s, --stats           display statistics about the running threads (NOT IMPLEMENTED)    
      -v                    outputs more information  

Default configuration file: /etc/pystemon.yaml or pystemon.yaml in current directory

Recommend Projects