Mediarium

Movies, TV, music and books. One app, on your own server.

Mediarium finds what you want, downloads it, names it properly and files it. It replaces Radarr, Sonarr, Lidarr, Readarr, Prowlarr, SABnzbd and your torrent client.

Install in five minutes Star on GitHub

  • Version 3.7.3
  • Free, AGPL-3.0
  • No ads. Anonymous numbers only if you say yes
  • Runs in Docker
The Mediarium dashboard: a greeting, what is downloading, and a card for each kind of media.

You used to need eight apps.

RadarrMoviesSonarrTV showsLidarrMusicReadarrBooksProwlarrIndexersSABnzbdUsenet downloadsqBittorrentTorrentsBazarrSubtitles
Mediarium

8 apps to look after · one login · one settings page

From “I want that” to “it’s on the TV”

  1. Find it

    Browse what's popular or new, or take suggestions from your library. Pick a quality and press Add.

    Discover: rows of popular and new movies on a phone
  2. Get it

    Usenet and torrents are built in. Torrents can run through a built-in WireGuard VPN.

    Activity: what is downloading now and what is waiting on a phone
  3. Keep it tidy

    Files get the names you like and the right folder. A better release later replaces the old one.

    The library with a status on every poster on a phone
  4. Watch it

    Plex, Jellyfin, Emby and Silo hear about it when it's ready, and every title gets a Watch button.

    The dashboard with what was just added on a phone
Discover: rows of popular and new moviesActivity: what is downloading now and what is waitingThe library with a status on every posterThe dashboard with what was just added
Added to your libraryDownloading 63%Renamed and filedReady in Jellyfin

A shape and a colour for everything you collect.

Each kind of media has its own look, so you always know where you are.

Ticket posters

Pick the quality. Better releases replace the file later.

  • Does what Radarr does
  • A second 4K copy if you like
  • Custom formats, TRaSH profiles

Seasons, anime

Daily shows, anime and double episodes land on the right episode.

  • Does what Sonarr does
  • Seasons or single episodes
  • Calendar of what airs next

Follow an artist

Follow an artist and new albums turn up by themselves.

  • Does what Lidarr does
  • Playlists and synced lyrics
  • Lossy or lossless

Read in browser

Find them, file them, read them in the built-in reader.

  • Does what Readarr does
  • EPUB and Kindle files
  • OPDS and Kobo sync

Listen anywhere

Chapters, speed and a sleep timer in the built-in player.

  • Picks up where you stopped
  • 30-second skips
  • Works with Audiobookshelf
In your library: a solid card Wanted, still looking: dashed Downloading right now: a live line

See what happens after you press Add.

From search result to tidy file, with nothing for you to do. This is an animation, not a real download.

  1. Find
  2. Download
  3. Repair and unpack
  4. Name and file
  5. Tell your server

Searching your 6 indexers

41 releases found, 9 fit your profile

The best one is 2160p WEB-DL, 18.2 GB

Downloading

k3Jd9vQx2LmPz.part01.rar

48 MB/s from Usenet. Downloads go one at a time by default.

Repairing and unpacking

The PAR2 files check out, nothing is missing

k3Jd9vQx2LmPz.mkvNight.Harbour.2021.2160p.WEB-DL.mkv

Files posted with random names get their real names back.

Naming and filing

/movies/Night Harbour (2021)/

Night Harbour (2021) [2160p].mkv

Night Harbour (2021) [2160p].en.srt

Telling your media server

Jellyfin is scanning the folder.

Night Harbour is readyWatch

Everything it needs is already inside.

No separate downloader and nothing to wire together. Here's what people ask about most.

Downloads

Usenet and torrents, built in

Add your Usenet provider and indexers and you're set. Downloads repair, unpack and file themselves.

Usenet48 MB/s
Torrentvia VPN
Waiting3 in line

VPN

A WireGuard VPN, built in

Torrents can run through it with no extra container permissions. If it stops working they wait, and an optional kill switch keeps them off without a VPN.

Your server The swarm WireGuard + kill switch

Quality

Best first, good enough after

Pick the qualities you accept and where to stop. Custom formats, TRaSH profiles, and a wait for the protocol you prefer, as in Radarr and Sonarr.

2160p Remuxfirst
1080p Blu-raythen
720plast

Subtitles

Subtitles for your exact file

OpenSubtitles, SubDL and sites like subs.ro through add-ons, with a timing fix for ones that drift.

00:12:04,300 → 00:12:06,900Ai grijă, e mai aproape decât crezi. Made for your file

Languages

In your own language

Six app languages, about thirty for titles and posters. Folders keep the English name.

  • English
  • Español
  • Deutsch
  • Français
  • Português (Brasil)
  • Português (Portugal)

Calendar

What's coming out, and what's missing

Releases for everything you follow, by day. Missing titles are marked, and it can feed your phone's calendar.

The calendar for October with releases on each day.

Import lists

Lists that add titles for you

Lists on Trakt, TMDB, MDBList and IMDb, a Letterboxd export and your Plex watchlist add movies and shows on a schedule, with the quality and folder you pick.

Media servers

Tells your server when it's ready

Every title gets a Watch button. Books go to Audiobookshelf and Kavita.

PlexJellyfinEmbySiloAudiobookshelfKavita

Family and friends

Give everyone their own login, then decide what it can do

Make an account for each person at home or each friend you share with. You choose, person by person, what they may do, so a child can look around and a friend can only ask.

  • Add titles themselves, or send a request you approve or decline
  • Pick releases, search, retry, get subtitles, play, read and listen, each on or off
  • Only the kinds of media you allow: movies, TV, music or books
  • Request limits per day or per week
  • A Viewer role that can only look, and read-only API keys for dashboards
  • Single sign-on, LDAP or passkeys, if you want them
MMayaBasic user
  • Add titles themselves
  • Pick releases
  • Search now
  • Retry downloads
  • Get subtitles
  • Play, read and listen
  • Movies
  • TV shows
  • Music
  • Books
Night Harbour (2021)asked by Maya
ApproveDecline

3 of 5 requests left this week

Download clients

Already run qBittorrent? Keep using it

Torrents can go to qBittorrent, RDT-Client or Decypharr, or to Real-Debrid or TorBox. The Download clients tab in Activity shows what each downloader is doing.

  • Built-in Usenetdownloading
  • Built-in torrentsvia VPN
  • qBittorrentseeding
  • Real-Debrididle

Read and listen

A reader and a player inside

Ebooks open in the built-in reader, audiobooks and music in the player. Your place is saved on every device. E-readers can use OPDS or Kobo sync.

The ebook library: book covers with a status on each.

And a few more things

  • Requests for the familyPeople you invite ask for titles; you set how many they get, and 4K requests wait for your OK.
  • Single sign-on, LDAP, passkeysSign in with Authelia, Authentik or Google, with your directory, or with a passkey. A local login always stays as a way back in.
  • Custom formats and TRaSH profilesScore releases by HDR, codec, group or streaming service, with the TRaSH Guides profiles ready in a couple of clicks.
  • Wait for the protocol you preferHold a torrent back for a while to see whether the Usenet release turns up first, or the other way round.
  • Import listsTrakt, TMDB, MDBList, IMDb, Letterboxd and your Plex watchlist add movies and shows by themselves.
  • IRC announceGrab a release the moment a tracker announces it in IRC, before the usual search would find it.
  • Messages where you areEmail, Discord, Telegram, Matrix, Home Assistant and push to your phone when something is added, downloaded or goes wrong.
  • Real-Debrid and TorBoxSend torrents to a debrid service. With TorBox, releases it already has are tried first, so they are ready in seconds.
  • A Download clients tabOne page for the built-in downloaders and the clients you already run, with speed and Pause all for each.
  • Artwork and info filesKodi, Jellyfin and Emby get posters, backgrounds, logos and .nfo files written next to your media.
  • Skip bad releasesWhole discs, 3D, upscaled copies, burned-in subtitles and releases with programs inside are left out for you.
  • A script after every importRun your own script when a file is imported, with the title and the path handed to it.
  • Works with Overseerr and HomepageApps made for Radarr, Sonarr and Lidarr can connect to Mediarium as if it were one of them.
  • Prometheus metricsA /metrics page for Grafana: the queue, disk space, library sizes and how each indexer is doing.
  • Run under a sub-pathServe it at yourdomain.com/mediarium behind your reverse proxy, with no extra setup in the app.
  • Cloud backupsA copy of each nightly backup in S3-style storage or WebDAV, locked with your own passphrase before it leaves.
  • Statistics over timeCharts of how big the library is, what was added and how much was downloaded each day.
  • Signed updatesThe project signs every release and Mediarium refuses anything else. It can install one overnight when nothing is downloading.

Everything Mediarium does

Bring the library you have.

Mediarium reads your current apps and copies the setup over, so you don't type it all again. Your files stay where they are.

  • Read only. It asks the other apps for their settings. Nothing in them is changed, so you can run both side by side.
  • What comes over: movies and shows with their monitoring, quality profiles, indexers, Usenet servers, requests and subtitle languages.
  • No files are moved. Titles already on disk are found where they are.
  • A plain folder works too. Point it at a folder of movies or shows and it adds what's there.

Read the move guide

It can read from

  • Radarr
  • Sonarr
  • Prowlarr
  • SABnzbd
  • NZBGet
  • Jackett
  • NZBHydra2
  • Overseerr
  • Jellyseerr
  • Ombi
  • Bazarr
  • Medusa
  • SickChill

And it tells your media server

  • Plex
  • Jellyfin
  • Emby
  • Silo
  • Audiobookshelf
  • Kavita

Names and logos belong to their owners. Mediarium is not affiliated with any of them.

Check on it from the couch.

The whole app works on a phone. Add it to your home screen and it opens like an app.

Mediarium on a phone: the dashboard.
Mediarium on a phone: Discover.
Mediarium on a phone: the library.

It stays on your server.

Everything lives in one folder you can back up. Mediarium only talks to services you set up, plus a few public ones for posters and details.

  • 0accounts to create with us
  • 0ads, anywhere
  • 0bytes of usage data sent
Your Usenet provideryou choose it Your indexersyou add them Your server/config /dataMediarium TMDBtitles and posters GitHubupdate check, can be off our servers

Install it in five minutes.

One Docker image runs everywhere: ghcr.io/rdborg/mediarium, for 64-bit Intel/AMD and ARM. It is also on Docker Hub as rdborg/mediarium.

  1. Save the compose file. Change the folders on the left of each colon to yours.
  2. Run it. One command does the rest.
  3. Open it. Go to http://your-server:8264 and follow the setup.

Keep downloads and media in one folder. Never open port 8264 to the internet: use HTTPS and a reverse proxy (see the security guide).

docker-compose.yml
services:
  mediarium:
    image: ghcr.io/rdborg/mediarium:latest
    container_name: mediarium
    restart: unless-stopped
    security_opt:
      - no-new-privileges:true
    ports:
      - "8264:8264"
      - "58264:58264/tcp"
      - "58264:58264/udp"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DOWNLOADS_DIR=/data/downloads
      - MOVIES_DIR=/data/movies
      - TV_DIR=/data/tv
    volumes:
      - ./config:/config
      - ./data:/data

Then run docker compose up -d.

It runs on

  • Docker
  • Raspberry Pi
  • Synology
  • QNAP
  • Unraid
  • TrueNAS
  • Portainer
  • CasaOS
  • OpenMediaVault
  • Nextcloud
  • Kodi

Built with the people who use it.

Most of what's new came from a comment or an issue, and every idea is credited by name.

  • Reddit (16)
  • GitHub (25)
  • u/FilesFromTheVoidRedditKeeping quality settings simple: bad releases skipped out of the box, custom formats tucked away as an advanced option
  • u/EmbyverseRedditCustom formats with TRaSH Guides import +1 more: Keeping two qualities of one title (second copies)
  • u/joshpenningtonRedditMore than one folder per kind of media, chosen per title
  • @12nick12GitHubPassword-protected downloads +1 more: Sending a download to the front of the line, picking several downloads at once and starting newer releases first (#49, #51)
  • @JisevindGitHubKeeping the original file names
  • @FACM-PFGitHubEuropean Portuguese
  • u/Dry_Register_5812RedditCinema recordings named HDCAMRip and the like slipping past a WEB-DL only profile
  • u/troelsdkRedditFinding that the Sonarr-compatible episode list ignored the season asked for
  • u/SarShaRedditMore subtitle sources, including non-English ones
  • @mirisbowringGitHubReplacing a movie with a smaller version (discussion #65) +1 more: Only taking releases in the languages you list, and searching under another title such as the German one
  • @blind0wlGitHubA Download clients tab with what the clients are doing and controls for them +1 more: Choosing when to give up on a stalled torrent
  • @Bayharbourbutcher1GitHubSending the seeding rules to an outside torrent client
  • u/WiwerRedditRepairing releases posted with random file names +2 more: Checking folders can be written before a download starts; Searching right away after a title is moved to a higher quality profile
  • u/DerGlordonRedditA custom format condition for the original language of a film or show
  • @userkbmsr-pngGitHubSubtitles from subs.ro and other sites, through subtitle add-ons
  • @franciscojnnetoGitHubPages for cast and crew (discussion #72)
  • @jdamnerGitHubKeeping settings in one file for git or a script
  • @thegliffyGitHubAudiobooks that are on Audible but not on Open Library, with a pull request (#42, #41) +2 more: Books with accents in their names; Running the books that were not found again
  • u/Wolfspider_79RedditStop monitoring once a title is complete +1 more: A live connection with Seerr
  • u/evilpigRedditReal-Debrid and TorBox
  • @xrandallx1GitHubSilo as a media server +1 more: IPTorrents as a built-in site
  • @DFlexyGitHubBrazilian Portuguese +3 more: Adding your own indexer definition files; Waiting longer for slow Prowlarr feeds; The import explanations in your language
  • @nexus4004GitHubSubtitles in Croatian and Serbian, rescanning a movie that has no file, Library entries in the left menu and the busy message as a small notice (all from the website idea form) +3 more: Showing the folder where a title's files go; Pointing a title at a file or folder you renamed (same issue, reported by dxtrlws); Preferring a season pack once a season has ended, and importing your Simkl lists (both from the website idea form)
  • @SanketBaraiyaGitHubImporting anime that is numbered by TheTVDB seasons, such as One Piece +1 more: Knaben as a built-in site
  • u/barnetfanRedditTelling apart two artists with the same name when scanning your music folder
  • u/paulojfRedditReal-Debrid and TorBox
  • @varnakubeGitHubPicking a book by hand when it is not found during an import +1 more: Setting a book's cover by hand
  • @TryToTiltGitHubRepairing Usenet releases that come with only PAR2 recovery volumes +1 more: A Posters and a Backdrops view in the calendar, a speed schedule, a weekly summary and a page-turn animation in the reader, all ideas from their fork
  • @MrBandittGitHubEnded and continuing shows, file sizes for episodes and seasons, an age column in the release list, a TMDB link on title pages and sorting titles without "The"
  • @Apostol6GitHubToloka.to as a built-in site +4 more: Prowlarr feed addresses that end in /api; Sites that write dates their own way; Torrent sites from Prowlarr added as Usenet; Metadata in other languages
  • u/ShuanYuRedditDifferent quality profiles for movies and TV
  • u/Big_Dragonfruit9719RedditTorrents with UDP trackers crashing while the VPN is on
  • @mshollyGitHubAdding a media server by pasting the address from the browser
  • @anguyen1776GitHubDifferent quality profiles for movies and TV, and finding missing episodes one season at a time +1 more: The report that led to spacing out searches on one indexer
  • @spamoomGitHubSending indexer traffic through the VPN, with the code to do it (#63, pull request #62)
  • @goneturboGitHubWireGuard configs that name the server by host name, like Surfshark's
  • u/this_for_loonaRedditSending traffic through a SOCKS5 or HTTP proxy
  • u/12_nick_12RedditNever download season packs +2 more: A webhook for media servers without their own support; The Radarr, Sonarr and Lidarr-compatible API
  • @PauloJfGitHubThe WireGuard preshared key and pasting a whole config +3 more: QBittorrent-compatible download clients; Sorting and filtering the release lists, trailers in a pop-up, subtitles in the player and more detail on downloads; Kobo sync and an OPDS catalogue for books
  • @Hoopes80GitHubClearer errors when importing through an address behind Cloudflare +2 more: A Usenet indexer that turns Mediarium away with a Cloudflare page; Shows with an apostrophe in their name
  • @acortespr06GitHubTransmission as a download client

Questions people ask.

What is Mediarium, and how is it different from Radarr and Sonarr?

Mediarium finds, downloads, names and files your movies, TV, music, ebooks and audiobooks. Radarr, Sonarr, Lidarr, Readarr, Prowlarr, SABnzbd and a torrent client each do one part, and you wire them together. Mediarium does all of those jobs in one container, with one web page, one login and one backup. It can read your settings from the old apps, so you don't start from zero.

Do I still need Prowlarr, SABnzbd or qBittorrent?

No. Indexers, a Usenet downloader and a torrent client are built in. If you already run qBittorrent, RDT-Client or Decypharr, or use Real-Debrid or TorBox, Mediarium can send torrents there instead. Prowlarr and Jackett still work as sources of indexers if you like them.

Is it free and open source?

Yes. It's under the AGPL-3.0, with no ads and no paid version, and no usage numbers unless you choose to share them. The code is on GitHub.

Does it provide any content? Is it legal?

No. Mediarium doesn't host, store, index, upload, stream or provide any media, and it comes with no indexers or content sources. You add your own accounts, and you are responsible for what you download and for following the law where you live. It is meant for things you have the right to get, such as public-domain works, backups of media you own and freely licensed content. The legal notes say more. They are not legal advice.

Which Usenet providers and indexers work?

Any Usenet provider that gives you a normal server address and login, and any indexer that offers a Newznab API. Torrent sites work too, from a community list or through Torznab (from Prowlarr or Jackett, for example). Mediarium doesn't sell, recommend or earn money from any of them. There are no affiliate links.

Does it work with Plex, Jellyfin, Emby, Silo and Kodi?

Plex, Jellyfin, Emby and Silo are told to scan as soon as a download is ready, and every title gets a Watch button. Books go to Audiobookshelf and Kavita, and any other server can be told by a webhook. Kodi reads the NFO and artwork files Mediarium can write next to your videos, so point it at the same folders.

Can I keep my existing library, or move from Radarr and Sonarr?

Yes to both. Point Mediarium at your folders and it adds what is there without moving, renaming or deleting a file. Settings > System > Move from other apps reads your setup from Radarr, Sonarr, Prowlarr, SABnzbd and more. It only reads, so nothing in the other apps changes and you can run both side by side. See the move guide.

What does it run on?

Anything that runs Docker on 64-bit Linux, Intel/AMD or ARM: a regular server, Synology, QNAP, Unraid, TrueNAS SCALE, CasaOS or ZimaOS, OpenMediaVault, Portainer, or a Raspberry Pi 3, 4 or 5 with a 64-bit system. On a Windows PC or a Mac it runs in Docker Desktop, which is fine for trying it out. For a machine that runs day and night, a NAS or Linux server is better. Sharing Windows or Mac folders with Docker is slower and hardlinks may not work. See what runs where.

How much memory and disk space does it need?

The image is about 20 MB to download, and there is no published minimum. It runs on a Raspberry Pi, where unpacking big downloads is slow. Keep Mediarium's settings and your media on a proper disk, not an SD card. The optional Cloudflare helper in the -full image takes about 250 MB of memory. Most of your disk space will go to the media itself.

Can several people use it?

Yes. Everyone gets their own account, and you decide what each one can do: add titles themselves or send you a request to approve, pick releases, search, retry, get subtitles, play, and which kinds of media they can use. A Viewer account can only look. You can limit requests per day or week, and make read-only API keys for dashboards. See accounts.

Is there a mobile app?

There's no separate app. The whole site works on a phone, and you can add it to your home screen to open it like an app. Mediarium Books, the reader and audiobook player, installs on its own. Notifications can reach your phone from the browser. Phone apps made for Radarr and Sonarr, such as nzb360, LunaSea and Ruddarr, can connect too.

What about music, ebooks and audiobooks?

They work end to end once you switch them on under Media types. Ebooks open in the built-in reader and audiobooks in the player, and both remember your place. Music has a player with playlists and synced lyrics. E-readers can use the OPDS catalogue, and Kobo devices can sync (Kobo sync is new and has been tested with test files, not on a real Kobo yet).

Does it do subtitles?

Yes, once you switch them on. Mediarium looks on OpenSubtitles and SubDL in the languages you pick, and on other sites through add-ons. It prefers a subtitle made for your exact file, and it can shift one that is out of sync.

How does the VPN work?

A WireGuard client is built in for torrents. Paste the .conf file from your VPN provider and switch it on. Only torrent traffic goes through it. If the VPN stops working, torrents wait instead of connecting directly, and an optional kill switch stops them whenever no VPN is connected. It needs no extra container permissions.

How do updates and backups work?

Mediarium checks GitHub once a day and tells you when there is a new version. You update by pulling the new image, or with an Update now button for signed releases. A backup of your settings and database is saved every night, and you can download one any time or send copies to S3-style storage or WebDAV. Media files are never part of it.

What data does it send anywhere?

Nothing goes to us. Mediarium only contacts the services you set up, public sources such as TMDB for titles and posters, and GitHub once a day to look for a new version (you can switch that off). There are no accounts. If an administrator says Yes when the app asks, it sends one small anonymous message a day (a random ID, the version and rough device sizes; never names, titles or addresses), and the totals are public at mediarium.app/stats. Saying No sends nothing. This website counts visits with Google Analytics, but only if you accept.

Can I put it behind a reverse proxy, or under a sub-path?

Yes. Put it behind HTTPS and never open port 8264 to the internet. It can run under a path such as /mediarium with one setting, and it can take the sign-in from Authelia or Authentik. The security guide has the steps.

Which languages does it speak?

The screens come in English, Spanish, German, French, Brazilian Portuguese and European Portuguese. Titles, descriptions and posters can be in about thirty languages. Messages from the server itself stay in English for now.

How do I report a bug or ask for a feature?

Use the bug button at the bottom of the sidebar. It sends your note privately or opens a GitHub issue with everything filled in. You can also open an issue, or ask other users in the Reddit community. Ideas that make it in are credited by name.

How can I help?

Report what breaks, share ideas, test on a platform nobody has tried, or translate a language. Code is welcome too: the project follows a code of conduct and takes pull requests on GitHub. A coffee on Ko-fi helps pay for the website and the hours behind it.

Mediarium is free.

There are no ads and no paid version. If it saves you time, a coffee helps pay for the website and the hours spent keeping it working.

Buy a coffee

A note on use. Mediarium organises and automates. It doesn't host, index or supply any content. It's meant for material you have the legal right to get: your own backups, public-domain and freely licensed works, and content you're licensed to use. You are responsible for what you download and for following the law where you live.

Buy a coffee

Enjoying Mediarium?

It is free and made in spare time. A coffee helps keep it running.

Support on Ko-fi

No account needed. Opens Ko-fi in a new tab. Nothing loads from Ko-fi until you click.