{"id":13631572,"url":"https://github.com/ozencb/yts-scraper","last_synced_at":"2025-04-17T22:31:14.624Z","repository":{"id":181039119,"uuid":"199201137","full_name":"ozencb/yts-scraper","owner":"ozencb","description":"Download .torrent files from YTS YIFY","archived":false,"fork":false,"pushed_at":"2020-07-18T07:10:34.000Z","size":799,"stargazers_count":51,"open_issues_count":5,"forks_count":21,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-08-01T22:49:03.000Z","etag":null,"topics":["downloader","python","scraper","torrent-files","yify","yts","yts-scraper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ozencb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-07-27T18:36:07.000Z","updated_at":"2024-05-24T17:14:09.000Z","dependencies_parsed_at":"2023-07-13T20:05:05.198Z","dependency_job_id":null,"html_url":"https://github.com/ozencb/yts-scraper","commit_stats":null,"previous_names":["ozencb/yts-scraper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozencb%2Fyts-scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozencb%2Fyts-scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozencb%2Fyts-scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozencb%2Fyts-scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ozencb","download_url":"https://codeload.github.com/ozencb/yts-scraper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223768521,"owners_count":17199356,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["downloader","python","scraper","torrent-files","yify","yts","yts-scraper"],"created_at":"2024-08-01T22:02:30.428Z","updated_at":"2024-11-08T23:31:01.617Z","avatar_url":"https://github.com/ozencb.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"[![GitHub Issues](https://img.shields.io/github/issues/Ozencb/yts-scraper)](https://github.com/Ozencb/yts-scraper/issues)\n[![Stars](https://img.shields.io/github/stars/Ozencb/yts-scraper)](https://github.com/Ozencb/yts-scraper)\n[![Forks](https://img.shields.io/github/forks/Ozencb/yts-scraper)](https://github.com/Ozencb/yts-scraper)\n[![MIT](https://img.shields.io/github/license/Ozencb/yts-scraper)](../master/LICENSE)\n\n# YTS Scraper\n\n![](Gif.gif)\n\n## Description\n**yts-scraper** is a command-line tool for downloading .torrent files from YTS. \nIt requires Python 3.0+.\nNote that this tool does not download the contents of a torrent file but downloads files with .torrent extension.\nYou should use a Torrent client to open these files. \n\n## Installation\nMake sure that setuptools is installed on your system before running setup.\n\nLinux:\n`sudo apt-get install python3-setuptools`\n\nWindows:\n`pip install setuptools`\n\nThen you can run `python setup.py install` to install YTS-Scraper on your system.\n\n## Usage\nTo start scraping run:\n\n`yts-scraper [OPTIONS]`\n\n\nFor 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\u003egenre structured subdirectories.\n\n`yts-scraper -q 1080p -g sci-fi -r 8 -c rating-genre -b`\n\n## Options\n\n| Commands                  | Description                                                                                                                                                           |\n|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n|`-h` or `--help`           |Prints help text. Also prints out all the available optional arguments.                                                                                                |\n|`-o` or `--output`         |Output directory                                                                                                                                                       |\n|`-b` or `--background`     |Append \"-b\" to download movie posters. This will pack .torrent file and the image together in a folder.                                                                |\n|`-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.      |\n|`--csv-only`               |Append --csv-only to log scraped data ONLY to a CSV file. With this argument torrent files will not be downloaded.                                                     |\n|`-i` or `--imdb-id`        |Append -i to append IMDb ID to filename.                                                                                                                               |\n|`-q` or `--quality`        |Video quality. Available options are: \"all\", \"720p\", \"1080p\", \"3d\"                                                                                                     |\n|`-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\".|\n|`-r` or `--rating`         |Minimum rating score. Enter an integer between 0 and 9.                                                                                                                |\n|`-s` or `--sort-by`        |Download order. Available options are: \"title\", \"year\", \"rating\", \"latest\", \"peers\", \"seeds\", \"download_count\", \"like_count\", \"date_added\"                             |\n|`-c` or `--categorize-by`  |Creates a folder structure. Available options are: \"rating\", \"genre\", \"rating-genre\", \"genre-rating\"                                                                   |\n|`-y` or `--year-limit`     |Filters out movies older than the given value.                                                                                                                         |\n|`-p` or `--page`           |Can be used to skip ahead an amount of pages.                                                                                                                          |\n\n## Disclaimer\nThis is a proof of concept tool built mainly to practice programming.\nThe tool downloads thousands of torrent files in bulk and some of these torrent files might be leading to copyrighted material.\nAlthough 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozencb%2Fyts-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fozencb%2Fyts-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozencb%2Fyts-scraper/lists"}