YTS Scraper
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.