Skip to main content

Easy and automated tool for torrent downloading

Project description

auto_py_torrent
###############

**auto_py_torrent** is an automated tool for download files by obtaining torrents or magnets that are in different provided pages that the user can choose.

Its goal is to make it easier for users to find the files they want and download them instantly.
  
An ``auto_py_torrent`` command is provided in which the user can currently choose between two modes, ``best_rated`` and ``list`` mode, then it selects one of the torrent tracking pages for multimedia content and finally enter the text of what you want to download.


.. contents::

.. section-numbering::

Main features
=============

* Simple and easy search, for file downloads using torrent.
* Formatted and colorized terminal output.


Installation and an usage example.
==================================

First, check your python3 version.
----------------------------------

.. code-block:: bash

$ python3 --version

Upgrade it as you wish.


Install ``python3-pip``:
------------------------

``Mac``
~~~~~~~
.. code-block:: bash

$ brew install python3

``Linux``
~~~~~~~~
Using the package manager with different linux distributions:

.. code-block:: bash

# Ubuntu/Debian.
$ sudo apt-get update
$ sudo apt-get install -y python3-pip

.. code-block:: bash

# Fedora, CentOS, RHEL, …
$ sudo dnf install python3-pip

.. code-block:: bash

# Arch Linux
$ pacman -S python3-pip


``Windows``
~~~~~~~~~~~

If ``C:\path\to\python\Scripts\pip3`` is not there remite to:

* `<https://www.python.org/downloads/windows/>`_
for Windows download.


Install virtualenv if necessary and activate it.
------------------------------------------------

.. code-block:: bash

$ sudo pip3 install virtualenv
$ cd
$ virtualenv venv_auto_py
$ cd venv_auto_py
$ source bin/activate


Install auto_py_torrent and get an example!
-------------------------------------------

.. code-block:: bash

# With venv activated:
$ pip3 install auto_py_torrent

#Without:
$ sudo pip3 install auto_py_torrent

# Example!
$ auto_py_torrent 1 0 "The simpsons"


Usage
=====
.. code-block:: bash

$ auto_py_torrent MODE SELECTED_PAGE STRING_TO_SEARCH


See also ``auto_py_torrent --help``.


Examples
--------

Using ``best_rated`` mode with ``torrent_project`` page:

.. code-block:: bash

$ auto_py_torrent 0 0 "The simpsons"


Using ``list`` mode with ``the pirate bay`` page:

.. code-block:: bash

$ auto_py_torrent 1 1 "The simpsons"


Meta
====

Dependencies
------------

**auto_py_torrent** uses this incredibles libraries:

* `BeautifulSoup <https://www.crummy.com/software/BeautifulSoup//>`_
— Python library for pulling data out of HTML and XML files.
* `Requests <http://docs.python-requests.org/en/master/>`_
— Requests is an elegant and simple HTTP library for Python, built for human beings.
* `Tabulate <https://bitbucket.org/astanin/python-tabulate>`_
— Python library for tabular data print in Python, a library and a command-line utility.
* `Coloredlogs <https://pypi.python.org/pypi/coloredlogs/>`_
— Python package that enables colored terminal output for Python’s logging module.
* `lxml <http://lxml.de/>`_
— Python library for processing XML and HTML in the Python language.


Release History
---------------

See `HISTORY <https://github.com/ocslegna/auto_py_torrent/blob/master/HISTORY.rst>`_.


Licence
-------

MIT: `LICENSE <https://github.com/ocslegna/auto_py_torrent/blob/master/LICENSE>`_.


Author
-------

`Gabriel Scotillo`_ (`@gabrielscotillo`_)


Package index
-------------

`<https://pypi.python.org/pypi/auto-py-torrent>`_.


.. _Gabriel Scotillo: https://ocslegna.herokuapp.com
.. _@gabrielscotillo: https://twitter.com/gabrielscotillo


.. :changelog:

Release History
---------------

Development
+++++++++++

1.0.4 (2017-07-29)
++++++++++++++++++

* Improve README.

**Improvements**

- Provide a better README.


1.0.3 (2017-07-28)
++++++++++++++++++

* Minor.

**Bugfixes**

- Fix the select index of provided list.


1.0.2 (2017-07-28)
++++++++++++++++++

* pip3 install integration.

**Improvements**

- Provide install with pip3: ``sudo pip3 install auto_py_torrent``.


1.0.0 (2017-07-28)
++++++++++++++++++

* First launch! Gone live.

**Improvements**

- ``auto_py_torrent`` runs best_rated and list mode.
- 5 different sites to search.
- Now you can repeat searches and downloads until you get tired.
- Can back to menu while searching.
- No need of double quotes with ['B', 'b'] options to search.
- Minor improvements.

**Bugfixes**

- Fix poor decision making after found content.
- Handle bad requests.


0.0.2 (2017-07-26)
++++++++++++++++++

* First alpha tests.

**Improvements**

- ``auto_py_torrent`` runs best_rated mode.

**Bugfixes**

- Resolve bad domain paths, fix parser, fix init class function, change main function.


0.0.1 (2017-07-23)
++++++++++++++++++

* First pre-alpha tests.

**Improvements**

- ``auto_py_torrent`` has now all scheduled torrent sites.

**Bugfixes**

- Resolve content for BeautifulSoup instantiation from requests.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for auto-py-torrent, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size auto_py_torrent-1.0.4-py3-none-any.whl (12.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size auto_py_torrent-1.0.4.tar.gz (9.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page