PHPackages martincamen/laravel-jellyseerr - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. martincamen/laravel-jellyseerr ActiveLibrary[API Development](/categories/api) martincamen/laravel-jellyseerr ============================== Laravel integration for Jellyseerr PHP SDK 0.1.0(3mo ago)00MITPHPPHP ^8.3 Since Jan 21Pushed 3mo agoCompare [ Source](https://github.com/MartinCamen/laravel-jellyseerr)[ Packagist](https://packagist.org/packages/martincamen/laravel-jellyseerr)[ Docs](https://github.com/martincamen/laravel-jellyseerr)[ RSS](/packages/martincamen-laravel-jellyseerr/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (11)Versions (2)Used By (0) Laravel Jellyseerr ================== [](#laravel-jellyseerr) Laravel integration for the [Jellyseerr PHP SDK](https://github.com/martincamen/jellyseerr-php), providing a seamless experience for interacting with Jellyseerr using unified domain models from [php-arr-core](https://github.com/martincamen/php-arr-core). Important This project is still being developed and breaking changes might occur even between patch versions. The aim is to follow semantic versioning as soon as possible. Ecosystem --------- [](#ecosystem) PackageDescription[radarr-php](https://github.com/martincamen/radarr-php)PHP SDK for Radarr[sonarr-php](https://github.com/martincamen/sonarr-php)PHP SDK for Sonarr[jellyseerr-php](https://github.com/martincamen/jellyseerr-php)PHP SDK for Jellyseerr[laravel-radarr](https://github.com/martincamen/laravel-radarr)Laravel integration for Radarr[laravel-sonarr](https://github.com/martincamen/laravel-sonarr)Laravel integration for Sonarr[laravel-jellyseerr](https://github.com/martincamen/laravel-jellyseerr)Laravel integration for JellyseerrFeatures -------- [](#features) - Unified API using canonical domain models from `php-arr-core` - Type-safe interactions with Jellyseerr - Laravel facade with full IDE autocompletion - Testing utilities for mocking responses - Automatic service discovery via Laravel's package auto-discovery Requirements ------------ [](#requirements) - PHP 8.3+ - Laravel 10.0+, 11.0+ or 12.0+ Installation ------------ [](#installation) ``` composer require martincamen/laravel-jellyseerr ``` The package will auto-register its service provider in Laravel. Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --provider="MartinCamen\LaravelJellyseerr\JellyseerrServiceProvider" ``` Add the following environment variables to your `.env` file: ``` JELLYSEERR_HOST=localhost JELLYSEERR_PORT=5055 JELLYSEERR_API_KEY=your-api-key JELLYSEERR_USE_HTTPS=false JELLYSEERR_TIMEOUT=30 JELLYSEERR_URL_BASE= ``` ### Configuration Options [](#configuration-options) OptionDescriptionDefault`JELLYSEERR_HOST`Hostname or IP address of your Jellyseerr server`localhost``JELLYSEERR_PORT`Port number for your Jellyseerr server`5055``JELLYSEERR_API_KEY`Your Jellyseerr API key (Settings > General > API Key)-`JELLYSEERR_USE_HTTPS`Use HTTPS for connections`false``JELLYSEERR_TIMEOUT`Request timeout in seconds`30``JELLYSEERR_URL_BASE`URL base for reverse proxy subpaths (e.g., `/jellyseerr`)-Usage ----- [](#usage) ### Using the Facade [](#using-the-facade) The `Jellyseerr` facade provides access to the SDK client via an action-based API: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; // Get all media requests $requests = Jellyseerr::requests()->all(); // Get a specific request by ID $request = Jellyseerr::requests()->find(1); // Search for media $results = Jellyseerr::search()->search('Breaking Bad'); // Get system information $status = Jellyseerr::system()->status(); ``` ### Dependency Injection [](#dependency-injection) You can also inject `Jellyseerr` directly: ``` use MartinCamen\Jellyseerr\Jellyseerr; class RequestController { public function __construct(private Jellyseerr $jellyseerr) {} public function index() { return view('requests.index', ['requests' => $this->jellyseerr->requests()->all()]); } } ``` Working with Requests --------------------- [](#working-with-requests) The `requests()` method provides access to media request management: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; use MartinCamen\Jellyseerr\Data\Responses\RequestPage; use MartinCamen\Jellyseerr\Data\Responses\MediaRequest; // Get all requests (paginated) /** @var RequestPage $requestPage */ $requestPage = Jellyseerr::requests()->all(); foreach ($requestPage as $request) { echo $request->id; echo $request->status->value; } // Get a specific request $request = Jellyseerr::requests()->find(1); // Get request counts $count = Jellyseerr::requests()->count(); echo "Pending: {$count->pending}"; echo "Approved: {$count->approved}"; // Create a movie request $request = Jellyseerr::requests()->movie(550); // TMDB ID // Create a series request with specific seasons $request = Jellyseerr::requests()->series(1396, [1, 2]); // TMDB ID, seasons // Approve a request $request = Jellyseerr::requests()->approve(1); // Decline a request $request = Jellyseerr::requests()->decline(1); // Retry a failed request $request = Jellyseerr::requests()->retry(1); // Delete a request Jellyseerr::requests()->delete(1); ``` Working with Movies ------------------- [](#working-with-movies) The `movies()` method provides access to movie details via TMDB: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; use MartinCamen\Jellyseerr\Data\Responses\MovieDetails; // Get movie details by TMDB ID $movie = Jellyseerr::movies()->find(550); echo $movie->title; echo $movie->overview; // Get movie recommendations $recommendations = Jellyseerr::movies()->recommendations(550); // Get similar movies $similar = Jellyseerr::movies()->similar(550); ``` Working with Series ------------------- [](#working-with-series) The `series()` method provides access to TV series details via TMDB: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; use MartinCamen\Jellyseerr\Data\Responses\SeriesDetails; // Get series details by TMDB ID $series = Jellyseerr::series()->find(1396); echo $series->name; echo $series->overview; // Get series recommendations $recommendations = Jellyseerr::series()->recommendations(1396); // Get similar series $similar = Jellyseerr::series()->similar(1396); // Get season details $season = Jellyseerr::series()->season(1396, 1); ``` Searching Media --------------- [](#searching-media) The `search()` method provides search and discovery functionality: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; use MartinCamen\Jellyseerr\Data\Responses\SearchPage; // Search for any media $results = Jellyseerr::search()->search('Breaking Bad'); foreach ($results as $result) { echo $result->title ?? $result->name; echo $result->mediaType; } // Discover movies $movies = Jellyseerr::search()->discoverMovies(); // Discover series $series = Jellyseerr::search()->discoverSeries(); // Get trending media $trending = Jellyseerr::search()->trending(); // Get upcoming movies $upcoming = Jellyseerr::search()->upcoming(); ``` Working with Users ------------------ [](#working-with-users) The `users()` method provides access to user management: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; use MartinCamen\Jellyseerr\Data\Responses\UserPage; use MartinCamen\Jellyseerr\Data\Responses\User; // Get all users /** @var UserPage $users */ $users = Jellyseerr::users()->all(); foreach ($users as $user) { echo $user->displayName; echo $user->email; } // Get a specific user $user = Jellyseerr::users()->find(1); // Get the current authenticated user $me = Jellyseerr::users()->me(); // Get a user's requests $requests = Jellyseerr::users()->requests(1); ``` System ------ [](#system) ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; // Get system status $status = Jellyseerr::system()->status(); echo $status->version; // Get appdata information $appdata = Jellyseerr::system()->appdata(); // Get public settings $settings = Jellyseerr::system()->publicSettings(); ``` Response Types -------------- [](#response-types) All responses use typed DTOs from the SDK: TypeDescription`RequestPage`Paginated media requests`MediaRequest`Individual media request`RequestCount`Request count statistics`MovieDetails`Movie details from TMDB`SeriesDetails`TV series details from TMDB`SearchPage`Paginated search results`UserPage`Paginated users`User`Individual user`SystemSummary`System status informationTesting ------- [](#testing) ### Using the Fake [](#using-the-fake) The package provides `JellyseerrFake` for testing: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; class RequestTest extends TestCase { public function testDisplaysRequests(): void { // Create a fake instance $fake = Jellyseerr::fake(); // Make request $response = $this->get('/requests'); // Assert the method was called $fake->assertCalled('requests'); $response->assertOk(); } public function testSearchesMedia(): void { $fake = Jellyseerr::fake(); // Make request that calls search()->search() $this->get('/search?q=test'); // Assert called $fake->assertCalled('search'); } public function testNothingWasCalled(): void { $fake = Jellyseerr::fake(); // No API calls made $this->get('/about'); $fake->assertNothingCalled(); } } ``` ### Assertion Methods [](#assertion-methods) The fake provides several assertion methods: ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; $fake = Jellyseerr::fake(); // Assert a method was called $fake->assertCalled('requests'); // Assert a method was not called $fake->assertNotCalled('movies'); // Assert a method was called a specific number of times $fake->assertCalledTimes('requests', 3); // Assert nothing was called $fake->assertNothingCalled(); // Get all recorded calls $calls = $fake->getCalls(); ``` Example: Building a Request Dashboard ------------------------------------- [](#example-building-a-request-dashboard) ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; class DashboardController extends Controller { public function index() { // Get system status $status = Jellyseerr::system()->status(); // Get request counts $counts = Jellyseerr::requests()->count(); // Get recent requests $requests = Jellyseerr::requests()->all(); // Get trending media for suggestions $trending = Jellyseerr::search()->trending(); return view('dashboard', [ 'version' => $status->version, 'pendingCount' => $counts->pending, 'approvedCount' => $counts->approved, 'requests' => $requests, 'trending' => $trending, ]); } } ``` Error Handling -------------- [](#error-handling) ``` use MartinCamen\LaravelJellyseerr\Facades\Jellyseerr; use MartinCamen\ArrCore\Exceptions\AuthenticationException; use MartinCamen\ArrCore\Exceptions\ConnectionException; use MartinCamen\ArrCore\Exceptions\NotFoundException; try { $request = Jellyseerr::requests()->find(999); } catch (AuthenticationException $e) { // Invalid API key return back()->with('error', 'Invalid Jellyseerr API key'); } catch (NotFoundException $e) { // Request not found abort(404, 'Request not found'); } catch (ConnectionException $e) { // Connection error logger()->error('Could not connect to Jellyseerr: ' . $e->getMessage()); return back()->with('error', 'Jellyseerr server unavailable'); } ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. Credits ------- [](#credits) Built on top of the [Jellyseerr PHP SDK](https://github.com/martincamen/jellyseerr-php) and [php-arr-core](https://github.com/martincamen/php-arr-core). ### Health Score 32 — LowBetter than 72% of packages Maintenance79 Regular maintenance activity Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 111d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8720813?v=4)[Martin Camen](/maintainers/MartinCamen)[@MartinCamen](https://github.com/MartinCamen) --- Top Contributors [![MartinCamen](https://avatars.githubusercontent.com/u/8720813?v=4)](https://github.com/MartinCamen "MartinCamen (1 commits)") --- Tags apilaravelsdkrequestsjellyseerrmedia-serveroverseerr ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/martincamen-laravel-jellyseerr/health.svg) ``` [![Health](https://phpackages.com/badges/martincamen-laravel-jellyseerr/health.svg)](https://phpackages.com/packages/martincamen-laravel-jellyseerr) ``` ### Alternatives [resend/resend-laravel Resend for Laravel 1191.4M6](/packages/resend-resend-laravel)[missael-anda/laravel-whatsapp A Whatsapp Business Cloud API wrapper for Laravel. 677.5k](/packages/missael-anda-laravel-whatsapp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)