Skip to main content
Version: Stable

Media Servers

Zaparoo Core can link to a Plex, Jellyfin, or RomM server and add its library to the media database. Plex and Jellyfin cards play movies, shows, and music on a player such as a TV app. RomM cards download a game to the device and launch it.

Link servers from the Core terminal UI:

  1. Open Settings > Media servers.
  2. Under the server's heading, fill in Server address if it needs one.
  3. Select Link Plex, Link Jellyfin, or Link RomM, and follow the steps on screen.
  4. Once it says the server is linked, update the media database to add the library.

Linking saves the server's token to the auth file and its address to the launcher's server_url.

Plex​

The Plex launchers run on Windows, Linux, SteamOS, Bazzite, ChimeraOS, LibreELEC, Batocera, Knulli, ROCKNIX, and AmberELEC. Media plays on a Plex player, not on the Core device itself.

To link, leave Server address blank to use the only server on your Plex account, or enter one. Select Link Plex, then enter the code it shows at plex.tv/link.

SystemLauncherPlays
MoviePlexMovieA movie
TVEpisodePlexTVEpisodeAn episode
TVShowPlexTVShowEvery episode of a show, in order
MusicTrackPlexSongA song
MusicAlbumPlexAlbumEvery track of an album, in order
MusicArtistPlexArtistEvery track of an artist

Core looks for players the server and your Plex account know, and Cast devices on the local network. The newer Plex apps for Android TV and Apple TV are only reachable through Cast. When only one player is found, Core uses it. With more than one, set which player to use.

Jellyfin​

The Jellyfin launchers run on the same platforms as Plex. Media plays on a Jellyfin app, not on the Core device itself.

To link:

  1. Turn on Quick Connect on the Jellyfin server, in its dashboard settings.
  2. Enter the server's address, like http://192.168.1.10:8096, without /web.
  3. Select Link Jellyfin.
  4. In a Jellyfin app that is signed in to that server, open Settings > Quick Connect and enter the code Core shows.
SystemLauncherPlays
MovieJellyfinMovieA movie
TVEpisodeJellyfinTVEpisodeAn episode
TVShowJellyfinTVShowEvery episode of a show, in order
MusicTrackJellyfinSongA song
MusicAlbumJellyfinAlbumEvery track of an album, in order
MusicArtistJellyfinArtistEvery track of an artist

Core plays on a Jellyfin app the server can remote control, so open the app on the TV or other player first. When only one is open, Core uses it. With more than one, set which player to use.

Choose a player​

Set client on the Plex or Jellyfin launcher group in the config file to pick a player by name:

[[launchers.default]]
launcher = "Plex"
client = "Living Room TV"

Plex matches the player's name, ignoring case. Jellyfin matches the device name, then the app name, then the device ID.

Cards for Plex and Jellyfin items also store the item's movie, TV, or music database IDs when the server has them, so a card keeps working after the server rebuilds its library.

Plex and Jellyfin media supports the toggle_pause, pause, resume, stop, fast_forward, rewind, next, and previous launcher controls.

RomM​

RomM works on every Core platform that launches games from files, including MiSTer. Its games are added to the media database under their usual systems, except games you already have locally.

To link, enter the address you open RomM at, like http://192.168.1.10:8080, then select Link RomM and approve the code in RomM's web interface. This needs RomM 5.0 or newer. For an older server, add a RomM API token to the auth file under the server's address:

auth.toml
["http://192.168.1.10:8080"]
bearer = "your-romm-token"

Then set the RomM launcher's server_url in the config file:

config.toml
[[launchers.default]]
launcher = "RomM"
server_url = "http://192.168.1.10:8080"

The first time a RomM game launches, Core downloads it into that system's game folder, then launches it with the system's normal launcher. Later launches use the downloaded file. Games made of several files are extracted into a folder named after the game. Core checks for free space before downloading.

While a RomM server is set, the romm scraper runs after each media database update and fills in details and artwork from RomM.