|PyPI| |TravisCI| |ReadTheDocs| |Coverage| |Codacy| |Downloads| |MIT|
This program can help you to remove your torrents. Now you don't need to worry about your disk space - according to your strategies, the program will check each torrent if it satisfies the remove condition; If so, delete it automatically.
This program supports qBittorrent/Transmission/μTorrent. If you like, star it 🌟 :)
Readme version in other languages:
.. |Codacy| image:: https://api.codacy.com/project/badge/Grade/6e5509ecb4714ed697c65f35d71cff65
.. |TravisCI| image:: https://www.travis-ci.org/jerrymakesjelly/autoremove-torrents.svg?branch=master
.. |ReadTheDocs| image:: https://readthedocs.org/projects/autoremove-torrents/badge/?version=latest
.. |Coverage| image:: https://api.codacy.com/project/badge/Coverage/6e5509ecb4714ed697c65f35d71cff65
:target: https://www.codacy.com/app/jerrymakesjelly/autoremove-torrents?utm_source=github.com&utm_medium=referral&utm_content=jerrymakesjelly/autoremove-torrents&utm_campaign=Badge_Coverage .. |MIT| image:: https://img.shields.io/badge/license-MIT-blue.svg :target: https://github.com/jerrymakesjelly/autoremove-torrents/blob/master/LICENSE .. |PyPI| image:: https://badge.fury.io/py/autoremove-torrents.svg :target: https://badge.fury.io/py/autoremove-torrents .. |Downloads| image:: https://img.shields.io/pypi/dm/autoremove-torrents.svg :target: https://pypi.org/project/autoremove-torrents/
That's all. It's a simple but smart program.
Installation +++++++++++++++++++ Install from pip ^^^^^^^^^^^^^^^^^ ::
pip install autoremove-torrents
Install from GitHub ^^^^^^^^^^^^^^^^^^^^ ::
git clone https://github.com/jerrymakesjelly/autoremove-torrents.git cd autoremove-torrents python3 setup.py install
Write your configuration file ++++++++++++++++++++++++++++++ In order to satisfactory your needs, you have to learn how to write a configuration file.
You can put the configuration file anywhere on your disk. The autoremove-torrents looks for
config.yml in the Shell's current working directory::
The grammar is quite easy, for example::
my_task: client: qbittorrent host: http://127.0.0.1 username: admin password: adminadmin strategies: my_strategy: categories: IPT remove: seeding_time > 1209600 or ratio > 1 delete_data: true
The program will delete those torrents whose categories are
IPT, seeding time is above 1209600 seconds or ratio is greater than 1. Read the
documents_ to learn more.
.. _documents: https://autoremove-torrents.readthedocs.io/en/latest
Run ++++ ::
If you just want to see which torrents can be removed but don't want to really remove them, use
--view command line argument.
If you want to check whether there is any torrent can be removed every 15 minutes, the crontab can help you. Look at the example::
And then, add a line at the end of the file (please confirm the path of the autoremove-torrents and your program)::
/15 * * * /usr/bin/autoremove-torrents --conf=/home/jerrymakesjelly/autoremove-torrents/config.yml --log=/home/jerrymakesjelly/autoremove-torrents/logs
--conf indicates the path to the configuration file.
--log argument specifies the path to store the log files (Must be existed).
Thu, 27 Aug 2020: Version 1.5.3.
/in host URL. (#81)
Fri, 27 Mar 2020: Version 1.5.2.
Sat, 29 Feb 2020: Version 1.5.1.
StalledDownloadin version 1.5.0. (#66)
Fri, 28 Feb 2020: Version 1.5.0.
max_downloadspeedand Minimum Upload Speed
max_average_downloadspeedand Minimum Average Upload Speed
max_seederand Minimum Number of Leechers
max_connected_seederand Minimum Number of Connected Leechers
last_activity, which removes torrents without upload or download speed for a period of time. (#1) (#9)
seed_sizein order to try to remove active or inactive torrents based on the last active time. (#9)
upload_ratio, which can remove torrents based on the ratio of uploaded size to torrent size. (#55)
Mon, 3 Feb 2020: Migrate documents to Read the Docs.
Sun, 26 Jan 2020: Version 1.4.9.
Tue, 7 Jan 2020: Version 1.4.8.
Mon, 6 Jan 2020: Version 1.4.7.
Tue, 17 Sep 2019: Version 1.4.6.
Thu, 6 Jun 2019: Version 1.4.5.
Wed, 22 May 2019: Version 1.4.4.
maximum_numberis used together with condtion
seeding_time, the task will fail. (#33)
filterhas only one line, now it is allowed to write down directly without using list.
Sun, 19 May 2019: Version 1.4.3.
Mon, 13 May 2019: Version 1.4.2.
orare guaranteed to be left-associative.
Mon, 6 May 2019: Version 1.4.1.
Mon, 6 May 2019: Updated Wiki.
removecondition into Simplified-Chinese Wiki.
Wed, 1 May 2019: Version 1.4.0.
ratiocondition will only remove those torrents whose status are seeding. We set this restriction to provide a method for users to avoid a torrent being removed by changing its status (e.g. pause seeding).
statusfilter, this restriction becomes unnecessary, and its behavior may be different from users expectation.
remove: ratio > 1.
remove: (seeding_time < 86400 and ratio > 1) or (seeding_time > 86400 and ratio > 3). Visit Wiki to learn more.
Wed, 17 Apr 2019: Version 1.3.0.
Issue #22 <https://github.com/jerrymakesjelly/autoremove-torrents/issues/22>_).
Issue #23 <https://github.com/jerrymakesjelly/autoremove-torrents/issues/23>_).
Issue #25 <https://github.com/jerrymakesjelly/autoremove-torrents/issues/25>_).
Mon, 10 Jan 2019: Version 1.2.5.
Issue #10 <https://github.com/jerrymakesjelly/autoremove-torrents/issues/10>_, thanks to @momokoo for the report and PR).
Issue #13 <https://github.com/jerrymakesjelly/autoremove-torrents/issues/13>_).
Thu, 31 May 2018: Version 1.2.4.
Wed, 30 May 2018: Version 1.2.3. Added new features.
Sun, 27 May 2018: Version 1.2.2. Added new features 😄
Sat, 26 May 2018: Version 1.2.1. Fixed issue in setup.py.
Sat, 26 May 2018: Version 1.2.0. Refactoring was completed, and was published to PyPI.
Mon, 14 May 2018: Version 1.1.0. Created setup.py.
You can now use the autoremove-torrents command directly instead of python3 main.py.
Wed, 28 Mar 2018: (Correct document) The delete_data field shouldn't be indented.
Thu, 22 Mar 2018: First version :bowtie:
Depend on users' feedback. If you have any problem, please submit
Click here_ to see the TODO List.
.. _Click here: https://github.com/jerrymakesjelly/autoremove-torrents/issues/63