Infuse guide
Infuse naming guide: how to name movies, TV shows, extras and subtitles so Infuse gets them right
Infuse by Firecore is one of the nicest video players on Apple TV, iPhone, iPad and Mac. When you point it at a folder of videos, it reads each file name, looks the title up on The Movie Database (TMDB) and builds a library with posters, plots and cast. When the name is clear, it just works. When it is not, you get a movie with the wrong poster, a show split into two, or a file sitting in the Other category with no artwork.
This guide collects the naming rules from Firecore's own support articles and turns them into examples you can copy: movies, TV shows, specials, anime, extras, multiple versions, multi-part films and external subtitles. It also explains when naming matters less (when Infuse is connected to Plex, Jellyfin or Emby) and how to fix a wrong match with the Edit Metadata option.
How Infuse identifies your videos
Infuse gets videos in two very different ways, and the naming rules only fully apply to the first one.
| Source | Where the metadata comes from | Do file names matter? |
|---|---|---|
| File share: SMB, NFS, WebDAV, FTP/SFTP, UPnP/DLNA, cloud services, files on the device | Infuse matches each file on TMDB itself | Yes, completely |
| Media server: Plex, Jellyfin or Emby | Infuse shows the server's metadata | Yes, but the server's naming rules are the ones that count |
With a file share, Infuse indexes the folder, parses each name and matches it on TMDB for movies, TV shows and anime. The Metadata Fetching option is on by default and is what downloads posters, cast and database IDs. Separators are flexible: periods, spaces, underscores and dashes are treated the same, so Pulp.Fiction.1994.mkv and Pulp Fiction (1994).mkv both work.
Three things decide whether a match succeeds: a clean title, the year for movies, and a season and episode marker for anything episodic. Release tags such as 1080p, WEB-DL, x265 or a group name after those elements are usually tolerated, but the cleaner the name, the fewer surprises.
Avoid these characters in file and folder names: " \ / : | < > * ?. Firecore lists them as problem characters, and many NAS devices and Windows refuse them anyway. Write Mission Impossible - Dead Reckoning Part One (2023).mkv rather than keeping the colon from the official title.
Naming movies for Infuse
The safest movie name is the TMDB title followed by the release year in parentheses. The year is officially optional, but it is what separates remakes and same-name films: without it, Dune.mkv can match the 1984 film or the 2021 one.
Movies/
├── Pulp Fiction (1994).mkv
├── Dune (2021).mkv
├── Dune (1984).mkv
└── The Matrix (1999).mp4You do not need a folder per movie for Infuse to work. A folder becomes useful when you keep related files with the film: subtitles, local artwork, an NFO file or extras. Name the folder like the movie.
Movies/
└── Pulp Fiction (1994)/
├── Pulp Fiction (1994).mkv
├── Pulp Fiction (1994).srt
├── Pulp Fiction (1994).jpg
├── Pulp Fiction (1994)-fanart.jpg
└── Pulp Fiction (1994).nfoForce an exact match with a TMDB or IMDb ID
When a title is ambiguous or keeps matching the wrong film, add the database ID in curly brackets using the {source-id} structure. Infuse then skips the guessing. The ID is the number in the TMDB address of the movie page (or the tt number on IMDb).
Inception (2010) {tmdb-27205}.mkv
Inception (2010) {imdb-tt1375666}.mkvPlex reads the same {tmdb-27205} tag, so this fix keeps working if you later point a Plex server at the same folder. See the Plex naming guide for the Plex syntax.
Infuse can also use your own poster (Pulp Fiction (1994).jpg) and an .nfo or .xml file with the same name as the movie instead of TMDB data. Turn on Prefer Local Artwork in the Metadata & Artwork settings for the images to win.
Naming TV shows, specials and anime
Infuse recognizes most common episode patterns. Firecore recommends putting the show name and the season and episode in the file name itself, in one of these styles (anything after the marker is ignored):
| Style | Example |
|---|---|
| Show.Name.S##E## | Breaking.Bad.S01E01.Pilot.1080p.mkv |
| Show.Name.#x## | Breaking.Bad.1x01.mkv |
| Show.Name.### | Breaking.Bad.101.mkv |
The S01E01 style is the one to standardize on: it is unambiguous, it handles seasons above 9 and episodes above 99, and it is also what Plex, Jellyfin, Emby and Kodi expect. Combined with the classic folder layout, it gives you a library every player understands:
TV Shows/
├── Breaking Bad/
│ ├── Season 01/
│ │ ├── Breaking Bad - S01E01 - Pilot.mkv
│ │ └── Breaking Bad - S01E02 - Cat's in the Bag.mkv
│ └── Season 02/
│ └── Breaking Bad - S02E01 - Seven Thirty-Seven.mkv
└── The Office (US)/
└── Season 01/
└── The Office (US) - S01E01 - Pilot.mkvWhy the show name belongs in the file name
Infuse can also read layouts where only the folder carries the show name, such as Breaking Bad/Season 1/02 Cat's in the Bag.mkv or Breaking Bad/Any Folder/S01E02.mkv. Firecore notes that these folder-based patterns do not work over UPnP/DLNA, Google Drive, OneDrive or Box. Naming every file Show - S01E01 avoids the problem on every source, and it means a file still identifies itself if it ever gets moved out of its folder.
When two shows share a title, add the year to the show name, like Doctor Who (2005) or Battlestar Galactica (2004), so the match goes to the right series. Use the exact title and year shown on TMDB.
Specials
Specials go in season 00, using the number TMDB gives them on the show's Specials season page. A Christmas special listed as episode 3 of the specials becomes S00E03.
TV Shows/
└── Breaking Bad/
└── Specials/
└── Breaking Bad - S00E01.mkvMiniseries and anime
A miniseries is treated like any other show: use Season 01 and S01E01. Anime is classified as a TV series on TMDB, so Infuse needs a season number in the file name even for shows that only use absolute numbering. Attack on Titan - S01E01.mkv matches; Attack on Titan - 01.mkv often does not. For long shows such as One Piece, check how TMDB splits the episodes into seasons and follow that, not the fansub numbering. The anime renaming guide covers absolute versus seasonal numbering in more detail.
Multi-episode files
This is the weak spot. Firecore's naming documentation has no multi-episode pattern, and on its community forum multi-episode support has been a long-standing feature request rather than something documented. Users generally report that a file named S01E01-E02 shows up as the first episode only. The practical options are to name the file after its first episode and accept that the second one looks missing, or to split the file into two episodes. If you serve the files through Plex, Jellyfin or Emby, the server's own multi-episode handling applies instead.
Extras, multiple versions and multi-part movies
Extras (bonus content)
Infuse shows trailers, featurettes and deleted scenes on the movie or episode page when they are named in a way it recognizes. The simplest method is a suffix: give the clip the same name as the movie or episode and append the extra type.
| Suffix | Shown as |
|---|---|
-trailer | Trailer |
-behindthescenes | Behind the scenes |
-deleted | Deleted scene |
-featurette | Featurette |
-interview | Interview |
-scene | Scene |
-short | Short |
-other | Other extra |
Movies/
├── Inception (2010).mkv
├── Inception (2010)-trailer.mp4
└── Inception (2010)-featurette.mkv
TV Shows/
└── Mad Men/
└── Season 01/
├── Mad Men - S01E01.mkv
└── Mad Men - S01E01-trailer.mkvWhen a movie has its own folder, you can instead put extras in subfolders named after their type. The clip names inside are free, which is handy for long lists of deleted scenes.
Movies/
└── Inception (2010)/
├── Inception (2010).mkv
├── Behind The Scenes/
│ └── Making the film.mkv
├── Deleted Scenes/
│ └── Beach landing.mp4
├── Interviews/
│ └── Leonardo DiCaprio.mp4
├── Scenes/
│ └── Dreams.mp4
└── Trailers/
└── Official Trailer.mp4Infuse also supports the Plex, Jellyfin and Emby extras naming styles, so a library already organized with folders such as Featurettes, Shorts or Other for one of those servers usually needs no changes.
Multiple versions of the same movie
If you keep two cuts of a film, Infuse groups them under one title and lets you choose at playback when the name contains a recognized tag: Director's Cut, Extended Cut, Theatrical Cut, Final Cut, Unrated Cut, Uncut, TV Cut, Special Edition, Ultimate Edition, IMAX, Black & White, Wide Screen and Full Screen. For anything else, use a custom edition tag in curly brackets.
Movies/
└── Blade Runner (1982)/
├── Blade Runner (1982) Final Cut.mkv
└── Blade Runner (1982) Theatrical Cut.mkv
Movies/
└── Get Out (2017)/
├── Get Out (2017) {edition-Regular Ending}.mp4
└── Get Out (2017) {edition-Alternate Ending}.mp4The {edition-...} syntax is the same one Plex uses, so it is a good choice if both apps read the same folder. Edition tags are only visible when you browse through the Infuse library.
Movies split into several files
A film spread over two files (an old two-disc rip, for example) is joined when each part carries a part tag: cd1, disc1, disk1, dvd1, part1 or pt1.
Movies/
└── Lawrence of Arabia (1962)/
├── Lawrence of Arabia (1962) part1.mkv
└── Lawrence of Arabia (1962) part2.mkvExternal subtitles naming in Infuse
Embedded subtitle tracks need nothing from you. For external files, Infuse picks them up automatically when two conditions are met: the subtitle has the same base name as the video, and it sits in the same folder.
Inception (2010).mkv
Inception (2010).srt
Inception (2010).mkv
Inception (2010)-en.srt
Inception (2010)-de.srt
Inception (2010)-fr.srtFirecore's own example adds the language with a hyphen (-en.srt). The dot style used by Plex and Jellyfin, Inception (2010).en.srt, is generally picked up as well, but users report that the subtitle menu sometimes shows the raw file name or code instead of a clean language label. If Infuse is your only player, follow Firecore's hyphen style. If the same folder also feeds Plex or Jellyfin, the dot style with a two-letter code is the better shared choice; the subtitle naming guide compares the conventions side by side.
- Infuse reads many subtitle formats, such as SRT, ASS/SSA and VTT. SRT is the most portable choice.
- External subtitles are not supported over UPnP/DLNA. Use SMB, NFS or WebDAV if you rely on sidecar files.
- When you cast with AirPlay or Google Cast, only text-based subtitles work, so image formats like VobSub will not show.
Do not count on forced or sdh in the file name. Infuse users report that it does not reliably treat an external file named Movie.en.forced.srt as forced, and SDH and regular files in the same language can appear with identical labels. If forced subtitles matter, an embedded forced track is more dependable.
No subtitle file at all? During playback, open the Subtitles tab (gear button on iPhone, iPad and Mac, swipe down on Apple TV) and choose Get More... to search OpenSubtitles from inside Infuse.
Infuse with Plex, Jellyfin or Emby versus a file share
Infuse can connect to a Plex, Jellyfin or Emby server instead of reading the files directly. In that case it shows the metadata the server already has, rather than doing its own TMDB matching. This changes where you fix problems.
| File share (SMB, NFS, WebDAV...) | Plex, Jellyfin or Emby server | |
|---|---|---|
| Who matches titles | Infuse, on TMDB | The server |
| Naming rules to follow | This guide | The server's rules |
| Where to fix a wrong match | Edit Metadata in Infuse | On the server (Fix Match in Plex, Identify in Jellyfin and Emby) |
Server connections come in two flavors. Direct Mode (since Infuse 7.7) fetches the server's information on demand and shows its native libraries and collections; it suits large libraries. Library Mode indexes the server's content into the Infuse library alongside your other sources and works better offline. You switch with the Library Mode option in the Advanced tab when you add or edit the server. Firecore recommends installing the InfuseSync plugin on Emby and Jellyfin when you use Library Mode.
The good news is that the rules overlap almost completely. Title (Year) for movies, Show/Season 01/Show - S01E01.ext for episodes, {edition-...} tags and typed extras folders work in Infuse, Plex and Jellyfin alike. If you are building a library for a server, follow the Plex naming guide, the Jellyfin naming guide or the Emby naming guide, and Infuse will be happy too.
Pick one route per library: either the server or a direct share of the same folder, not both. That way metadata, watched status and fixes all come from a single place.
Infuse not recognizing movies or showing wrong metadata: how to fix it
Fix one title with Edit Metadata
- Open the details page of the wrongly matched movie or show.
- Open the three-dots menu (on Apple TV it sits near the Play button; on other devices look in the upper right corner).
- Choose Edit Metadata.
- Pick the right title from the list, or type in the Search box if it is not there.
For a TV show, correcting a single episode is enough: Infuse rematches the rest of the series. Keep in mind that this correction lives in Infuse, not in the file. Renaming the file properly (or adding a {tmdb-...} ID) is the fix that survives a reinstall, a new device or a switch to another player.
Common causes and their fixes
| Symptom | Likely cause | Fix |
|---|---|---|
| Movie matched to a remake or an older film | No year in the name | Add the year: Dune (2021).mkv, or a {tmdb-...} ID |
| Episodes land in Other or as movies | No season and episode marker, or folder-only naming on Google Drive, OneDrive, Box or UPnP | Rename to Show - S01E01.ext |
| A movie is treated as a TV episode | A number pattern in the title, like the film 10x10, looks like #x## | Add the year and, if needed, the TMDB ID |
| Anime has no artwork or wrong episodes | Absolute numbering without a season | Use S01E01 following TMDB's seasons |
| One show appears twice | Different spellings of the show name across files | Use the same exact title on every file |
| No metadata at all for a title | TMDB has no entry, or the title is flagged adult on TMDB | Add or fix the entry on TMDB (free account), or use local artwork and NFO |
| Changes do not show up | Infuse has not rescanned yet | Tap the refresh icon on the home screen or run a scan from Settings > Library |
If TMDB itself has a wrong poster, a missing episode or a bad title, correct it with a free TMDB account; Firecore says such changes usually reach Infuse within about a day. Also check that Metadata Fetching is still enabled in Infuse's settings.
Renaming a whole library for Infuse with RenameFlow
Fixing a few names by hand is fine. Turning hundreds of release names like Breaking.Bad.S01E01.720p.BluRay.x264-DEMAND.mkv into clean names is where a tool helps. RenameFlow is a web app that runs in Chrome, Edge or Opera on a desktop computer (Windows, macOS or Linux), with nothing to install. It does not run in Safari, so on a Mac use one of those three browsers. Files are renamed in place on your disk and are never uploaded; only the detected titles are sent to the metadata services.
- Open the folder that holds your videos. RenameFlow reads the release names (title, year, season, episode, quality, source, codec, group), including multi-episode markers like
S01E01-E02. - Check the proposed matches. Movies and shows are looked up on TMDB or TheTVDB, anime on AniList, and you confirm or change each match. Since Infuse uses TMDB, choosing the TMDB match keeps episode numbers consistent with what Infuse expects.
- Choose the Plex or Jellyfin preset. Movies become
Dune (2021).mkv, episodesBreaking Bad - S01E01 - Pilot.mkvand animeAttack on Titan - S01E01.mkv, all names Infuse matches. Avoid the Kodi and Simple presets for anime in Infuse: they use absolute numbering (Attack on Titan - 01.mkv), which Infuse handles poorly. - Rename, then refresh the library in Infuse.
One honest limit: RenameFlow renames files only. It does not create, move or rename folders. If you want the Breaking Bad/Season 01/ or Dune (2021)/ structure, create those folders yourself and move the files in. Because the show name and episode marker are in every file name, Infuse still matches the files correctly before you sort them into folders.
The Subtitles module can also find subtitles on OpenSubtitles and save them next to your videos, so Infuse picks them up as sidecar files. The free plan renames 15 files a day and includes 3 subtitle downloads a month; custom naming patterns (for example to keep the quality in the name) and unlimited subtitles are on the paid plans described on the pricing page.
Give Infuse names it can match
Open a folder in RenameFlow, confirm each TMDB match and rename movies and episodes to Infuse-friendly names in a few clicks, right on your own disk.
Try RenameFlow free