Use app deep links
Open screens, search, choose a profile and start playback with deep links and their optional parameters.
Last reviewed:
On this page
Deep links are URLs starting with jellytv:// that open the installed JellyTV app from a link or a shortcut. The formats below are supported. Replace the values in braces with your identifiers and numbers, without keeping the braces.
Install JellyTV on the target device and configure the relevant services. Direct playback requires an authenticated server profile and access to the media. TMDB resolution uses Seerr metadata to find a matching item in the library; if no match is found, JellyTV opens the Seerr catalog. Configure Seerr for these TMDB links.
Navigation
Open JellyTV
jellytv://openOpens the JellyTV app without selecting a specific screen.
Open the library
jellytv://libraryOpens the library. If library tabs are unavailable for the active profile, JellyTV returns to Home.
Open search
jellytv://searchOpens Search. Add q to prefill a search term. The query is retained through startup and profile selection. If Search is hidden for the active profile, JellyTV returns to Home.
Search for a titleRequires 1.3.17 or later
jellytv://search?q=Blueyjellytv://search?q=Star%20WarsChoose a saved profileRequires 1.3.17 or later
jellytv://profile?name=EnfantsSelects an existing profile on the connected server by username or display name, ignoring letter case. Existing PIN protection still applies. With only one saved profile, the link has no effect.
Open downloads
jellytv://downloadsOpens offline downloads on iPhone and iPad to find downloaded content and downloads in progress.
Details
Open details using a server item ID
jellytv://media/{id}Opens the media detail page without starting playback. Replace {id} with the media item ID from your server, which is different from its TMDB ID. Follow the steps below to find it in Jellyfin. Use a profile connected to the same server with access to the media.
- Open your Jellyfin server’s web interface in a browser and sign in.
- Open the detail page of the movie or episode you want to open. For an episode, open its individual page, not the series or season page.
- In the browser address bar, find the id= parameter. Copy only its value, up to the next & or the end of the URL. Do not copy id= or the serverId parameter: serverId identifies the server, not the media item.
- Paste this ID after jellytv://media/ and use a JellyTV profile connected to the same server.
Illustrative example: for a Jellyfin URL ending in /web/#/details?id=0123456789abcdef0123456789abcdef&serverId=my-server, use jellytv://media/0123456789abcdef0123456789abcdef. The URL portion before id= may vary between Jellyfin versions.
Open a movie
jellytv://movie/{tmdbId}Replace {tmdbId} with the movie’s numeric TMDB ID. JellyTV looks for the corresponding movie and opens its detail page without starting playback. Example: jellytv://movie/550.
Open a series
jellytv://tv/{tmdbId}Replace {tmdbId} with the series’ numeric TMDB ID. JellyTV looks for the corresponding series and opens its detail page without starting playback. Example: jellytv://tv/1399.
Open an episode
jellytv://tv/{tmdbId}/season/{s}/episode/{e}Use the TMDB ID of the series, not an episode ID. Replace {s} with the season number and {e} with the episode number. JellyTV opens the matching episode’s detail page without starting playback. Example: jellytv://tv/1399/season/1/episode/1.
Open a playlist
jellytv://playlist/{id}Opens a server playlist. Replace {id} with the playlist ID, not the ID of an item it contains. You can find it in the id= parameter of the playlist detail page URL in Jellyfin. The active profile must be connected to the relevant server and have access to that playlist.
Open a collection
jellytv://collection/{tmdbId}Opens a movie collection in the Seerr catalog. Replace {tmdbId} with the numeric TMDB collection ID, not a movie ID or a local Jellyfin collection ID. A Seerr connection is required.
Playback
Play media directly
jellytv://play/{id}Replace {id} with the media item ID from your server. This link starts playback directly instead of opening the detail page. A server item ID is not a TMDB ID and belongs to the server that provides the media. To find this ID in Jellyfin, follow the steps in “Open details using a server item ID” above.
Start position and tracksRequires 1.3.17 or later
- start — Start position in seconds, zero or greater. Use start=60 for one minute; decimal values such as start=1.5 are accepted.
- audio — Audio language code, for example fr for French. Uppercase codes such as FR are also accepted.
- subtitle — Subtitle language code, for example en for English. Use off to disable subtitles.
jellytv://play/ITEM_ID?start=60&audio=fr&subtitle=enStarts at one minute, with French audio and English subtitles. When several tracks match a language, JellyTV chooses the default track, then the first match. If the language is unavailable, the player keeps its usual selection. Language selection does not distinguish commentary or forced tracks. Explicit track choices use the server stream rather than an automatically selected downloaded copy.
Choose the profile and playRequires 1.3.17 or later
jellytv://play/ITEM_ID?profile=Enfants&subtitle=offjellytv://play/ITEM_ID?userId=USER_ID&start=60Use either profile (saved username or display name) or userId (saved server user ID), never both. Selection happens before playback and preserves the other options through startup and the profile picker. PIN authorization still applies.
An unknown or ambiguous profile leaves the enabled multi-profile picker available. If a known profile was requested and you choose a different one, that playback request is cancelled.
Resume watching
jellytv://resumeStarts the first item in Continue Watching at its saved position. This link does not let you choose a title and starts nothing if the list is empty. The server profile must be signed in and have access to the media.
Support
Open support
jellytv://supportOpens support on iPhone and iPad. If you are not signed in to your JellyTV account, the app opens My Account first so you can sign in.
Open ticketsRequires 1.3.18 or later
jellytv://ticketsOpens Issues and requests on iPhone, iPad, Apple TV and Mac (Designed for iPad). No parameters are required. Viewing tickets does not require signing in; creating a ticket or interacting requires a JellyTV account.