Skip to content

Managing a Local Media Library in Jellyfin

Independent editorial guidance on compatibility, device settings, safety, and responsible use.

A search for “Catálogo Completo do Jellyfin” may suggest a built-in lineup. In a self-hosted Jellyfin setup, the administrator chooses the folders that supply the library. Its contents depend on the media available to that server and on the viewer's access. Start with a sample folder, decide how people should find items, and expand once the organization works. Use files you have permission to store and play.

Editorial illustration: Managing a Local Media Library in Jellyfin
Editorial illustration

Plan the folder structure around actual use

List the kinds of material you want to browse. A group of family recordings may work well by year and event. A collection of albums may be easier to maintain in folders named for artist and album. Movies and episodic series often benefit from separate directories and the naming approaches described in the project's library documentation. Decide where each type will live before you scan the entire collection. Clear boundaries help when you need to move storage, correct metadata, or limit what certain people can see.

Test your plan with a few copies of authorized files. For example, create a set of holiday recordings from two years with descriptive names that a relative would recognize. Ask that relative to find a specific clip in the test library. If they can only find it by guessing your private filename conventions, adjust the names before adding a larger collection. Use dates when they help distinguish similar events. For material that repeats frequently, such as weekly recordings, include enough context to recognize the right item in a search result.

Check storage and access before scanning

The server needs to read the folders you choose while it is running. Find out where the media actually lives and whether the host continues to see it after a reboot. This matters for external drives, shared folders, and computers that sleep automatically. If a drive changes location in the operating system, the saved library path may no longer point to the files. Use a storage approach you can repeat and document the arrangement for the person who maintains it.

Ask the server administrator to check that the server can see the sample media with the access it normally has. A folder that opens under your desktop account might be unavailable to the process that runs the server. When a scan shows an empty library, confirm the configured source and storage availability before renaming files. If the source is missing, write down whether the drive is disconnected or the computer sharing it is asleep. Knowing why the folder disappeared helps you choose a durable fix.

Add a small library and inspect the scan

Use the server's library management interface to select a library type and the folder that matches it. Read the options for scanning and metadata before you start. Choose a library label that makes sense to the intended viewers. “Home movies” tells a family member more about what they will find than the name of an external drive. Scan the sample and inspect how titles, dates, and grouping appear in a client.

Check that the visible entries correspond to the actual files. If a title is missing, compare its name and location with a nearby item that appears correctly. Check the project's naming guidance for that library type. If a series episode appears out of order, consider whether the filenames identify its season and episode in a way the scanner expects. Use a single change and rescan the sample when you can. This shows whether the naming correction solved the problem before you apply the same approach across the whole collection.

Decide how to handle metadata and artwork

Metadata helps people browse by adding information such as titles, dates, and images. Configured providers may use a lookup to gather that information. For personal recordings, automatic matching can attach an unrelated title or image. Review the configured providers and decide whether external lookups fit each library, especially if filenames contain family names, locations, or private events. Use a small set of generic examples to see how the interface looks after a scan.

If an item matches incorrectly, inspect the existing file name and library type before editing the result. For commercial media you are authorized to use, identifying information such as a year can help distinguish similarly named titles where the project documentation supports it. For personal material, prefer the description your household already uses. Also consider how artwork looks on different screen sizes. An image that seems harmless while editing on a computer may reveal a face or private event on the living room home screen.

Set up library views for the people who use them

Make a list of which people should have access to each folder group, especially when a collection includes both general viewing and private recordings. Ask the administrator to review the corresponding library access settings. Then test what appears from the relevant viewer's perspective. Check browsing, search, recent items, and playback on a shared device. The name and artwork of a title can matter even if nobody opens the file.

A household example is a television used by children and guests alongside a tablet used for private family recordings. Keep the recordings in a distinct library and make sure the ordinary television view shows only the intended folders. Test the setup with generically named sample items. When someone buys a new screen or changes how they access the server, review the view again. The aim is a library that displays the right choices without asking each viewer to remember which folders to avoid.

Maintain the collection as it grows

Set aside time to check new files after each import. Look for items appearing in the wrong library, duplicates caused by overlapping folders, and recordings that are difficult to find because their names are too similar. For a move to new storage, record the old and new locations and verify a small batch before changing a large one. Keep independent backups of irreplaceable media and review the server's guidance for backing up settings or library data separately.

Try a few everyday tasks after reorganizing. Search for an item whose name changed, resume a familiar title, and open one file from each folder that moved. If the collection includes audio or caption tracks with special significance, check one of those too. Give regular viewers a chance to find something without help. Their search terms and navigation habits often show whether the new structure makes sense. A usable catalog grows from consistent file organization and review of what appears on the screens people actually use.