Repolode
Submit
LLukas22

LLukas22/Jellyswarrm

A reverse proxy that combines multiple Jellyfin media servers into one unified library and interface.

View on GitHub
Stars
964
Forks
48
Open issues
39
Last commit
4 hours ago

What is it?

Jellyswarrm sits in front of several Jellyfin servers and presents them as a single Jellyfin server to client apps. Libraries from different locations can be browsed together, and Next Up and Recently Added lists are merged across all connected servers.

Playback goes directly from the original server rather than through Jellyswarrm, so transcoding and streaming load stay where the media lives. Users on different servers can be linked through user mapping, and users can be synced across federated servers. A web UI at /ui handles setup, server management and mappings, and the bundled Jellyfin web client is served from the same address.

The project is written in Rust, ships as Docker images, and is still in early development. Quick Connect, websocket support for SyncPlay, audio streaming and automatic bitrate adjustment are listed as in progress.

Key features

  • 01Browse libraries from multiple Jellyfin servers in one interface.
  • 02Stream playback directly from the original server.
  • 03Link user accounts across servers through user mapping.
  • 04Merge Next Up and Recently Added lists across servers.
  • 05Works with existing Jellyfin clients because it presents as a standard server.
  • 06Deploy with Docker and manage servers through a web UI.

Use cases

  • Combining media libraries spread across home and friends' servers.
  • Giving a household one Jellyfin entry point when content lives on several machines.
  • Connecting Jellyfin servers on different networks without mounting remote storage over SMB.

Quick start

  1. 1

    Start Jellyswarrm with Docker Compose using the provided docker-compose.yml

    docker compose up -d
  2. 2

    Open the Web UI at /ui on port 3000 and log in with the credentials you set

Things to know

  • Still in early development, and some features are incomplete or missing.
  • QuickConnect, websocket support and SyncPlay are unfinished or unreliable.
  • Not every Jellyfin client has been tested, so some may have issues.
  • Licensed under GPL-2.0, a copyleft license.

In collections

Home media serversSelf-hosted appsStreaming tools

Topics

#jellyfin#media-server#reverse-proxy#self-hosted#streaming#rust#docker#media

FAQ

What is Jellyswarrm?
A reverse proxy that combines multiple Jellyfin media servers into one unified library and interface. Jellyswarrm sits in front of several Jellyfin servers and presents them as a single Jellyfin server to client apps. Libraries from different locations can be browsed together, and Next Up and Recently Added lists are merged across all connected servers.
Is Jellyswarrm free to use? What license does it have?
Jellyswarrm is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is Jellyswarrm still maintained?
Actively maintained. The last commit to Jellyswarrm was on Nov 7, 2026.
What can I use Jellyswarrm for?
Combining media libraries spread across home and friends' servers. Giving a household one Jellyfin entry point when content lives on several machines. Connecting Jellyfin servers on different networks without mounting remote storage over SMB.
How do I install Jellyswarrm?
Start Jellyswarrm with Docker Compose using the provided docker-compose.yml: docker compose up -d Open the Web UI at /ui on port 3000 and log in with the credentials you set
Where can I get Jellyswarrm?
The source code and installation instructions are on GitHub: https://github.com/LLukas22/Jellyswarrm

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects