Kodi Library Fix: Find Every Movie and Show

Name your folders the way Kodi expects, point it at them once, and get posters, plots and a phone remote instead of a wall of file names.

FREE$34.95UpdateStar PremiumShare a link to claimFriday night, popcorn ready, everyone on the sofa. You open Kodi, and instead of a neat wall of posters you get a bare list of file names like "mov_final_v2.mkv". Or worse: the library proudly shows a 1950s western where your sci-fi thriller should be. Kodi isn't broken. It just guesses based on folder and file names, and if those are messy, the guesses are too.

This guide sorts that out for good, using your own files and Kodi's built-in tools only. No add-on repositories, no streams of questionable origin. The steps were checked against Kodi 21 "Omega", the current stable branch, with the default Estuary skin.

Rule 1: One movie, one folder, title plus year

Kodi looks up every title with an information provider (a scraper) in an online movie database. The cleaner the name, the better the match. According to the Kodi wiki, movie folder names should contain only the title and, ideally, the year in parentheses at the end.

A layout that works:

  1. A main folder called Movies.
  2. Inside it, one folder per film, for example Avatar (2009).
  3. Inside that, the video file, for example Avatar (2009).mkv.

Put extra information like the source or resolution in the file name if you must, never in the folder name. The year is not decoration, by the way. It's what separates the original from the remake. Trailers in the same folder need the suffix -trailer (no spaces around the hyphen) so Kodi doesn't add them as separate movies.

Rule 2: Shows need seasons and episode numbers

TV shows live in their own main folder, separate from movies. Each show gets its own folder named like the scraper site lists it, again with the year: Angel (1999), for example. Inside, use season folders such as Season 01.

The episode number is what really counts. The safest pattern is S01E01, so a file called Angel (1999) S01E01.mkv is ideal. Kodi also understands variants like 1x01, but those match less reliably. Specials go into season 00, so the first special is S00E01. Got files with two episodes in one? Kodi only adds the episodes named in the file name, and the wiki recommends splitting such files into single episodes.

Renaming a big collection by hand is tedious, but you only do it once. Fix the folders first, the file names second.

Step 1: Add your movie folder as a source

  1. On the Kodi home screen, select Movies. If the library is empty, Kodi offers Enter files section. Otherwise go to Videos > Files.
  2. Select Add videos....
  3. Click Browse and go to your Movies folder. A network share on a NAS works too: use Add network location... if it doesn't show up on its own.
  4. Under Enter a name for this media source., type something clear like Movies.
  5. Confirm with OK.

Kodi's Add video source dialog with the Browse button and the media source name field highlighted Browse to your folder, then give the source a clear name before you press OK.

Step 2: Tell Kodi what's inside

Right after adding the source, the Set content dialog appears. This is the step that turns a folder into a library.

  1. Under This directory contains, choose Movies.
  2. Check the information provider. The default for films is The Movie Database Python, which is a good choice.
  3. Turn on Movies are in separate folders that match the movie title if you followed Rule 1. This tells Kodi to use the folder name for the lookup.
  4. Leave Scan recursively on if your films sit in subfolders, for example sorted by genre.
  5. Confirm with OK. Kodi starts scanning, and posters begin to appear.

Kodi's Set content dialog with This directory contains set to Movies and the separate folders option highlighted Set the content type to Movies and switch on the separate folders option if each film has its own folder.

Repeat both steps for your TV folder, but choose TV shows under This directory contains. The matching default provider is TMDb TV Shows. If you ever point a source at one single show, the option Selected folder contains a single TV show is there for exactly that case.

Made a mistake? Open the context menu on the source (right-click with a mouse, C on the keyboard) and choose Change content or Set content again. Kodi may ask Do you want to refresh information for all items within this path? Say yes if you changed the provider.

Step 3: Keep the library up to date

Kodi does not watch your folders around the clock. When you copy new films to the drive, you need to tell it.

  1. Open the context menu on the source in Files and choose Scan for new content. That scans only this folder.
  2. Or use Update library in the side menu of the Movies or TV shows view to scan everything.
  3. For full automation, open Settings > Media > Library and turn on Update library on startup. Every time Kodi starts, it checks for new files.

If you delete or move files outside Kodi, old entries stay behind as dead posters. Clean library in the same settings section removes items whose files no longer exist. Make sure external drives and the NAS are connected before you run it, otherwise Kodi treats their content as missing.

Step 4: Fix a title that's still wrong

Even with clean names, a film occasionally lands on the wrong entry, often because it was released under a different original title. Open the movie's information page with I, select Refresh and pick the right title from the list or type in a different one. If nothing shows up at all, check the event log after an update library run, which lists files Kodi skipped.

Step 5: Turn your phone into the official remote

Squinting at a keyboard on the sofa is no fun. Kodi has official remote apps: Kore for Android and Official Kodi Remote for iPhone and iPad. Both talk to Kodi over your home network, so Kodi has to allow it first.

  1. Go to Settings > Services > Control.
  2. Turn on Allow remote control via HTTP.
  3. Leave Require authentication on and set a Username and Password. Note the Port, which is 8080 by default.
  4. Turn on Allow remote control from applications on other systems.
  5. Look up Kodi's IP address under Settings > System information > Network.

Open the app on your phone, let it search for Kodi or enter the IP address, port, user name and password by hand, and you're done.

One warning from Kodi's own settings description: the remote control options give anyone on your network full control of Kodi and the device. Fine at home, but never open these ports to the internet.

Our verdict

This setup suits anyone with a hard drive or NAS full of their own rips and recordings who is tired of scrolling through file names. The one thing to do today: pick five films, put each in its own Title (Year) folder, add that folder as a source with Movies are in separate folders that match the movie title switched on, and watch the posters appear. Then do the rest of the collection on a rainy afternoon.

Related on UpdateStar

about author