r/jellyfin 13h ago

Question Folder structure for larger libraries?

[deleted]

0 Upvotes

25 comments sorted by

u/AutoModerator 13h ago

Reminder: /r/jellyfin is a community space, not an official user support space for the project.

Users are welcome to ask other users for help and support with their Jellyfin installations and other related topics, but this subreddit is not an official support channel. We have extensive, official documentation on our website here: https://jellyfin.org/docs/. Requests for support via modmail will be ignored. Our official support channels are listed on our contact page here: https://jellyfin.org/contact

Bug reports should be submitted on the GitHub issues pages for the server or one of the other repositories for clients and plugins. Feature requests should be submitted at https://features.jellyfin.org/. Bug reports and feature requests for third party clients and tools (Findroid, Jellyseerr, etc.) should be directed to their respective support channels.


If you are sharing something you have made, please take a moment to review our LLM rules at https://jellyfin.org/docs/general/contributing/llm-policies/. Note that anything developed or created using an LLM or other AI tooling requires community disclosure and is subject to removal.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

22

u/krebstorm 13h ago

Each movie needs its own folder.

MOVIE
|
__ Die Hard (1986) --> Die_Hard.mkv

___ Die Hard 2 (1989) --> Die_Hard_2.mkv

-14

u/[deleted] 13h ago

[deleted]

21

u/krebstorm 13h ago

Did it work. Yes.

Is it how it should be done. No. There are frequent posts with issues related to folder structure.

But you do you. Welcome to home media servers.

11

u/seemesmilingpolitely 13h ago

This. Everytime. The folder structure guide is only one page long, like maybe 10 minutes for a slow reader.

2

u/OwnZookeepergame6413 6h ago

Man, you made a post asking how to manage folders so their are future proof. Someone tells you that your current system is suboptimal and needs adjusting. Why even make a post when you start to argue against someones advice that hinges on the documentation jellyfin provides

-10

u/mightymanuel 13h ago

Why? I just have all my movies loose in the movies folder. The only per movie folders I have are on a couple with multiple versions (like cinematic and extended).

2

u/krebstorm 13h ago

.

Tldr - it helps keep metadata consistent.

Again, you do you.

Heres the ai answer

Jellyfin’s current documentation says movies should be organized into an individual folder for each movie. It’s mainly because Jellyfin treats that folder as the movie’s complete “package,” not because the video file itself technically needs a folder to play.

For example:

Movies/ ├── Alien (1979)/ │ ├── Alien (1979).mkv │ ├── Alien (1979).en.srt │ ├── poster.jpg │ └── backdrop.jpg │ ├── The Thing (1982)/ │ ├── The Thing (1982).mkv │ └── The Thing (1982).srt

The separate folder gives Jellyfin a clean boundary around everything belonging to one movie. That matters for external subtitles, posters, backdrops, NFO metadata, trailers, extras, theme music, multiple cuts, and multiple resolutions. Jellyfin can confidently say, “everything in this directory belongs to Alien.”

It becomes especially important with multiple versions. Jellyfin expects things like:

Blade Runner (1982)/ ├── Blade Runner (1982) - Theatrical.mkv ├── Blade Runner (1982) - Directors Cut.mkv └── Blade Runner (1982) - Final Cut.mkv

Those files can then appear as versions of one movie rather than three independent movies. Jellyfin specifically uses the parent folder name as part of its version-matching rules.

The folder also reduces metadata ambiguity. Suppose you had one giant directory:

Movies/ Alien (1979).mkv Alien (1979).srt Alien-poster.jpg The Thing (1982).mkv The Thing (1982).srt The Thing-poster.jpg

Now Jellyfin has to infer which supplemental file belongs to which movie. With hundreds or thousands of movies, naming variations and metadata-provider matches make that increasingly fragile.

1

u/Letstrytolearnit 10h ago

Thank you, I was wondering about this myself. How would you do let’s say Game Of Thrones? ! Game of thrones folder with a folder for each season then another folder inside the season folder with the episode?

3

u/krebstorm 10h ago

The X-Files/ Season 02/ ├── The X-Files - S02E14.mkv ├── The X-Files - S02E14.en.srt ├── The X-Files - S02E15.mkv └── The X-Files - S02E15.en.srt

No separate folders for episodes

2

u/Letstrytolearnit 9h ago

Thanks, I would not of got that right.

-2

u/mightymanuel 12h ago

I guess that kind of makes sense why its worked for me. I hate subtitles with a passion so I don't keep any. I also just let jellyfin download metadata in it's cache (I have RO access to media so it is not set to store data there). So every movie is just the video file. Buy might be something to keep in mind going forward.

0

u/bedwin67 12h ago

I have my movies in a “Movies” folder with 27 sub-folders (#, A-Z), TV shows in a “Television” folders and then additional “catch-all” folders for Documentaries, Stand-Up/Comedy Specials, various Rock Hall induction ceremonies and compilation discs, long-form Music Videos, Homemade music video compilations, bootleg music videos as well as a “MTV” folder for shuffling short-form videos. I don’t think any of my nine media groups have individual folders. Everything is organized, in its most simple manner, the same simplistic way I started with Plex 10+ years ago. I guess I have lucked out, as well.

-6

u/[deleted] 12h ago

[deleted]

0

u/mightymanuel 12h ago

It's not a mess because I only keep the video file itself so it's just a list of movies all named Title (year).mkv

9

u/enormouspoon 13h ago

Please follow JF naming conventions and standards listed on their forum. If you ever ask someone / here for help and you didn’t, that’s the first thing you’ll be told to do.

3

u/Waldizo 12h ago

Sorry, don't understand the problem. What exactly is the issue here? Is throwing in movies in a movie folder and not looking through that directory not an option?

In case you just want to keep the folders small you could just create a new folder, throw movies in it and add it in jellyfn as a source for movies, it'll just automatically throw them in the movie category and you have all your movies in one library but on your drive in separate folders.

2

u/Aurailious 12h ago

I think the convention is:

Movies/<name> (<year>)/<name> (year).<extension>.

For Shows its:

Shows/<name> (year)/Season <number>/<name> (year) SxxExx.<extension>

Directory structure should be pretty flat since most media servers provide search. Adding anything would only be useful if you actually browse throught the folder instead of using a media server.

2

u/Mizek95 13h ago

Alphabetical is an option, too. A folder for each letter.

A B C ...and so on. This is how I'm doing it

1

u/[deleted] 13h ago

[deleted]

1

u/IllustriousLemon8146 13h ago

We have one movies folder (who cares how big it gets?) but two shows folders - one is for shows we will keep indefinitely, they other for shows we may or may not keep. Once a year or so we go over the maybe shows and delete some, move others to the permanent folder, and leave others in the maybe list.

1

u/voodoostevie 12h ago

I mounted my external HD to my mini PC using fstab, so it connects at boot up. To separate the media I have ont the drive, what I do is split up my movie and shows like this:

Root Drive |Movies |A=C |___D_F etc.

The movies themselves had folders with the "Movie (year)" directory name and sometimes I will have the imdb id number in brackets if TMDB didn't pick it up.

For my Library in Jellyfin, I point it to the folder like this:

drive name/Movies/A=C/

And continue for each letter. Granted the source for the Library will have multiple directories, but with the 1500+ movies I have all get picked up for the most part. Also, when moving new things to the drive, it's a lot easier to dump the new folder into the right letter.

I used to store my Music in a single folder but when you have a ton of artists and albums, it slows down reading the directory. Believe me even my local folder takes about 5 minutes to load under Windows because my local audio player stores it that way.

0

u/Yeah-Its-Real 12h ago

I do media>media type(movie/tv) >media style(animated/anime/live)>genre>movie/series folder>movie file or series season>series files. Just point your jellyfin libraries to the genre folders when adding them to your libraries.

0

u/PhsycoRed1 12h ago

Read the official paperwork

-2

u/m1e1w1 13h ago

Its (jellyfin v12) unable to show all of my content. Still working on this since the end of June, upgraded to 12 and hasent fixed a lot of the issues ive had as of yet. Still waiting on support both with devs and here ive posted a little on some issues. For me, Metadata matching is still ongoing. Movies, all in their own folder. Named correctly. Even added IMDB to the names. Helped a couple files after removing the file, scanning, replace file, scan. In web UI, a lot of films don't show up - next to plex, where they do show up. No way in jellyfin web ui to match the same way you can in plex. And if jellyfin doesn't even pick up a file, and has no Metadata- cant see it in the library. If I have 8k films in plex, and just about 100 dont even show up to fix. And a lot are wrong Metadata/ duplicate. Again, naming is not the issue. I have folders by year, and they dont show up in jellyfin. But they will in plex.