Kodi Movie File Naming: Organise Folders and Fix Matches

For reliable Kodi movie matching, start with a clear title and release year, then give each movie its own folder. Test a small sample before renaming an entire collection. A consistent structure is easier to diagnose than a mixture of abbreviations, release labels and nested directories.

This guide addresses a personal, authorised media library. The examples are fictional, not references to downloadable movies.

A simple folder and filename example

Kodi recommends a separate folder for each movie and the Movie Name (Year) naming format. The title and year should match the information provider used by your scraper. See the official movie naming documentation.

Movies/
  Example Film (2020)/
    Example Film (2020).mkv
  Another Example (2024)/
    Another Example (2024).mp4

Keep the real file extension. Renaming .mp4 to .mkv does not convert the video. This example illustrates organisation only, not a recommendation to modify a media format.

Test one movie before changing hundreds

1. Preserve the starting point. Back up the configuration and keep a record of original paths before bulk changes.
2. Choose a manageable sample. Include one title that already matches and one that does not, if available.
3. Check the reference listing. Confirm the spelling and year against the configured metadata provider, especially for remakes.
4. Apply consistent names. Use the title and year for the movie folder and its main video file.
5. Inspect the result in Kodi. Confirm that the correct movie, year and artwork appear before expanding the change.

When the title still matches incorrectly

Distinguish a naming problem from a source-configuration problem. A well-named movie under the wrong type of source still needs investigation. Write down which source and metadata provider you used rather than changing filenames repeatedly.

For titles with similar names, compare the provider’s entry carefully. Kodi documents optional filename identifiers for supported scrapers and versions, but these are not a universal replacement for clear names. Check your specific scraper before using an identifier copied from another website.

If one test succeeds and another fails, record that difference. A concrete pair of examples is useful evidence when seeking help.

Avoid a destructive cleanup

Do not delete media files merely because a library entry is duplicated or incorrect. First identify which physical files the entries represent. Keep experiments in a small, reversible sample rather than combining renaming, moving and database cleanup in one operation.

For a mixed collection, use a separate TV episode naming workflow. Before larger changes, follow our backup checklist.

Frequently asked questions

Does every movie need a release year?

The documented format includes the year. It is particularly useful when multiple films share a title.

Can renaming fix a file that will not play?

Library identification and playback are separate. Correct metadata does not prove that the video file is readable or compatible.