2026-10-13 10:39:41 +02:00
2026-10-13 10:38:00 +02:00
2026-11-03 09:33:22 +01:00
2026-07-08 20:03:00 +02:00
2026-10-13 10:38:00 +02:00
2026-05-12 12:24:57 +02:00
2026-05-12 12:24:57 +02:00

OmniArr - Every Arr unified

Self-hosted media discovery and download management for Jellyfin users.

Screenshot 2026-10-13 at 09 45 47

OmniArr brings your favourite services together in one clean dashboard: browse your Jellyfin library, discover movies and series, follow upcoming releases, request downloads and monitor storage from a single place.

Docker image Docker pulls License

If OmniArr is useful to you, you can support its development on Ko-fi.

What you get

  • It connects with all your Jellyfin users, the login stays consistent.

  • Integration with Sonarr and Radarr to manage your library.

    Screenshot 2026-10-13 at 09 46 52 Screenshot 2026-10-13 at 10 43 21
  • A calendar tracking your new episodes and events.

    Screenshot 2026-10-13 at 09 46 05
  • Every discovery and search you may need.

    Screenshot 2026-10-13 at 09 47 49
  • A download manager to see what's cooking.

  • Per-profile control of which sections each person sees (see Profiles).

And many things more!

Install with Docker Compose

Create a directory for OmniArr and add this docker-compose.yml:

services:
  omniarr:
    image: wonderalice/omniarr:1.2.4
    container_name: omniarr
    restart: unless-stopped
    ports:
      - "8787:8787"
    environment:
      PORT: "8787"
      OMNIARR_DATA_DIR: /app/data
    volumes:
      - ${OMNIARR_DATA_DIR:-./data}:/app/data

Then start the container:

docker compose pull
docker compose up -d

Open http://localhost:8787 and create the master password during the first boot. Configure the Jellyfin, Sonarr, Radarr and qBittorrent connections from the Administration area.

The Compose file in this repository is ready to use as-is:

curl -O https://raw.githubusercontent.com/WonderAliceUwU/OmniArr/main/docker-compose.yml
docker compose up -d

Set OMNIARR_DATA_DIR to a host dataset when you want the data outside the current directory. For example, on TrueNAS:

export OMNIARR_DATA_DIR=/path/to/omniarr-data
docker compose up -d

The /app/data mount is required. It contains the encrypted application state, including the master-password verifier and saved integration settings. Removing the mount loses that state when the container is replaced.

Docker image tags

The current release is available as:

wonderalice/omniarr:1.2.4
wonderalice/omniarr:latest

Pin 1.2.4 in production for repeatable updates. Use latest only when you want Compose to follow the newest published image.

Build locally

To build and run your own image from source:

docker build -t omniarr:local .
docker run --rm -p 8787:8787 -v "$PWD/data:/app/data" omniarr:local

Local development

Requirements: Node.js 22 or newer and npm.

npm ci
npm run dev:all

The production build can be checked with:

npm run lint
npm run build

Profiles

Open Administration → Profiles to see every Jellyfin profile. Selecting one opens its settings:

  • Sections are on/off switches for Search, Upcoming, Downloads, Wishlist, K-Drama, Anime, Library and each network. Everything is on by default and Home is always available. A hidden section disappears from the menu and the server refuses its requests for that profile. The administrator always sees everything.
  • Libraries shows which Jellyfin libraries the profile can open. It is read from Jellyfin and cannot be changed here; manage it in Jellyfin.

Save with the check button of the Profiles card.

Upcoming and library access

Upcoming comes from Sonarr and Radarr, which know nothing about Jellyfin permissions. To keep each profile's calendar to what it can open, OmniArr asks Jellyfin for the libraries a profile cannot open and leaves out the releases that are stored in them.

Sonarr, Radarr and Jellyfin often mount the media folder under different paths (for example /shared/Library/Anime for Sonarr and /library/Anime for Jellyfin), so a release is matched to a library by the name of the library folder found in the series or movie path. Keep that folder name the same in all three apps. A release whose path does not contain the name of any library is shown to everyone, and if Jellyfin cannot be reached the calendar is not filtered.

Tests

npm test

The tests run against small stand-ins for Jellyfin, Sonarr and Radarr (server/test/mock-services.ts). To point a running OmniArr at them while developing, start them with node dist-server/server/test/mock-services.js after a build; it prints the three URLs, accepts any API key and offers a full profile and a limited one that cannot open Anime or Anime Movies.

Data and security

OmniArr keeps critical state under OMNIARR_DATA_DIR (by default /app/data inside the container). The encrypted store is written to /app/data/omniarr.secure.json.

Keep the data directory private, use a strong master password and provide the TMDb token through the Administration area. It is stored encrypted with the rest of the application configuration.

License

OmniArr is currently distributed as a private project. See the repository for the licensing status of your copy.

S
Description
No description provided
Readme
6.5 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 77.1%
CSS 22.6%
JavaScript 0.1%
Dockerfile 0.1%