https://github.com/werwolfby/monitorrent
Automatic torrents downloader
https://github.com/werwolfby/monitorrent
hdclub kinozal lostfilm nnmclub qbittorrent rutor rutracker torrent torrent-downloader torrents transmission utorrent
Last synced: 3 months ago
JSON representation
Automatic torrents downloader
- Host: GitHub
- URL: https://github.com/werwolfby/monitorrent
- Owner: werwolfby
- License: wtfpl
- Created: 2015-07-17T17:41:35.000Z (about 10 years ago)
- Default Branch: develop
- Last Pushed: 2024-07-17T20:03:57.000Z (about 1 year ago)
- Last Synced: 2024-08-07T18:43:21.976Z (about 1 year ago)
- Topics: hdclub, kinozal, lostfilm, nnmclub, qbittorrent, rutor, rutracker, torrent, torrent-downloader, torrents, transmission, utorrent
- Language: Python
- Homepage:
- Size: 9.99 MB
- Stars: 508
- Watchers: 45
- Forks: 71
- Open Issues: 94
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# monitorrent
[](https://travis-ci.org/werwolfby/monitorrent)
[](https://ci.appveyor.com/project/werwolfby/monitorrent)
[](https://coveralls.io/github/werwolfby/monitorrent?branch=develop)
[](https://codecov.io/github/werwolfby/monitorrent?branch=develop)
Join discussion at:
[](https://gitter.im/werwolfby/monitorrent?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## Support on Beerpay
Hey dude! Help me out for a couple of :beers:!
[](https://money.yandex.ru/to/410012638435097)
This app can watch for torrent updates
### Supported trackers:
- support www.lostfilm.tv tracking over parse topic page with topic quality support (new design support)
- support www.rutor.org topic tracking
- support www.free-torrents.org topic tracking
- support www.rutracker.org topic tracking
- support www.tapochek.net topic tracking
- support www.unionpeer.org topic tracking
- support [nnmclub.to](http://nnmclub.to) topic tracking
- support [tr.anidub.com](http://tr.anidub.com) topic tracking with topic quality support
- support [kinozal.tv](http://kinozal.tv) topic tracking
- support [hdclub.org](http://hdclub.org) topic tracking
- support [anilibria.tv](https://www.anilibria.tv) topic tracking
### Supported torrent clients:
- support download torrent files to specified folder (downloader plugin)
- support **transmission** over transmission-rpc
- support **deluge** over deluge-rpc
- support **uTorrent** over uTorrent web api
- support **qbittorrent** over webui api
### Supported notification services:
- support notifications over [telegram.org](https://telegram.org/) ([Russian instructions](https://github.com/werwolfby/monitorrent/wiki/FAQ))
- support notifications over [pushover.net](https://pushover.net)
- support notifications over **email**
- support notifications over [pushbullet.com](https://www.pushbullet.com)
- support notifications over [pushall.ru](https://pushall.ru)
## Installation:
### Docker
Multiplatform image (`arm64` and `amd64` (`arm` is not supported anymore, until playwright will support it)):
[](https://hub.docker.com/r/werwolfby/monitorrent/)
[](https://hub.docker.com/r/werwolfby/monitorrent/)
[](https://hub.docker.com/r/werwolfby/monitorrent/)
[https://hub.docker.com/r/werwolfby/monitorrent/](https://hub.docker.com/r/werwolfby/monitorrent/)
#### How to run docker?
Monitorrent expose 6687 tcp port. And has database to store all current settings and info about monitorrent tracker topics.
To store this database outside of container it has to be mounted to file outside monitorrent:
```bash
touch /path/to/monitorrent.db
docker run -d \
--name monitorrent \
-p 6687:6687 \
-v /path/to/monitorrent.db:/var/www/monitorrent/monitorrent.db werwolfby/alpine-monitorrent
```
Where `/path/to/monitorrent.db` is path to stored monitorrent database file (it has to be absolute or use `pwd` macros in docker command).
For ARM version please use `werwolfby/armhf-alpine-monitorrent`.
### Windows Installer:
https://github.com/werwolfby/monitorrent/releases/download/1.4.0/MonitorrentInstaller-1.4.0.exe
### Manual Install
Requirements:
- Python 3.9+ and pip
Download latest build: https://github.com/werwolfby/monitorrent/releases/download/1.4.0/monitorrent-1.4.0.zip
Extract into **monitorent** folder
* pip install -r requirements.txt
* playwright --with-deps install firefox
* python server.py
This will start webserver on port 6687
Open in browser
http://localhost:6687
Default password is **monitorrent**. Don't forget to change in settings tab or disable authentication at all
#### Note for python 2.7
Monitorrent can run on Python 2.7, but because of unicode processing in it, [there are](https://github.com/werwolfby/monitorrent/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3A%22python%202%22%20label%3A%22wontfix%22%20) plenty of issues with russian symbols in urls, pathes and credentials. Some of this issues are part of libraries that Monitorrent uses, so it can't be fixed on our side.
We will continue to support main functionallity on Python 2.7, but 'ascii' encoding issues will not be fixed in most cases.
### Manual Install from sources (development mode)
Requirements:
- Python 2.7 or 3.x, and pip
- NodeJS 4.x
Download this repo:
* git clone https://github.com/werwolfby/monitorrent.git
* cd monitorrent
To get monitorrent up and running execute following commands:
* pip install -r requirements.txt
* npm install
* gulp
* python server.py
This will start webserver on port 6687
Open in browser
http://localhost:6687
Default password is **monitorrent**. Don't forget to change in settings tab or disable authentication at all
### Command Line Interface
|`config.py` |Argument |Environment Variable |Default |Description |
|------------|------------|------------------------|-------------------|------------------------------------------------|
|`debug` |`--debug` |`MONITORRENT_DEBUG` |`False` |Run in debug mode. Secret key is always the same|
|`ip` |`--ip` |`MONITORRENT_IP` |`0.0.0.0` |Bind interface |
|`port` |`--port` |`MONITORRENT_PORT` |`6687` |Port for server |
|`db-path` |`--db-path` |`MONITORRENT_DB_PATH` |`monitorrent.db` |Path to SQL lite database |
| |`--config` | |`config.py` |Path to config file |
> NOTE: Environment Variables overrides config data, Command Line arguments overrides Environment Variables
> NOTE: config.py is regular python file with variables and values:
> `debug = True`, `ip = '127.0.0.1''`
## Screenshots:
### Main page
### Settings
### lostfilm.tv quality settings
### Torrent Clients
### Transmission connection settings
### Add new topic
