Metadata-Version: 2.1
Name: tdpt
Version: 1.2
Summary: Torrent downloading progress on Telegram
Home-page: https://github.com/dolohow/tdpt
Author: dolohow
Author-email: lukasz@zarnowiecki.pl
License: UNKNOWN
Keywords: telegram bot transmission liveupdates torrents rtorrent torrent
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: python-telegram-bot (==12.6.1)
Requires-Dist: transmissionrpc (==0.11)

TDPT
====

Torrent downloading progress on Telegram

![Screencast](https://i.imgur.com/YV6LYCl.gif "Screencast")


## Features
* Support for two most popular torrent clients `Transmission` and `rTorrent`
* Multithreading, each downloading item is handled separately
* Running post download script in separate process
* Self-adjustment of `Telegram` bot limits based on number of torrents
  tracked
* Easy configuration
* Uploading new torrent - just send torrent file to chat


## Installation
You need Python 3 to run this program.

```
$ pip install --user tdpt
```

Create configuration file
```
$ cp tdpt.ini.template tdpt.ini
```
Edit it and save.


## FAQ

### `Transmission` already supports running script upon finishing download
Yes, that is true.  However the script that `transmission` will run will
be executed in the same thread.  That means any long running process
would freeze it for that amount of time which is highly undesirable.

### `tdpt` picks up new items so slow
Currently it fetches new items every 20 seconds, because this operation
can be quite expensive.  I might add option to specify this interval
based on your preferences.

### I am downloading 20 items and `tdpt` updates them very rarely
`Telegram` puts limit of how often bot can make request to one channel.
Currently the limit is 20 updates per minute.  `tdpt` makes time
adjustment based on number of torrents that it tracks to avoid hitting
limits.


