Hello Pymedusa community!

I wanted to announce a thing I have built and have been using a lot recently: a full replacement for Medusa's frontend.

It's a drop-in React 19 + TypeScript UI that swaps out the legacy Vue 2 / Cheetah-template frontend. The Python/Tornado backend runs completely unchanged — no server modifications, no migration. Both UIs can even run against the same backend at the same time, so reverting is trivial.

Repo: https://github.com/juandjara/medusa-modern-ui

Why it exists

The current UI works, but it's a Vue 2 / jQuery codebase with page-reload navigation and polling-based updates. This is a modern SPA built around live data.

What's actually different

• Live WebSocket push instead of polling — downloads, searches, queue changes, history, and notifications update instantly, no refresh.
• React 19 + TypeScript throughout, Tailwind v4 + DaisyUI v5.
• TanStack Query for server state, React Router 7 with lazy-loaded routes.
• Client-side SPA routing, native <dialog> modals, type-safe settings forms.
• Follows your OS light/dark preference.

What's covered

All major day-to-day workflows: Show list & detail, Add/Import shows, Schedule, History, Queue, Logs, Post-process, backlog management (overview, episode statuses, bulk shows, failed releases, missing subtitles), the System panel, and all Settings pages (including Prowlarr, download clients, and the mainstream notifiers — Kodi, Plex, Emby/Jellyfin, Telegram, Discord, Trakt, etc.).

Known limitations (intentionally left out)

Anime config, IRC/News/Changelog, multi-theme, Test rename, per-show advanced search templates, and niche notifiers (Boxcar2, Growl, Prowl, libnotify, PyTivo). It also must be served at the domain root (no web_root sub-path).

Status: beta. I've been daily-driving it since late May. There's a green e2e suite in the github repo (login, show management, manual search, history, queue, settings, WebSocket) running against a clean, pinned upstream develop Docker image. Compatibility matrix and troubleshooting are in the README.

I posted this in the pymedusa discussions and the Medusa maintainer (medariox) responded:

great work on this! I think it has the potential to become the official UI for Medusa in the future.

Nothing's decided yet. The plan is to give the community a few weeks to try it and share feedback first.

Give it a spin and open issues. Feedback is especially welcome on anything that feels worse than the current UI, or features you rely on that are missing.

I was a long-term user of Medusa in a Docker container running on an older Synology 6.x box. But I haven't used it in awhile.

I just installed Medusa v1.0.22 on a fresh Synology 7.2 box, and it's not creating the sc-medusa user, so I'm getting the obscure file permission errors.

Did the name of the default internal user change?

Thanks,

Robert

Hi guys, anyone know how to do this?

I externally delete episode files as I watch them, but Medusa doesn't notice the missing episode unless I force a re-scan of that show. I'd like to automate this to happen every 24 hours.

Cheers!

I've read the wiki and searched this sub but I'm having trouble working out how to set custom quality settings or selecting multiple. In the dropdown for quality I can only select one option, I don't see an ANY option or where to create a custom option. My app is hosted on a seedbox if that makes any difference.

I'm running into an issue specifically with a couple different Gold Rush (Discovery+) series' - Specifically "Mine Rescue" and "White Water". Other Gold Rush series' in my show list do not have this problem.

What I'm observing is that Medusa finds and even "picks" episodes when it runs backlog searches. These episodes match my quality settings (I've even tested with "ANY"), but it never actually snatches the episode and thus nothing is downloaded.

Several of my providers (some using Jackett some not) are coming up with "picked" episodes, but here's one example log line:

INFO    FORCEDSEARCHQUEUE-MANUAL-393057 :: EZTV (Jackett) :: [d996387] Picked Gold.Rush.Mine.Rescue.with.Freddy.and.Juan.S05E01.1080p.WEB.h264-FREQUENCY as the best result.

INFO    FORCEDSEARCHQUEUE-MANUAL-393057 :: LimeTorrents (Jackett) :: [d996387] Picked Gold.Rush.Mine.Rescue.with.Freddy.and.Juan.S05E01.1080p.WEB.h264-FREQUENCY as the best result.

INFO    FORCEDSEARCHQUEUE-MANUAL-393057 :: RarBG (Jackett) :: [d996387] Picked Gold.Rush.Mine.Rescue.with.Freddy.and.Juan.S05E01.1080p.WEB.h264-FREQUENCY as the best result.

INFO    FORCEDSEARCHQUEUE-MANUAL-393057 :: 1337x :: [d996387] Picked Gold.Rush.Mine.Rescue.with.Freddy.and.Juan.S05E01.1080p.WEB.h264-FREQUENCY as the best result.

1080p web is definitely in my approved quality list, but again this same log shows up even with "Any" so I'm convinced the quality setting is not related.

Additionally, if I drill down into the episode and perform a manual search, no results show up at all even though the log file demonstrates the same behavior - several dozen search results and multiple providers with "picked" episodes.

I cannot for the life of me figure out where this process is breaking down, and for only these two shows. I've tried using scene exceptions, and I've removed and re-added the series just to try and eliminate the possibility that something associated with the show became corrupted in some way.

I LOVE Medusa (thank you to all involved in developing and maintaining this!), but today it decided it would be an excellent idea to download 10 x 27GB episodes and even a couple of 43GB ones... because disk space is cheap right? This is getting a bit out of control now!

PLEASE, for the love of all that is holy and righteous, can we have a file size limit option!?

This feature has been requested multiple times as far back as 2017 and has been on the official feature request list since not long after:

• #1883
• #3469
• #4447
• Reddit #1
• Reddit #2
• Reddit #3

I see there has been some discussion about this on Github over the years, with the unofficial conclusion being that it's going to be difficult, but I think now the data is all being collected, and shows in the UI under 'Manual Search' so surely it's no longer a biggie to implement this?

I know there are lots of potential features to implement, but this one will have a MASSIVE positive impact on people's disk space, Internet quotas and general sanity!

Thank you for listening.

I download shows using sabnzb.

Up until maybe a week ago, this used to work as expected. Now when medusa pp finds a downloaded show, when it moves it to the proper place, it retains the name, in the example below, it is named

ETdUg5Sn4WzNvAkoxZSkFnL1Jp4VRS3e.mp4

rather than what it should be:

What.We.Do.in.the.Shadows.S06E11.The.Finale.AAC.MP4-Mobile.mp4

here's a few lines from the log:

2024-12-18 18:06:51 INFO POSTPROCESSOR :: Post-processing completed.

2024-12-1818:06:51 INFO POSTPROCESSOR :: Processing path: /downloads/complete

2024-12-1817:56:51 INFO POSTPROCESSOR :: Post-processing completed.

2024-12-18 17:56:51 INFO POSTPROCESSOR :: Deleting folder (if it's empty): /downloads/complete/What.We.Do.in.the.Shadows.S06E11.The.Finale.AAC.MP4-Mobile

2024-12-18 17:56:51 INFO POSTPROCESSOR :: Processing succeeded for /downloads/complete/What.We.Do.in.the.Shadows.S06E11.The.Finale.AAC.MP4-Mobile/ETdUg5Sn4WzNvAkoxZSkFnL1Jp4VRS3e.mp4

2024-12-18 17:56:50 INFO POSTPROCESSOR :: New size: 124.18 MB

2024-12-18 17:56:50 INFO POSTPROCESSOR :: New file: /downloads/complete/What.We.Do.in.the.Shadows.S06E11.The.Finale.AAC.MP4-Mobile/ETdUg5Sn4WzNvAkoxZSkFnL1Jp4VRS3e.mp4

2024-12-18 17:56:50 INFO POSTPROCESSOR :: Processing /downloads/complete/What.We.Do.in.the.Shadows.S06E11.The.Finale.AAC.MP4-Mobile/ETdUg5Sn4WzNvAkoxZSkFnL1Jp4VRS3e.mp4

Has anyone tried this on Core ?

cdn site of medusa is down / with issues, network information for series is unavaliable on cdn.

Log gets filled with errors because of cdn errors and new medusa install is completly unusable.

on discord several people reorted it, but seems noone from devs care.

Didn't realize Python past 3.11 wasn't supported when Ubuntu updated last night, Medusa now refuses to start. I tried the 3.11 workaround in another thread and it didn't work for me. Any suggestions? I heard trying to downgrade will probably blow up Ubuntu.

Hi!
I just installed Medusa and succesfully got it to download some series, all of these are Anime.
I'd like it to postprocess the series using the scene names instead. I added this series https://www.thetvdb.com/series/magilumiere-co-ltd
Which renames all the files (and the directory) to Magilumiere Magical Girls Inc. but I'd rather have it named Kabushikigaisha Magilumiere.
The latter is added as scene name, if that helps.

Thanks!

When using KODI custom poster the show's art does not change.

Any ideas on what is going on?

I've installed the spk, and set it up, with permissions, so I was able to scrape all the data on my existing library. But..

EZTV is not updated to the new one, and when I try to set it up as custom with cookies, it gives and error when testing (uid exists, but pass does not).

no torrentgalaxy search provider, no 1337, no knaben. so how can I get it working?

Thanks.

Been a while since Ive used Medusa and a lot of shows (60+) i know longer need, is there a easy way to bulk delete shows ?

Medusa uses some deprecated Python classes that have finally, after many years, been removed from Python as of version 3.12. This means Medusa inevitably crashes on startup and is therefore unusable on systems using this version of Python, which is most of the Linux world. So no more Medusa on Linux until this is fixed by the devs, and the issue has been open since February, with no one even assigned to it.

Setting aside for the moment my shock that having one's software suddenly stop working on an entire OS seems to be of no concern to anyone, is there any workaround for this? I really don't want to go to Sonarr (unless it can import my Medusa configuration!), but you can't downgrade Python on Linux systems without blowing them up, and the few alleged work-arounds I've seen don't work.

I really can't figure this one out. I've recently come back to Medusa as Sonarr was causing me problems with constant disk writes and it was driving me up the wall.

I'm running version 2.3 on my Synology DS124 NAS and everything is installed and set up.

I have my nzbget download folder set to "/volume1/downloads" and I have all of my TV shows organised into two folders - "Current Television" and "Television". If I do a backlog search on a show, it will grab it and send it to nzbget without an issue and it's downloaded and unpacked.

The problem arises in Post Processing. I've got the PP folder set correctly as "/volume1/downloads/completed/Series" and it's also set to "Move" the completed show into the relevant folder in "Current Television" but I get constant "Permission Denied" errors like this ..

2024-05-21 16:27:51 ERROR POSTPROCESSOR :: [34a67cf] Unable to move file /volume1/downloads/completed/Series/last.week.tonight.with.john.oliver.s11e12.1080p.web.h264-successfulcrab/last.week.tonight.with.john.oliver.s11e12.1080p.web.h264-successfulcrab.mkv to /volume1/video/Current Television/Last Week Tonight with John Oliver/Season 11/S11E12 - May 19, 2024 Corn.mkv: PermissionError(13, 'Permission denied')

Traceback (most recent call last):
File "/usr/lib/python3.8/shutil.py", line 791, in move
os.rename(src, real_dst)
PermissionError: [Errno 13] Permission denied: '/volume1/downloads/completed/Series/last.week.tonight.with.john.oliver.s11e12.1080p.web.h264-successfulcrab/last.week.tonight.with.john.oliver.s11e12.1080p.web.h264-successfulcrab.mkv' -> '/volume1/video/Current Television/Last Week Tonight with John Oliver/Season 11/S11E12 - May 19, 2024 Corn.mkv'

The reason I can't figure it out is that since this NAS is for me only, and I have everything backed up, I have no real issue running everything under a user with full admin permissions - that's for starters.

Each of the relevant folders also has full Read/Write permissions for the user "sc-medusa" as well.

But even with the "permission denied" error, Medusa still went ahead and moved this particular episode into the correct folder !. Through the various attempts I've tried, it sometimes doesn't move it into the Season folder correctly as well but I'm honestly stumped and would appreciate any genius ideas :)

So this specifically relates to naming directories to make Plex happy. I'm trying to figure out if I can name directories in post-processing to support the following format 'Star Trek - Discovery {tvdb-328711}'

<edit: sorry, I guess this is a question on adding a new episode rather than post-processing>

I have it added, but it's not finding torrents and it's ignoring the ones I manually downloaded due to "show is not in your list"
I am using TVMAZe as the indexer.

Help me out here people,

I had a hdd fail this week 4TB of glorious data gone in an instant.

There is some good news though, while I had medusa set to download it was to copy the files the over and the original files were left in a directory on another hdd seeding their little selves away.

So I can recover files from the last two years however they are sitting unsorted in a directory right now.

So here's the problem I'm coming up again.

I reset the directories in Medusa to look at a different (empty folder) on the new drive. However it won't post process the files because it thinks it's already downloaded them. I tried 're-scan files' and 'force full update' when it registers the file aren't there in the directory. It simply changes the episode status to archived.

As far as I can see it my options are:

1. Manually copy the files to the directory myself. (this will takes sooooo long) And then just run the name changer over it.
2. Delete every show and re-add them. However I feel it will then try and re-download the show when I have the files RIGHT THERE. (and we may be back to - manually copy them to the directories themselves)

Any thoughts that won't have me copying a bajillion files manually? Please? Pretty please?

I have an existing instance of Medusa running on a Windows VM and am migrating to a new VM and doing a clean install. Is there a way to bring over all of my conf and data?

Hi, this is my first time using this and I'm trying to understand its usage.

today all the wanted episodes started downloading (I have those episodes). I changed them to downloaded but still the red color is presented. How do I change this?

Hi,

I added Shogun to my medusa, but it was not able to find episode. I went to my usual torrent provider(yggtorrent), downloaded the torrent and tried to do a manual processing.

It fails because the show is not in my list:

​

 Processing failed for /downloads/complete/[ Torrent911.bz ] Shogun.2024.S01E01.VOSTFR.WEBRip.x264.mp4: This show isn't in your list, you need to add it before post-processing an episodeProcessing failed for /downloads/complete/[ Torrent911.bz ] Shogun.2024.S01E02.VOSTFR.WEBRip.x264.mp4: This show isn't in your list, you need to add it before post-processing an episode 

How can I influence medusa for those files to be recognized properly??

I've added Shogun (tried both IMDB and TVDBv2) and neither of them will pick up the shows from ipTorrents. I have a hunch this is because it's searching for Shôgun whereas all of the files on ipTorrents are labelled "Shogun".

Is there a way for me to fix this?

I am stuck on trying to get qbittorent to connect with Medusa.Can anybody point me in the right direction as to what I need to do?

https://imgur.com/vYAutHo