iCouldPlay movie matching: use titles and years to reduce poster mistakes

Movie filenames often combine title, year, resolution, and a long string of source details. iCouldPlay must identify a work from that text when organizing metadata. Make the title and year clear first, then scan a small directory to reduce confusion with a same-named film.

Choose three files as organization samples

Choose three files from your movie folder: a distinctly named film, one sharing its title with another work, and a file with many technical tags. Copy them into a separate practice directory and retain a list of original names. Do not start by batch-renaming a long-established library with viewing progress.

Before matching, confirm that each file plays and identify its actual work. Filenames can be wrong too; finding a poster online does not establish the video's identity. Check the opening, your collection records, or original information to give later naming a clear basis.

Home videos, courses, and your own edited clips need not be forced into public movie metadata. Give them clear dates and content names. Absence of a movie poster does not prevent use as personal videos.

Make title and year the primary information

A simple starting point is “Title (Year).extension,” such as “Example Film (2020).mkv.” Replace the example title with the actual work. The year generally means release year, not the download year or the year you moved it to the NAS.

Place resolution or edition details after the title and year and use a consistent rule within a directory. Use one stable title instead of stacking Chinese, English, several translations, and promotional phrases together. More information does not always help matching; conflicting names can increase ambiguity.

Keep the original extension when renaming. Changing MKV to MP4 does not standardize the format: extensions and internal encoding differ, and renaming does not improve image quality. If the system hides extensions, check its display behavior first to avoid a double extension.

Check year and type first for same-named movies

Same-named movies can be decades apart or come from different countries or creators. The year narrows the search, but also check type and synopsis. A movie and series sharing a title cannot use one metadata card as proof of a correct match.

For an original film and remake, identify your file's year before naming it. Do not change the year merely because you prefer another version's poster. Matching should describe the current file; an attractive poster and correct identity are separate matters.

Extended and director's cuts may share one movie record. Preserve the edition in your filenames while recognizing that public metadata duration may not precisely match every cut. A difference of a few minutes alone does not prove the title is wrong.

Check three things after scanning the samples

Connect the small directory to iCouldPlay, then follow Folder-scanning tutorial to complete the scan. After processing finishes, open each sample's details and check title and year, then poster and synopsis. Finally play a known scene to confirm that the card points to the corresponding file.

If the title is correct but the poster is absent, the image or metadata may simply not have loaded yet; do not rename immediately. If poster, year, and synopsis belong to another work, address a wrong match. Separating missing information from someone else's information makes the next action clearer.

If no match is found, you can still play by filename. A metadata service returning a result and a video being readable are separate paths. Do not delete a usable original just to obtain a poster.

Preserve associations before changing library files

Renaming or moving a file with viewing history may make it appear as a new path. Record the old name, folder, viewing position, and required subtitles, then work on a copy. Identical content does not guarantee that the app and server will preserve every old association.

A scan does not necessarily overwrite existing metadata. If an entry has already matched, rescanning may not select a new poster. When testing a new name, first check whether the app actually reread the file. Repeated scans of an unchanged folder may not correct existing results.

For server libraries such as Emby or Jellyfin, the server may maintain most metadata. Check files and metadata in that source first, then return to iCouldPlay. Local-file naming and scanning are not universal correction controls for every server client.

Common naming mistakes

Does any four-digit number in a name have to be a year? Not necessarily. A number may belong to the title, resolution, or an identifier. Establish the year from the work's information and express it clearly rather than mechanically deleting every number.

What if a movie is split into two files? Retain markers distinguishing the parts and verify their playback order individually. Public movie metadata usually describes the complete work, not the completeness of each segment file. If combining them yourself, save a separate result and check the joins.

What if my own short film keeps matching a commercial movie? Make its name more specific, for example with an event and recording date, and keep it as a personal video. No matching public metadata is normal; the library need not be filled with incorrect posters.

Expand from a small folder to the whole collection

Once the three samples have clear results, organize the remaining files in batches. Spot-check same-named works and different cuts after each batch. Record error patterns before changing rules, catching naming issues within dozens of files rather than reworking hundreds of entries.

For incorrect metadata, continue with Matching-correction tutorial. Television series have separate season and episode conventions; see Series-naming tutorial; do not treat every video as a standalone movie.

Information checked on October 23, 2026. The public release is iCouldPlay 1.1.0, requiring iOS / iPadOS 13.0 or later. See Official App Store page and Apple release information. These naming patterns support organization and verification; they do not guarantee automatic matching of every name.