What it does:

Set the configuration to clean up certain library types, by default, only TV Show libraries are checked — enable others explicitly if you want Movies, Music, etc. cleaned too.

Run automatically: Runs cleanup after every library scan. Turn off if you only want to trigger it manually.

Hide empty seasons: TV seasons with zero episodes are removed from view.

Hide empty collections: Box sets and collections with no items are removed from view.

Manual trigger: Go to Dashboard → Scheduled Tasks → Hide Empty Folders and click the play button.

How it works: After a library scan completes (or you trigger it manually), the plugin:

Finds all media items across your selected libraries Walks up the folder tree marking every ancestor as "has content" Removes database entries for folders that have no media anywhere under them The plugin uses DeleteFileLocation = false — folder entries are removed from Jellyfin's database only. Your files stay exactly where they are.

Collection folders (the top-level "Movies", "TV Shows" containers) are never touched.

What to expect Jellyfin is the party that adds empty folders. The plugin only removes them from the library database — it never touches files on disk.

If a show is added to an empty folder: Jellyfin's real-time monitoring (or scheduled scan) picks up the new file, re-adds the previously-removed empty folder structure to the library, then the plugin removes it again within ~10 seconds. The folder may briefly reappear and vanish — this is normal.

If you run a manual library scan: The plugin runs immediately after the scan completes and cleans up any empty folders.

If you trigger the scheduled task (Dashboard → Scheduled Tasks → Hide Empty Folders): It runs the same cleanup on demand.

Files on disk are never deleted.

Add this URL to Jellyfin under Dashboard → Plugins → Repositories → Add:

https://raw.githubusercontent.com/CapstonPeters/Jellyfin-Hide-Empty-Folders/main/manifest.json

Then go to Catalog and perform a cache refresh CTRL-F5, find Hide Empty Folders, and click Install. Restart Jellyfin.

Or:

Download the latest ZIP from Releases Extract into your Jellyfin plugin folder — the resulting directory should look like: plugins/Hide Empty Folders/ ├── Jellyfin.Plugin.HideEmptyFolders.dll ├── thumb.png └── meta.json

Restart Jellyfin Configuration Open Dashboard → Plugins → Hide Empty Folders → Settings.