What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
A reliable Jellyfin library starts with an orderly filesystem: separate movies from shows, use predictable names, add provider IDs when a title is ambiguous, exclude non-media folders deliberately, and keep every mounted path available during scans and maintenance. The result is fewer wrong matches, cleaner browsing, and less time repairing metadata.
What Jellyfin needs from your media folders
Jellyfin reads media directly from filesystem paths. It builds the library view from the folders and files it can see, then associates titles with metadata providers and artwork. Organization therefore begins outside the Jellyfin interface: the directory tree, filenames, mount points, and permissions determine what the server can discover.
As an Amazon Associate I earn from qualifying purchases.
Think of a library as a contract between your storage and Jellyfin. Each root should contain one broad type of content, every title should have a recognizable name, and anything that is not meant to appear should be excluded explicitly. Keep the database on local storage even when the media itself is on a network share; this separates Jellyfin’s application data from the availability and latency of the media path.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Choose dedicated libraries instead of mixing movies and shows
When a collection contains both films and television, create separate Movies and Shows libraries. Jellyfin’s mixed-library guidance warns that some functions may not work correctly in a mixed library and recommends dedicated movie or show libraries for the best results.
#1 Best Overall
- [ Massive 22TB Capacity ] Instantly expand your storage space for files, photos, videos, music, and more. Ideal for backups, media libraries, and OS system storage. (Estimated 20TB Capacity after formatted)
- [ High-Speed USB 3.2 Gen 2 Interface ] Enjoy ultra-fast data transfer speeds up to 10Gbps for efficient file management and quick backups.
- [ 7200 RPM Hard Drive Inside ] Designed for reliable 24/7 operation with robust performance for desktop or console storage needs
- [ Plug-and-Play Compatibility ] Fully compatible with both Windows and macOS systems. No software installation required.
- [ Durable & Silent Design ] Features a stylish design enclosure with long-term durability and a fanless cooling system for whisper-quiet operation.
| Organization | How it works | When to use it | Trade-off |
|---|---|---|---|
| Dedicated libraries | One library points to movie folders and another points to series folders. | Most collections, especially those that need predictable filtering, artwork, and identification. | Requires an extra library entry and separate root paths. |
| Mixed library | Movies and television folders are presented through one library. | Only when a single combined view is more important than the features that may be limited. | Some functions may not behave as they do in separate movie or show libraries. |
Jellyfin is designed to organize several media categories, including movies, TV shows, music, and photos. Create libraries around the categories you actually browse rather than putting every file under one catch-all root.
Build a folder layout Jellyfin can recognize
Use one clear root for each library
Keep the path selected for a Movies library pointed at a movie root and the path selected for a Shows library pointed at a series root. The following layout uses the naming patterns documented by Jellyfin; the titles and IDs are illustrative formatting examples, not claims about real catalog entries:
Media/
Movies/
Example Film (2022) [tmdbid-12345]/
Example Film (2022).mkv
Shows/
Example Series (2021) [tvdbid-79168]/
Season 01/
Example Series S01E01.mkv
Example Series S01E02.mkvA separate folder per movie keeps the video, subtitles, artwork, and any sidecar metadata associated with that title. A series folder gives Jellyfin a stable place for season directories and episode files. Do not rely on a flat directory full of unrelated files when a title-based hierarchy is practical.
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallCrashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteMovie folders and filenames
For a movie, include the title and release year in the containing folder. Naming the video with the same title and year makes the relationship obvious to both Jellyfin and a person browsing the share. If a title has an unusual name or a remake shares the same title, add a provider identifier as described below.
Series, seasons, and episodes
Place each series in its own folder, then group episodes in season directories such as Season 01. Use the season-and-episode pattern S01E01, S01E02, and so on in the episode filename. This gives Jellyfin an unambiguous season and episode number without requiring it to infer the order from a date or an arbitrary filename.
The documented examples are a dependable baseline, not a complete naming specification for every special case. Editions, multipart films, specials, music tagging, and local-artwork filenames can have additional rules; consult the current Jellyfin documentation for those edge cases before standardizing a large archive.
Rank #2
- [ Massive 4TB Storage Capacity ] Store thousands of photos, videos, games, music files, and important documents in one convenient external hard drive.
- [ Fast USB 3.0 Performance ] High-speed USB 3.0 interface provides reliable and efficient data transfer for backups and everyday storage use.
- [ Plug & Play Convenience ] Easy setup with no additional software required; compatible with Windows PCs, Mac computers, gaming consoles, and more.
- [ Reliable Backup & Storage Solution ] Ideal for expanding storage, system backups, gaming libraries, videos, photos, and everyday file organization.
Use provider IDs when names are ambiguous
A readable title is usually enough, but a filename cannot distinguish every remake, translation, similarly named series, or obscure release. Jellyfin supports explicit metadata-provider identifiers in a file name or in the containing folder. You can supply more than one identifier when that helps identify a title.
| Provider | Example syntax | Important limitation |
|---|---|---|
| TMDB | [tmdbid-680] or {tmdb-680} |
Use the ID associated with the intended movie or series. |
| TVDB | [tvdbid-79168] |
Find the series ID on the title page. |
| IMDb | [imdbid-tt12801262] |
IMDb-style IDs are accepted in the documented identifier syntax. |
| OMDb | An OMDb identifier in the supported identifier form | Jellyfin’s identifier guidance lists OMDb as English-only. |
How to locate the IDs
TMDB and IMDb IDs are visible in the URL of the relevant title page. TVDB IDs are shown on the title page itself. Copy the ID exactly, including its prefix, and place it in square brackets, parentheses, or braces using Jellyfin’s supported forms. For example:
Example Film (2022) [tmdbid-12345]
Example Series (2021) [tvdbid-79168]
Example Film (2022) [tmdbid-12345][imdbid-tt12801262]The examples demonstrate formatting only. Verify that each ID belongs to the title you intend to add; an incorrect ID is more authoritative than a vague filename and can therefore produce a confidently wrong match.
Create the libraries in Jellyfin
Once the folders are organized, add them as separate libraries in the web administration interface. Label wording can vary slightly by Jellyfin release, but the workflow is the same:
- Open the Jellyfin web client and go to Dashboard.
- Open Libraries and choose Add Media Library.
- Select the content type that matches the root: Movies for films or Shows for series.
- Give the library a clear display name, such as
MoviesorTV Shows. - Add the corresponding filesystem path and save the library.
- Repeat the process for other content types instead of adding unrelated roots to the same library.
After changing a folder name, adding an identifier, or creating an ignore file, open the library’s action menu and run Scan Library Files (the exact label may differ by release). A fresh scan lets Jellyfin reconsider the changed path instead of waiting for a scheduled task.
Repair a wrong or uncertain match
Start with the filesystem name
Fix the folder or episode filename first. Add the year to a movie folder, use a season directory for a series, and put the SxxExx code in the episode filename. Then scan the library again.
Rank #3
- Entry-level NAS Personal Storage：UGREEN NAS DH2300 is your first and best NAS made easy. It is designed for beginners who want a simple, private way to store videos, photos and personal files, which is intuitive for users moving from cloud storage or external drives and move away from scattered date across devices. This entry-level NAS 2-bay perfect for personal entertainment, photo storage, and easy data backup (doesn't support Docker or virtual machines).
- Set Your Devices Free, Expand Your Digital World: This unified storage hub supports massive capacity up to 64TB.*Storage drives not included. Stop Deleting, Start Storing. You can store 22 million 3MB images, or 2 million 30MB songs, or 43K 1.5GB movies or 67 million 1MB documents! UGREEN NAS is a better way to free up storage across all your devices such as phones, computers, tablets and also does automatic backups across devices regardless of the operating system—Window, iOS, Android or macOS.
- The Smarter Long-term Way to Store: Unlike cloud storage with recurring monthly fees, a UGREEN NAS enclosure requires only a one-time purchase for long-term use. For example, you only need to pay $459.98 for a NAS, while for cloud storage, you need to pay $719.88 per year, $2,159.64 for 3 years, $3,599.40 for 5 years. You will save $6,738.82 over 10 years with UGREEN NAS! *NAS cost based on DH2300 + 12TB HDD; cloud cost based on 12TB plan (e.g. $59.99/month).
- Blazing Speed, Minimal Power: Equipped with a high-performance processor, 1GbE port, and 4GB RAM on Board, this NAS handles multiple tasks with ease. File transfers reach up to 125MB/s—a 1GB file takes only 8 seconds. Don't let slow clouds hold you back; they often need over 100 seconds for the same task. The difference is clear.
- Let AI Better Organize Your Memories: UGREEN NAS uses AI to tag faces, locations, texts, and objects—so you can effortlessly find any photo by searching for who or what's in it in seconds. It also automatically finds and deletes similar or duplicate photo, backs up live photos and allows you to share them with your friends or family with just one tap. Everything stays effortlessly organized, powered by intelligent tagging and recognition.
Add an identifier for persistent ambiguity
If Jellyfin still selects the wrong title, add the relevant TMDB, TVDB, IMDb, or OMDb ID to the containing folder or media filename. Multiple IDs are allowed, so you can identify a title through more than one provider when necessary. Rescan after saving the change.
Check the ID before blaming the scanner
Open the provider’s title page and compare the year, language, and format with your file. A valid-looking ID for a different remake or season will not be corrected by rescanning; replace it with the ID for the intended title.
Keep unwanted files out with .ignore
Downloads, samples, artwork working files, and old encodes often sit beside the media you want to catalog. Jellyfin supports a .ignore file for excluding that material.
Recommended Free Tools
Exclude an entire directory
Put an empty file named .ignore in a directory you do not want indexed. Jellyfin excludes that directory and its descendants. This is useful for a complete staging folder or a subdirectory containing temporary files.
Exclude selected files or subdirectories
In Jellyfin 10.11.x and later, a non-empty .ignore file can contain ignore patterns. Use this when a folder contains both cataloged media and items that should remain invisible. The pattern behavior is version-sensitive: older Jellyfin releases did not interpret the contents in the same way, so check your server version before relying on pattern rules.
Apply the change
- Create or edit
.ignoreon the filesystem. - Confirm that the file is in the directory whose contents you want excluded.
- Run a library scan from the Jellyfin dashboard.
- Check both the affected folder and any descendant folders for items that should no longer appear.
An ignore file prevents discovery; it does not delete media from storage. Remove or edit it when you are ready to bring the content into the library.
Rank #4
- 14TB storage capacity Provides ample space for storing documents, photos, music and more.
- USB 3.0 interface Offers an easy-to-use connection to devices. Backward compatible with USB 2.0 for simple connection to your computer.
- Data transfer rates up to 5 Gbps with USB 3.0 Enable a rapid response when updating files.
- Automatic backup options Allow you to use compatible software to back up your files to the server.
- Compatible with Mac and PC For flexible installation options.
Represent unavailable titles with .disc placeholders
Sometimes you want a title in the catalog even though the playable file is not currently available. Jellyfin supports a .disc placeholder that follows the normal media naming convention. The placeholder can be empty, and Jellyfin can attach metadata and artwork to it.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problemsFor a recognized medium type, put the medium extension immediately before .disc, for example .dvd.disc or .bluray.disc. Use this for a title you intentionally catalog as unavailable, not as a workaround for a broken mount or a missing file that should be restored.
Decide whether to extract chapter images
Chapter image extraction is optional and configured per library. Jellyfin stores the extracted images in its metadata directory rather than beside the original video. The feature can make timeline navigation more useful, but extraction is computationally intensive and can slow scans, particularly in a large collection.
Choose chapter extraction when chapter thumbnails are important to your playback experience. Avoid very small automatic chapter intervals unless you specifically need them: the web player may have to render a large number of timeline markers, which can make navigation less efficient. For a first scan of a large library, leaving extraction disabled or using a restrained interval reduces the workload; enable it later for selected libraries if the benefit justifies the processing time.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Keep storage mounts stable
Mount network shares in the operating system
For Samba or NFS media, mount the share through the operating system and give Jellyfin the resulting local filesystem path. Jellyfin expects the path to exist when it scans; it is not a replacement for the operating system’s network-mount configuration.
Keep the database local
Store Jellyfin’s database on local storage even when videos, music, or photos live on a network share. A local database avoids making core application state dependent on network-share latency or temporary disconnects.
Best Value
- Compact, stackable, external storage solution designed to compliment the footprint of the 2010 to current Mac mini
- USB 3.2 (5Gb/s) connectivity
- Fast transfer speeds up to 208MB/s
- Compact, aluminum design with MagLev cooling fan; Stacks perfectly with Mac mini
- 3 Year OWC Limited Warranty
Protect scheduled maintenance
Jellyfin warns that scheduled maintenance can remove items from the library if the media storage is unavailable when those tasks run. A disconnected share can therefore look like mass deletion even though the files still exist on the server or NAS.
- Ensure Samba or NFS mounts are active before a scheduled scan or cleanup task.
- Use a stable mount path; do not alternate between different paths for the same collection.
- After a reboot, verify the mount before starting Jellyfin or allowing maintenance tasks to run.
- If a library suddenly loses titles, check the operating-system mount and filesystem permissions before rebuilding metadata.
Grant only the filesystem access Jellyfin needs
On Windows, the Jellyfin service account needs read and execute access to media folders for visibility and playback. That is the least-privilege setup for a library that Jellyfin only reads.
| Jellyfin action | Access needed on the media folders |
|---|---|
| Discover and play media | Read and execute |
| Delete files through the Jellyfin interface | Modify access |
Save subtitles or .nfo files beside media |
Write-capable access, including the ability to create or modify those files |
Do not grant modify access merely because Jellyfin can play a file. Add write permissions only when you have deliberately enabled a feature that changes the media folders, and apply them to the service account and paths that need them.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Metadata stored with media versus in Jellyfin
Jellyfin can use metadata associated with a title, including placeholder artwork and adjacent metadata files. The available guidance does not establish a universal winner between keeping all metadata in Jellyfin’s own library data and writing sidecar files beside the media. Choose one approach deliberately, document it, and grant write access only if Jellyfin must create or update those sidecars. A Windows service that only reads media should not be made writable just to improve identification.
A repeatable maintenance workflow
Use this sequence whenever you add a batch of media or repair an existing collection:
Quick Recap
- Prepare the storage path. Confirm the local disk or operating-system network mount is online and remains at the path already configured in Jellyfin.
- Sort by content type. Put films under the Movies root and series under the Shows root; keep unrelated categories in their own libraries.
- Create title folders. Use a movie title and year, or a series folder containing season directories.
- Rename episodes. Use SxxExx episode codes and a consistent series name.
- Add IDs selectively. Add a TMDB, TVDB, IMDb, or OMDb identifier when the readable name could match more than one title.
- Exclude staging material. Place an empty or pattern-based
.ignorefile where temporary content must stay invisible. - Check permissions. Confirm the Jellyfin service account can traverse directories and read files; add write access only for intentional file-changing features.
- Scan the affected library. Run a library scan after naming, ID, or ignore-file changes.
- Verify the result. Open the new or corrected item, check its year and artwork, and play a file from the expected path.
- Schedule maintenance around availability. Do not let cleanup tasks run while a network share is disconnected.
Troubleshoot common organization failures
| Symptom | Likely cause | Correction |
|---|---|---|
| A movie appears as the wrong title | The name is ambiguous or an old identifier points to another title. | Verify the provider page, correct the folder or file name, add the right ID, and scan again. |
| Episodes are missing or grouped incorrectly | The series lacks season directories or the filename does not contain an SxxExx code. | Move episodes into Season 01-style folders and rename them with the correct season and episode numbers. |
| Temporary files appear in the library | The folder is under a scanned root and has no ignore rule. | Add an empty .ignore for the whole directory or a pattern-based file on Jellyfin 10.11.x and later, then rescan. |
| A library loses many items after maintenance | A Samba or NFS mount was unavailable when a scheduled task ran. | Restore the operating-system mount, confirm the path, and review the library after storage is online. |
| Jellyfin cannot play files it can list | The service account can see directory names but lacks sufficient read or execute access. | Grant the account read and execute permissions through the media path. |
| Scans take much longer after enabling artwork features | Chapter image extraction is processing a large number of videos or a very small chapter interval creates many markers. | Disable extraction for libraries that do not need it or use a less frequent interval. |
| A catalog item has artwork but no playable video | It is a deliberate .disc placeholder or the expected media path is unavailable. |
For a placeholder, add the actual disc file when available; otherwise check the mount and filename before changing metadata. |
Final organization checklist
- Movies and shows are in dedicated libraries.
- Movie folders include a recognizable title and year.
- Series have season directories and SxxExx episode names.
- Ambiguous titles carry a verified provider ID.
- Temporary or non-media directories contain an appropriate
.ignorefile. - Unavailable catalog titles use a correctly named
.discplaceholder. - Chapter extraction is enabled only where its processing cost is acceptable.
- Samba or NFS shares are mounted by the operating system before scans and maintenance.
- The Jellyfin database is on local storage.
- Windows service accounts have read and execute access, with write access limited to features that require it.
- A scan has been run after every structural or ignore-rule change.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
