Adding movies to your Jellyfin server is the core process that unlocks its functionality as a personal media powerhouse. This guide provides a step-by-step walkthrough and addresses common questions, ensuring a seamless experience for both beginners and advanced users.
Understanding Jellyfin’s Media Management
Jellyfin, at its heart, is a media server that organizes and streams your personal collection of movies, TV shows, and music. Effectively adding movies is more than just copying files; it’s about following a system that allows Jellyfin to identify, organize, and present your content in an appealing and user-friendly way. This involves proper file naming, folder structure, and utilizing Jellyfin’s built-in scanning and metadata retrieval features. Understanding these basics is critical for a successful Jellyfin experience.
Preparing Your Movie Files
Before you even touch Jellyfin’s interface, you need to ensure your movie files are properly prepared. This includes the file name itself and the folder structure in which they reside.
Naming Conventions
Jellyfin relies heavily on consistent naming conventions to accurately identify and retrieve metadata for your movies. Adopting a standard format significantly improves organization and reduces the likelihood of incorrect information being displayed.
- Recommended format:
Movie Title (Year).ext(e.g.,The Matrix (1999).mkv) - Including Quality:
Movie Title (Year) [Quality].ext(e.g.,The Matrix (1999) [1080p].mkv) - Avoid special characters: Replace spaces with periods (.) or underscores (_). (e.g.,
The.Matrix.(1999).mkvorThe_Matrix_(1999).mkv)
The file extension (.ext) should accurately reflect the video format, such as .mkv, .mp4, .avi, etc.
Folder Structure
A well-organized folder structure is just as important as the file names themselves. It allows Jellyfin to quickly locate and categorize your movies.
- Create a dedicated “Movies” folder: This is your root directory for all movies.
- Subfolders for each movie: Each movie should reside in its own subfolder named after the movie title.
- Examples:
Movies/
The Matrix (1999)/
The Matrix (1999) [1080p].mkv
poster.jpg (Optional: Local artwork)
The Matrix (1999).nfo (Optional: Local metadata)
Inception (2010)/
Inception (2010) [4K].mkv
Creating subfolders ensures that Jellyfin correctly identifies sequels and other related movies. Additionally, it allows you to store local artwork and metadata alongside the movie file (more on that later).
Adding Movies to Jellyfin: The Step-by-Step Guide
Once your movie files are properly named and organized, you can add them to your Jellyfin library.
- Log in to your Jellyfin server: Access your Jellyfin web interface through your browser (usually
http://your-server-ip:8096). - Navigate to “Dashboard”: This is your central administration panel.
- Click “Libraries”: This section allows you to manage your media libraries.
- Click “+ Add Media Library”: Start the process of creating a new library for your movies.
- Select “Movies” as the content type: This tells Jellyfin to treat this library as a collection of movies.
- Enter a “Display name”: This is the name that will appear in the Jellyfin interface (e.g., “My Movies”).
- Click “+ Add Folder”: Browse to the location of your root “Movies” folder (the one you created in the previous section) and select it.
- Configure Metadata Downloaders: Choose the metadata downloaders you want Jellyfin to use to fetch information about your movies. TheMovieDB is a popular and reliable option. Ensure it’s enabled and listed as a priority. You can adjust the order by dragging and dropping.
- Configure Preferred Languages and Country: This dictates the language and region for metadata downloads.
- Set Image Fetchers: Similar to Metadata downloaders, select image fetchers like TheMovieDB for grabbing posters and backdrops.
- Advanced Settings (Optional): Explore advanced settings for fine-tuning how Jellyfin handles your movies. This includes options like “Scan for chapter images” and “Download subtitles”.
- Click “OK” to save the library: Jellyfin will now begin scanning your “Movies” folder and downloading metadata.
Scanning and Refreshing Metadata
After adding a library, Jellyfin automatically initiates a scan to identify and process the movies within it. However, you may need to manually trigger a scan or refresh metadata in certain situations.
- Manual Scan: From the “Libraries” section in the Dashboard, hover over your “Movies” library and click the three dots (menu). Select “Scan Library Files”.
- Refresh Metadata: If a movie’s metadata is incorrect or missing, select “Refresh Metadata” from the same menu. You can choose to refresh all metadata or only missing metadata.
Understanding Metadata Agents
Metadata agents are services that Jellyfin uses to automatically retrieve information about your movies, such as titles, descriptions, actors, posters, and ratings. Choosing and configuring these agents correctly is essential for a well-organized and informative library.
Configuring Metadata Agents
To configure your metadata agents, navigate to the “Dashboard” -> “Plugins” -> “Repositories”. Look for plugins related to movie metadata (e.g., “The Movie Database”). Ensure they are installed and enabled. Then, in the “Libraries” section, when you add or edit a “Movies” library, you can prioritize the order in which these agents are used. Prioritize reliable and comprehensive agents for the best results.
Addressing Common Issues
While Jellyfin is generally reliable, you may encounter occasional issues when adding movies. Here are some common problems and their solutions:
- Movie not recognized: Double-check the file naming and folder structure. Ensure they adhere to the recommended conventions. Try refreshing the metadata for the individual movie.
- Incorrect metadata: Manually edit the metadata within Jellyfin or utilize local
.nfofiles. - Missing artwork: Verify that image fetchers are enabled and properly configured. Try refreshing the artwork for the individual movie.
- Scanning taking too long: Ensure your server has sufficient resources (CPU, RAM) and that your storage is performing optimally. Limit the number of libraries being scanned simultaneously.
Frequently Asked Questions (FAQs)
Here are some frequently asked questions about adding movies to Jellyfin:
FAQ 1: What video formats are supported by Jellyfin?
Jellyfin supports a wide range of video formats, including MKV, MP4, AVI, MOV, WMV, and many others. The actual playback capability depends on the client device and its supported codecs.
FAQ 2: Can I use local metadata files (e.g., .nfo)?
Yes, you can. Jellyfin supports local metadata files in the .nfo format. These files should be named the same as the movie file (e.g., Movie Title (Year).nfo) and placed in the same folder as the movie. Jellyfin will prioritize local metadata over online sources if it’s available.
FAQ 3: How do I add subtitles to my movies?
Jellyfin can download subtitles automatically or you can add them manually. For automatic downloads, ensure that the “Open Subtitles” or “Subscene” plugins are enabled in the “Plugins” section of the Dashboard. For manual addition, place the subtitle file (e.g., .srt, .sub) in the same folder as the movie file and ensure it has a similar name (e.g., Movie Title (Year).srt).
FAQ 4: Can I organize my movies into collections (e.g., Marvel Cinematic Universe)?
Yes, Jellyfin allows you to create collections. Within the web interface, select the movies you want to include in a collection, then choose “Add to Collection” and either select an existing collection or create a new one.
FAQ 5: How often should I scan my library for new movies?
Jellyfin can automatically scan for new content at specified intervals. You can configure this in the “Dashboard” -> “Scheduled Tasks” section. Adjust the frequency based on how often you add new movies.
FAQ 6: What’s the best way to handle multiple versions of the same movie (e.g., 4K, 1080p)?
The best approach is to keep each version in its own subfolder, using descriptive file names (e.g., Movie Title (Year) [4K].mkv and Movie Title (Year) [1080p].mkv). Jellyfin will typically recognize these as separate versions and allow you to choose which one to play.
FAQ 7: Can I restrict access to certain movies based on user?
Yes, Jellyfin supports user accounts and parental controls. You can create separate user accounts and configure content restrictions based on rating and other criteria.
FAQ 8: Why is Jellyfin not recognizing a specific codec?
Jellyfin relies on FFmpeg for transcoding. If Jellyfin doesn’t recognize a specific codec, ensure that FFmpeg is correctly installed and configured on your server. Check your server’s logs for error messages related to FFmpeg.
FAQ 9: Can I edit metadata directly within Jellyfin?
Yes, you can. Select a movie within your library and click the “Edit Metadata” button. This allows you to modify various fields, such as title, description, actors, and artwork.
FAQ 10: How do I add trailers to my movies?
You can place trailers in the same folder as the movie file. The trailer file name should follow a convention like Movie Title (Year)-trailer.mp4. Ensure trailers are enabled in the Jellyfin server settings.
FAQ 11: What happens if two movies have the same name?
If two movies have the same name, ensure that the year is included in the file name and folder name to differentiate them. Also, make sure they are in separate folders. Jellyfin should then be able to distinguish between them based on the year.
FAQ 12: How do I move my Jellyfin library to a new server?
Moving your Jellyfin library involves backing up your Jellyfin data directory (which contains your configuration files, metadata, and database) and restoring it on the new server. Refer to the Jellyfin documentation for detailed instructions on backing up and restoring your data.