# Media (Jellyfin and Plex)

> Play and control the movies and shows on your own Jellyfin or Plex server by voice, on the TV you name, with the Thalovant Media skill.

Source: https://docs.thalovant.com/concepts/media/

---
The **Thalovant Media** skill plays what is in your own [Jellyfin](https://jellyfin.org) or [Plex](https://plex.tv) library on a TV, from any [client](/concepts/clients/) of a hub. Say "Play Elf on the TV" and the skill finds Elf in your library, picks the screen, and tells you once the server reports the TV playing it. The video comes from your server to your TV, not through Thalovant.

  The skill talks to your server directly, with one household's address and token kept in its settings and shared by every device you list. Jellyfin can also go through [Home media](/music-and-home/home-media/), which keeps your server's address and token at home; Plex can't yet. Use the direct route only on a hub that belongs to one household. A public hub refuses these settings. Plex has been tested only against recorded answers, never a real Plex server.

## What You Can Say

| You want | Say |
| --- | --- |
| A movie or show | "Play Elf on the TV." "Watch The Matrix." "Play the movie Paddington in the bedroom." |
| A season or episode | "Play The Office season 2 episode 3 in the bedroom." "Play season 2 of The Office." "Play the next episode of The Office." |
| Something you didn't pick | "Play the latest episode of The Office." "Play a random movie." "Continue my movie." "Continue watching." |
| Control | "Pause the TV." "Resume the TV." "Stop the movie." "Skip 30 seconds." "Go back a minute." "Next episode." |
| Tracks | "Turn on the subtitles." "Subtitles in French." "Switch the audio to French." |
| Ask | "What am I watching?" "What's new on Jellyfin?" "Which TVs can I play on?" |

It speaks the same 65 language tags as the other Thalovant skills. The words are machine-translated and have not been reviewed by native speakers.

## Which Skill Answers

Several skills hear "play" and "pause". This one answers when you say a movie, show, episode or season, or a control word with a video in it ("pause the movie", "next episode"). When you only say "watch" or "on the TV", it answers if the title is in your library, and otherwise passes the sentence on, so "play jazz on the TV" still goes to the Music Assistant skill. "Turn off the TV" stays with the Home skill.

## Set It Up

1. **Create access on your server.** In Jellyfin, create a user just for voice, with the parental rating and library limits you want, and use that user's own access token. Don't use an administrator API key: it's server-wide and never expires until you delete it. In Plex, use a managed user's token, not your account's.
2. **Add the skill to your hub's runtime group** from the marketplace (see [Add a Skill to a Hub](/manage/add-a-skill-to-a-hub/)).
3. **Fill in its settings.** The server URL, the token (stored as a secret), the Jellyfin user if the server has more than one, a **Default TV**, and the devices that may use the skill in **Allowed devices**. Leave **Server** on its default to use every server you fill in: "What's new on Jellyfin?" asks each of them.
4. **Say "play" and a title with "on the TV".** If something is missing the skill says what: no server set up, server unreachable, token refused, no title by that name, no TV it can reach.

**Allowed devices is empty on purpose.** A public hub has strangers on it, and your server holds one token for everyone. With nothing listed, nobody can use the skill, and their sentences go on to the other skills. List one Thalovant device per line, by the name the console shows (`client-...`) or its ID. A device with a **Device TVs** entry, written `device=TV name`, counts as listed.

## Which TVs It Can Control

| Route | What the TV needs | What it can do |
| --- | --- | --- |
| Jellyfin | The Jellyfin app is open on it (Android TV, Fire TV, Apple TV, the web client, Kodi, a browser tab) | Play, pause, skip, tracks, next and previous episode, and the skill checks it is really playing |
| Plex | A Plex app that is set to "Advertise as player", on your server's network | The same. Not tested against a real Plex server yet. |

A Chromecast or smart TV with no Jellyfin or Plex app open isn't a player the skill can control. The skill has a route through Home Assistant for those, tested only against recorded answers, and the cloud skill settings don't ask for a Home Assistant address or token, so don't count on it.

## Reaching A Server On Your Home Network

The skill calls your server's address from the hub's runtime, so the runtime has to be able to reach it: the same network, a VPN, or a public HTTPS address behind a proxy. A hub in the cloud can't open `http://192.168.x.x:8096`. The Music Assistant bridge has no video counterpart yet, so the token is stored as a skill secret on the hub.

The skill refuses addresses that would send your token somewhere it shouldn't go (link-local and metadata addresses, cluster names, plain `http://` to a public address) and never follows a redirect. On a cloud hub, what the runtime can reach inside Thalovant's network is limited by the runtime's network policy, not by this skill. For a self-signed certificate on a home server turn off **Verify TLS certificate**.

## Limits

- Playing starts from the beginning. "Continue my movie" resumes what you left half-watched.
- Plex needs the token handed to the player in the request line, where the Plex server or a proxy in front of it may log it. That's how Plex works.
- The Jellyfin tests ran against a real server with an API key. A user's own token on a server with several users hasn't been run yet, and Plex has only been run against recorded answers.
- Subtitle and audio languages are matched by English name or the language's own name for about forty languages.
