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.

    Updated November 22, 202611 min read

    How Infuse identifies your videos

    Infuse gets videos in two very different ways, and the naming rules only fully apply to the first one.

    SourceWhere the metadata comes fromDo file names matter?
    File share: SMB, NFS, WebDAV, FTP/SFTP, UPnP/DLNA, cloud services, files on the deviceInfuse matches each file on TMDB itselfYes, completely
    Media server: Plex, Jellyfin or EmbyInfuse shows the server's metadataYes, 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.

    Single movie files (all valid)
    Movies/
    ├── Pulp Fiction (1994).mkv
    ├── Dune (2021).mkv
    ├── Dune (1984).mkv
    └── The Matrix (1999).mp4

    You 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.

    One folder per movie, with related files
    Movies/
    └── Pulp Fiction (1994)/
        ├── Pulp Fiction (1994).mkv
        ├── Pulp Fiction (1994).srt
        ├── Pulp Fiction (1994).jpg
        ├── Pulp Fiction (1994)-fanart.jpg
        └── Pulp Fiction (1994).nfo

    Force 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).

    Movie names with an ID
    Inception (2010) {tmdb-27205}.mkv
    Inception (2010) {imdb-tt1375666}.mkv

    Plex 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):

    StyleExample
    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:

    Recommended TV folder structure
    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.mkv

    Why 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.

    Specials in season 00
    TV Shows/
    └── Breaking Bad/
        └── Specials/
            └── Breaking Bad - S00E01.mkv

    Miniseries 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.

    SuffixShown as
    -trailerTrailer
    -behindthescenesBehind the scenes
    -deletedDeleted scene
    -featuretteFeaturette
    -interviewInterview
    -sceneScene
    -shortShort
    -otherOther extra
    Extras with suffixes
    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.mkv

    When 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.

    Extras in typed subfolders
    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.mp4

    Infuse 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.

    Versions and custom editions
    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}.mp4

    The {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.

    Multi-part movie
    Movies/
    └── Lawrence of Arabia (1962)/
        ├── Lawrence of Arabia (1962) part1.mkv
        └── Lawrence of Arabia (1962) part2.mkv

    External 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.

    Firecore's documented pattern
    Inception (2010).mkv
    Inception (2010).srt
    
    Inception (2010).mkv
    Inception (2010)-en.srt
    Inception (2010)-de.srt
    Inception (2010)-fr.srt

    Firecore'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 titlesInfuse, on TMDBThe server
    Naming rules to followThis guideThe server's rules
    Where to fix a wrong matchEdit Metadata in InfuseOn 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

    1. Open the details page of the wrongly matched movie or show.
    2. Open the three-dots menu (on Apple TV it sits near the Play button; on other devices look in the upper right corner).
    3. Choose Edit Metadata.
    4. 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

    SymptomLikely causeFix
    Movie matched to a remake or an older filmNo year in the nameAdd the year: Dune (2021).mkv, or a {tmdb-...} ID
    Episodes land in Other or as moviesNo season and episode marker, or folder-only naming on Google Drive, OneDrive, Box or UPnPRename to Show - S01E01.ext
    A movie is treated as a TV episodeA 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 episodesAbsolute numbering without a seasonUse S01E01 following TMDB's seasons
    One show appears twiceDifferent spellings of the show name across filesUse the same exact title on every file
    No metadata at all for a titleTMDB has no entry, or the title is flagged adult on TMDBAdd or fix the entry on TMDB (free account), or use local artwork and NFO
    Changes do not show upInfuse has not rescanned yetTap 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.

    1. 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.
    2. 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.
    3. Choose the Plex or Jellyfin preset. Movies become Dune (2021).mkv, episodes Breaking Bad - S01E01 - Pilot.mkv and anime Attack 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.
    4. 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

    Frequently asked questions

    What is the correct Infuse naming convention for movies?
    Use the TMDB title followed by the year in parentheses, for example Pulp Fiction (1994).mkv. The year is optional for Infuse, but it prevents mix-ups between remakes and films with the same title. A folder per movie is optional too; it is useful when you keep subtitles, artwork or extras with the film.
    How should I name TV shows for Infuse?
    Put the show name and an S01E01 marker in each file name, for example Breaking Bad - S01E01 - Pilot.mkv, and store episodes in Show/Season 01/ folders. Infuse also accepts 1x01 and 101, but S01E01 is the clearest and works with every other media app. Specials go in season 00.
    Why is Infuse not recognizing my movies?
    Usually the name is missing the year, contains a number pattern that looks like an episode, or the title on TMDB is spelled differently. Rename the file to Title (Year).ext, add a {tmdb-ID} tag if it still fails, then refresh the library. If TMDB has no entry for the film, Infuse cannot match it until someone adds it there.
    How do I fix wrong metadata in Infuse?
    Open the title's details page, open the three-dots menu, choose Edit Metadata and pick the correct match or search for it. For a show, fixing one episode corrects the whole series. If Infuse is connected to Plex, Jellyfin or Emby, fix the match on the server instead, because Infuse displays the server's metadata.
    Does Infuse support multi-episode files?
    Firecore's naming documentation does not list a multi-episode pattern, and users report that a file named S01E01-E02 is shown as the first episode only. Name the file after its first episode or split it into separate episodes. When the files come from a Plex, Jellyfin or Emby server, the server's multi-episode support applies.
    How do I add extras like trailers and deleted scenes in Infuse?
    Name the clip like the movie and add a suffix such as -trailer, -deleted or -featurette, for example Inception (2010)-trailer.mp4. Alternatively, put the clips in subfolders named Trailers, Deleted Scenes, Interviews or Behind The Scenes inside the movie's folder. Plex, Jellyfin and Emby extras naming styles are supported as well.
    How do I name subtitle files for Infuse?
    Give the subtitle the same name as the video and put it in the same folder, for example Inception (2010).srt. For several languages, add a code: Firecore's example is Inception (2010)-en.srt, and the Plex style Inception (2010).en.srt generally works too. External subtitles do not work over UPnP/DLNA.
    Do I need a special folder structure for Infuse?
    Not strictly: Infuse can match well-named files sitting in a single folder. A Movies/Title (Year)/ and TV Shows/Show/Season 01/ structure is still recommended because it keeps sidecar files together, enables folder-based extras and season artwork, and matches what Plex and Jellyfin expect if you add a server later.