owenvoke / yts

A full wrapper for the YTS API.

YTS

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 [email protected] instead of using the issue tracker.

Credits

• Owen Voke
• All Contributors

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.

yts's Issues

Update to use Spatie's DTO package

Description

Provide a detailed description of the change or addition you are proposing.

Possible implementation

Not obligatory, but suggest an idea for implementing addition or change.

Use mocking for tests to prevent issues with flaky API calls

Description

Provide a detailed description of the change or addition you are proposing.

Possible implementation

Not obligatory, but suggest an idea for implementing addition or change.