Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ozencb/yts-scraper

Download .torrent files from YTS YIFY
https://github.com/ozencb/yts-scraper

downloader python scraper torrent-files yify yts yts-scraper

Last synced: about 2 months ago
JSON representation

Download .torrent files from YTS YIFY

Awesome Lists containing this project

README 

        
[![GitHub Issues](https://img.shields.io/github/issues/Ozencb/yts-scraper)](https://github.com/Ozencb/yts-scraper/issues)

[![Stars](https://img.shields.io/github/stars/Ozencb/yts-scraper)](https://github.com/Ozencb/yts-scraper)

[![Forks](https://img.shields.io/github/forks/Ozencb/yts-scraper)](https://github.com/Ozencb/yts-scraper)

[![MIT](https://img.shields.io/github/license/Ozencb/yts-scraper)](../master/LICENSE)



# YTS Scraper



![](Gif.gif)



## Description

**yts-scraper** is a command-line tool for downloading .torrent files from YTS. 

It requires Python 3.0+.

Note that this tool does not download the contents of a torrent file but downloads files with .torrent extension.

You should use a Torrent client to open these files. 



## Installation

Make sure that setuptools is installed on your system before running setup.



Linux:

`sudo apt-get install python3-setuptools`



Windows:

`pip install setuptools`



Then you can run `python setup.py install` to install YTS-Scraper on your system.



## Usage

To start scraping run:



`yts-scraper [OPTIONS]`



For instance, this command downloads every 1080p sci-fi movie and their posters with an IMDb score of 8 or higher, and store them in rating>genre structured subdirectories.



`yts-scraper -q 1080p -g sci-fi -r 8 -c rating-genre -b`



## Options



| Commands                  | Description                                                                                                                                                           |

|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|

|`-h` or `--help`           |Prints help text. Also prints out all the available optional arguments.                                                                                                |

|`-o` or `--output`         |Output directory                                                                                                                                                       |

|`-b` or `--background`     |Append "-b" to download movie posters. This will pack .torrent file and the image together in a folder.                                                                |

|`-m` or `--multiprocess`   |Append -m to download using multiprocessor. This option makes the process significantly faster but is prone to raising flags and causing server to deny requests.      |

|`--csv-only`               |Append --csv-only to log scraped data ONLY to a CSV file. With this argument torrent files will not be downloaded.                                                     |

|`-i` or `--imdb-id`        |Append -i to append IMDb ID to filename.                                                                                                                               |

|`-q` or `--quality`        |Video quality. Available options are: "all", "720p", "1080p", "3d"                                                                                                     |

|`-g` or `--genre`          |Movie genre. Available options are: "all", "action", "adventure", "animation", "biography", "comedy", "crime", "documentary", "drama", "family", "fantasy", "film-noir", "game-show", "history", "horror", "music", "musical", "mystery", "news", "reality-tv", "romance", "sci-fi", "sport", "talk-show", "thriller", "war", "western".|

|`-r` or `--rating`         |Minimum rating score. Enter an integer between 0 and 9.                                                                                                                |

|`-s` or `--sort-by`        |Download order. Available options are: "title", "year", "rating", "latest", "peers", "seeds", "download_count", "like_count", "date_added"                             |

|`-c` or `--categorize-by`  |Creates a folder structure. Available options are: "rating", "genre", "rating-genre", "genre-rating"                                                                   |

|`-y` or `--year-limit`     |Filters out movies older than the given value.                                                                                                                         |

|`-p` or `--page`           |Can be used to skip ahead an amount of pages.                                                                                                                          |



## Disclaimer

This is a proof of concept tool built mainly to practice programming.

The tool downloads thousands of torrent files in bulk and some of these torrent files might be leading to copyrighted material.

Although the downloaded files are not the contents themselves, accessing or storing these files might still be illegal in some parts of the world. So, take great care when using this tool and make sure that it is legal.