owenvoke / yts
A full wrapper for the YTS API.
Fund package maintenance!
owenvoke
ecologi.com/owenvoke?gift-trees
Requires
- php: ^7.3|^8.0
- guzzlehttp/guzzle: ^6.5|^7.2
- illuminate/collections: ^8.40
Requires (Dev)
- pestphp/pest: ^1.1
- phpstan/phpstan: ^0.12.85
- symfony/var-dumper: ^5.1
README
A full wrapper for the YTS API.
About YTS
YIFY Torrents or YTS is a peer-to-peer release group known for distributing large numbers of movies as free downloads through BitTorrent. YIFY releases were characterised through their HD video quality in a small file size, which attracted many downloaders.
Install
Via Composer
$ composer require owenvoke/yts
Usage
List Movies
Returns a Collection instance containing Movie instances.
Movies::list([ 'quality' => Movies::QUALITY_ALL, // A quality constant 'query_term' => 0, // A query string, or 0 to ignore 'page' => 1, // An integer page number 'minimum_rating' => 0, // The minimum movie rating 'genre' => '', // A string containing the genre 'sort_by' => 'date-added', // The sort-by order 'order_by' => 'desc', // The direction to order by 'with_rt_ratings' => false, // Returns the list with Rotten Tomatoes ratings ]);
Movie Details
Returns a Movie instance.
Movies::details([ 'movie_id' => null, // The ID of the movie to retrieve 'with_images' => false, // Return with image URLs 'with_cast' => false, // Return with information about the cast ]);
Movie Suggestions
Returns a Collection instance containing 0 to 4 Movie instances.
Movies::suggestions([ 'movie_id' => null, // The ID of the movie to retrieve suggestions for ]);
Change log
Please see CHANGELOG for more information on what has changed recently.
Testing
$ composer test
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email security@voke.dev instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
Treeware
You're free to use this package, but if it makes it to your production environment you are required to buy the world a tree.
It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you support this package and contribute to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
You can buy trees here.
Read more about Treeware at treeware.earth.