Installation

JellyEmu depends on either File Transformation or Loom plugin to inject CSS and JavaScript into Jellyfin's web interface. Both JellyEmu and (Loom or File Transformation) plugins must be installed from the same plugin catalogue — install them in the order below.

Step 1 — Add the plugin catalogue

1. Open your Jellyfin dashboard

2. Go to Administration → Plugins → Repositories

3. Click New Repository and enter the following for the Name and URL:

   Jellyfin-PG
   

   https://raw.githubusercontent.com/Jellyfin-PG/Repository/refs/heads/main/manifest.json
   

4. Click Add

Step 2 — Install File Transformation or Loom

1. Go to Administration → Plugins → Catalogue
2. Find File Transformation or Loom and click Install
3. When prompted, confirm the installation

Step 3 — Install JellyEmu

1. Still in the Catalogue, find JellyEmu and click Install
2. When prompted, confirm the installation

Step 4 — Restart Jellyfin

Restart your Jellyfin server. Both plugins must be active at the same time — File Transformation handles the page injection, JellyEmu manages your roms.

1. Go to Administration → Dashboard
2. Click Restart
3. Confirm again by clicking Restart

Step 5 — Serve Jellyfin over HTTPS (Optional)

Using Jellyfin over HTTPS is strongly recommended for security if accessing it publicly. It is also required to enable multi-threading for demanding 3D systems like N64 and PSP.

Notes

Only File Transformation 3.0.0 is currently supported.