Jellyswarrm

Jellyswarrm is a reverse proxy that aggregates multiple Jellyfin servers into a single unified experience. It presents itself as a standard Jellyfin server so existing Jellyfin clients can browse and play media from multiple back-end servers without switching between them.

Key Features

• Unified library access: browse media from multiple Jellyfin servers in one combined view (Next Up, Recently Added, etc.).
• Direct playback: streams content directly from the origin server to preserve original transcoding and reduce proxy overhead.
• User mapping and federation: link and synchronize user accounts across connected Jellyfin servers for a consistent user experience.
• API compatibility: exposes the Jellyfin API surface so most existing Jellyfin apps and tools work with minimal changes.
• Embedded web UI: bundled management UI for adding servers, configuring user maps, and basic administration.
• Docker-friendly deployment: provided container image and docker-compose examples for easy installation.

Use Cases

• Consolidate personal media libraries hosted on multiple Jellyfin instances into a single client-visible server.
• Share and browse friends' Jellyfin libraries across networks without complex file sharing setups.
• Present a single Jellyfin endpoint for client devices while keeping media stored and served on multiple origin servers.

Limitations and Considerations

• Project is in early development; some features are incomplete or experimental.
• QuickConnect-style remote convenience is not yet implemented; login currently requires username and password.
• Websocket support is incomplete, which can affect real-time features like SyncPlay or live updates.
• Audio streaming and some client combinations are untested and may have issues in certain setups.
• Media management (adding/removing libraries) through the proxy is not implemented; library changes must be done on origin servers.

Jellyswarrm is useful for users who want to aggregate multiple Jellyfin instances under a single endpoint while preserving playback performance and original server responsibilities. It is focused on compatibility with existing Jellyfin clients and on simplifying multi-server browsing and user federation.