Anime guide

    How to rename anime episodes: absolute numbering, seasons and the naming Plex, Jellyfin and Kodi expect

    Anime breaks the rules that work for regular TV. A file called [SubsPlease] Sousou no Frieren - 01 (1080p) [A1B2C3D4].mkv has a group tag, a Japanese title, no season number and a checksum, and the databases behind your media server do not even agree on how many seasons Attack on Titan has.

    This guide explains how release names are built, when to use absolute or seasonal numbering, how TheTVDB, TMDB, AniDB and AniList split the same show, and the exact folder and file names Plex, Jellyfin, Emby and Kodi expect. Every example uses real shows, so you can copy the pattern straight into your library.

    Updated November 22, 202613 min read

    How fansub and release names are built

    Most anime files you download follow the same layout, popularized by fansub groups and now used by simulcast rippers such as SubsPlease and Erai-raws: [Group] Title - Episode (Resolution) [Checksum].ext. Each part has a meaning, and only two of them matter to your media server.

    A typical anime release name
    [SubsPlease] Sousou no Frieren - 01v2 (1080p) [A1B2C3D4].mkv
    
    group       [SubsPlease]
    title       Sousou no Frieren
    episode     01 (v2 = second version)
    resolution  1080p
    checksum    A1B2C3D4
    PartExampleWhat it means
    Group[SubsPlease]Who released the file. Useless to Plex or Jellyfin, and it often confuses their title matching.
    TitleSousou no FrierenUsually the romaji (romanized Japanese) title. Your database may list the show as Frieren: Beyond Journey's End.
    Episode- 01A bare episode number with no season. It is the count inside that release's entry, not necessarily the season number your server uses.
    Versionv2A corrected re-release. Keep only the newest version and drop the suffix.
    Quality(1080p), [HEVC], [BD]Resolution, codec or source. Optional in the final name.
    Checksum[A1B2C3D4]The CRC32 of the file, 8 hex characters, used to verify a download. Not needed after renaming.

    Batches usually arrive as a folder like [Group] Kimetsu no Yaiba (01-26) (BD 1080p) [Batch]. Other common tags are [Dual Audio], [Multi-Subs] and [10bit].

    Groups are not consistent about later seasons. One release of a second season may restart at - 01 while another continues the count from season one, so the same episode can be - 13 from one group and - 50 from another. Always check which numbering the files use before you rename them.

    If you care about the checksum, verify the files with a CRC tool before renaming. Once the [A1B2C3D4] tag is gone you can no longer compare it at a glance.

    Absolute vs seasonal numbering, and when to use each

    Seasonal numbering is what Western TV uses: S04E01 means season 4, episode 1. Absolute numbering counts every episode of the show from the start, ignoring seasons: the same Attack on Titan episode is episode 60 in absolute order, because seasons 1 to 3 have 25, 12 and 22 episodes.

    Attack on Titan, "The Other Side of the Sea"Name
    Seasonal (TMDB and TheTVDB)Attack on Titan - S04E01.mkv
    AbsoluteAttack on Titan - 060.mkv
    AniList / AniDB entryEpisode 1 of Shingeki no Kyojin: The Final Season

    Neither is more correct. The right choice is the numbering your metadata source uses, because your server simply looks up the numbers you give it.

    • Use seasonal numbering for most shows in Plex, Jellyfin and Emby with their default TMDB or TheTVDB metadata. It is the safest option and works with every client.
    • Use absolute numbering for very long single-entry shows such as One Piece, Detective Conan or Naruto when you switch the show to an absolute order (Plex's TheTVDB (Absolute) order, Kodi's TheTVDB scraper set to Absolute), or when you use an anime-specific agent like HAMA or Shoko.
    • Never mix both inside one show. Half the files as S02E05 and half as - 30 gives duplicates and missing episodes.

    The general rules for season folders and SxxEyy numbers are the same as for any series, covered in how to rename TV episodes. The rest of this guide focuses on what is special about anime.

    Why TheTVDB, TMDB, AniDB and AniList disagree about seasons

    Japanese TV airs in cours, blocks of about three months that usually hold 10 to 13 episodes. A show might air one cour, pause for a year, then air a second cour that Japan calls "Part 2". Western TV databases tend to merge cours into seasons. Anime databases give each broadcast run its own entry.

    • TheTVDB and TMDB organize a show into seasons, like any series. They are what Plex, Jellyfin, Emby, Kodi and Sonarr use by default, but they do not always agree with each other.
    • AniDB and AniList (like MyAnimeList) create a separate entry for each season, cour or part, each numbered from episode 1. Long-running shows stay a single entry.

    Example: Attack on Titan

    Broadcast runTheTVDBTMDBAniList / AniDB
    Season 1 (2013, 25 eps)S01E01 to S01E25S01E01 to S01E25Own entry, 1 to 25
    Season 2 (2017, 12 eps)S02E01 to S02E12S02E01 to S02E12Own entry, 1 to 12
    Season 3 Part 1 (2018, 12 eps)S03E01 to S03E12S03E01 to S03E12Own entry, 1 to 12
    Season 3 Part 2 (2019, 10 eps)S03E13 to S03E22S03E13 to S03E22Own entry, 1 to 10
    The Final Season (2020 to 2021, 16 eps)S04E01 to S04E16S04E01 to S04E16Own entry, 1 to 16
    The Final Season Part 2 (2022, 12 eps)S04E17 to S04E28S04E17 to S04E28Own entry, 1 to 12
    The Final Chapters (2023, 2 specials)S04E29 and S04E30Not in season 4 (listed with the specials)Own entries

    So a SubsPlease file named Shingeki no Kyojin Season 3 Part 2 - 01 must become S03E13 for Plex or Jellyfin, not S03E01. And the last episode of the series is S04E30 on TheTVDB but a special on TMDB.

    Example: One Piece

    One Piece is a single entry with more than 1,100 episodes on AniList and AniDB, so absolute numbers are natural. TMDB splits it into seasons by story arc (season 1 is the 61-episode East Blue arc), while TheTVDB uses much shorter seasons (season 1 has 8 episodes and season 2 has 22). Counts as of November 2026:

    Absolute episodeAniList / AniDBTMDBTheTVDB
    11S01E01S01E01
    99S01E09S02E01
    3131S01E31S03E01

    This is why "One Piece episode numbering in Plex" is such a common question: the same file is correct under one ordering and wrong under another. Pick the source your server uses first, then look up the SxxEyy numbers on that site, not on a wiki or a fansub tracker.

    Anime naming for Plex (with or without HAMA)

    Plex's built-in Plex TV Series agent matches anime like any other show. The library default ordering is TMDB's aired order; you can change it in the library's Edit > Advanced > Episode ordering, and since Plex Media Server 1.40.4 you can also pick another order per show from the show's own Edit > Advanced tab. Orders offered include TheTVDB aired order and TheTVDB (Absolute).

    Option 1: seasonal numbering (recommended)

    Plex, TMDB aired order
    Anime/
    └── Attack on Titan (2013) {tmdb-1429}/
        ├── Season 01/
        │   └── Attack on Titan (2013) - S01E01.mkv
        ├── Season 03/
        │   ├── Attack on Titan (2013) - S03E12.mkv
        │   └── Attack on Titan (2013) - S03E13.mkv
        └── Season 04/
            └── Attack on Titan (2013) - S04E17.mkv

    The {tmdb-1429} tag in the folder name is optional but forces the right match. Use {tvdb-267440} instead if the show uses TheTVDB ordering. Use the English or romaji title, whichever your metadata source lists; the ID tag removes any doubt.

    Option 2: absolute numbering with TheTVDB (Absolute)

    In TheTVDB's absolute order, every episode sits in season 1. Name the files with S01E followed by the absolute number, put them in Season 01, and set the show's episode ordering to TheTVDB (Absolute).

    Plex, TheTVDB (Absolute) order
    Anime/
    └── One Piece (1999) {tvdb-81797}/
        └── Season 01/
            ├── One Piece (1999) - S01E0001.mkv
            └── One Piece (1999) - S01E1001.mkv

    Avoid bare numbers like One Piece - 1001.mkv with Plex's standard scanner: three- and four-digit numbers can be read as season plus episode, so 1001 risks becoming season 10, episode 1. Absolute order only works when TheTVDB actually has absolute numbers for that show, so check its page first.

    HAMA and Absolute Series Scanner

    HAMA (a metadata agent that reads AniDB and maps it to TheTVDB) and Absolute Series Scanner (ASS) are popular community add-ons for anime fans. ASS understands fansub names such as [Group] Title - 01 directly, and you can force a match with a tag in the folder name such as [anidb-12345]. They are built on Plex's legacy agent system, which Plex has been phasing out, so check each project's GitHub page for compatibility with your server version before you rely on them.

    More on folders, IDs and extras: the Plex naming guide.

    Anime naming for Jellyfin and Emby

    Jellyfin uses TMDB by default (TheTVDB is available as a plugin), so the seasonal layout shown for Plex works as is. Season folders must be spelled out as Season 01, not S01. Add an ID with [tmdbid-1429] or [tvdbid-267440] in the show folder name to force the match. Different orderings are available per show through the Display order field in the metadata editor, when the metadata source provides them.

    Jellyfin, default TMDB metadata
    Shows/
    └── Attack on Titan (2013) [tmdbid-1429]/
        ├── Season 00/
        │   └── Attack on Titan (2013) S00E01.mkv
        └── Season 03/
            └── Attack on Titan (2013) S03E13.mkv

    Jellyfin with the AniDB or AniList plugin

    Jellyfin's plugin catalog (Dashboard > Plugins > Catalog) offers AniDB, AniList, AniSearch and Kitsu metadata plugins. After installing one, enable it in the library settings under the series and episode metadata downloaders and move it above TMDB. These sources treat each season or part as a separate show, so many users give each AniList entry its own show folder, with episodes numbered from 1 inside it. For true absolute numbering across a whole franchise, the community Shoko Server with its Shokofin plugin is the usual route.

    Emby

    Emby follows the same rules: Show Name - S01E01 - Episode Name.ext, season folders, and specials in Season 00 or Specials. Its ID tag uses an equals sign, for example Attack on Titan (2013) [tmdbid=1429]. Anime metadata sources such as AniDB and AniList come from a community plugin in Emby's plugin catalog.

    More detail on Jellyfin folders and versions: the Jellyfin naming guide.

    Anime naming for Kodi

    Kodi's default TV scraper uses TMDB seasons, so Attack on Titan (2013) S03E13.mkv works without any setup. Out of the box, Kodi reads S03E13, 3x13 and the ep13 style (for example Inuyasha ep01.mkv), which is meant for anime and single-season shows.

    For absolute order, set the show's source to the TheTVDB scraper and change its Season Type setting to Absolute (Single Season). Kodi then expects episode numbers counted from the start of the show.

    Kodi does not read a plain Title - 01.mkv by default, and its fallback pattern turns three or four digits into season plus episode: Naruto - 101.mkv becomes season 1, episode 1. If your files use the absolute Title - 01 style, add a custom pattern as shown below.

    advancedsettings.xml (in Kodi's userdata folder)
    <advancedsettings>
      <tvshowmatching action="prepend">
        <regexp>[ ._]-[ ._]()([0-9]{1,4})(?:v[0-9])?([ ._][^\\/]*)$</regexp>
      </tvshowmatching>
    </advancedsettings>

    The userdata folder is %APPDATA%\Kodi\userdata on Windows, ~/.kodi/userdata on Linux and ~/Library/Application Support/Kodi/userdata on macOS. If the file already exists, add the tvshowmatching block inside the existing advancedsettings element. Restart Kodi, then refresh the show. The empty () group means "no season", which Kodi treats as season 1, matching the Absolute (Single Season) order. The pattern applies to the whole library, so test it on one show first.

    Folder layouts, NFO files and scraper settings: the Kodi naming guide.

    Anime movies, OVAs and specials

    Movies

    Anime films belong in your movie library, named like any movie: Title (Year)/Title (Year).ext. Use the title as TMDB lists it, and add an ID if the title is ambiguous.

    Movie library
    Movies/
    ├── Spirited Away (2001)/
    │   └── Spirited Away (2001).mkv
    ├── Your Name. (2016)/
    │   └── Your Name. (2016).mkv
    └── One Piece Film - Red (2022)/
        └── One Piece Film - Red (2022).mkv

    Windows does not allow colons in file names, so One Piece Film: Red becomes One Piece Film - Red. Plex and Jellyfin still match it. Keep the period in Your Name., because it is part of the official title.

    TheTVDB also lists many franchise films as specials of the series (One Piece's films appear among its specials). Choose one place, the movie library or Season 00, so the same film does not appear twice.

    OVAs, ONAs and specials

    In a seasonal setup, OVAs and specials go in Season 00 with S00Exx numbers taken from the database your server uses. Specials lists differ a lot between sources: as of November 2026, TMDB lists 37 specials for Attack on Titan, while AniList files many of the same OVAs as separate entries.

    Specials in a seasonal library
    Attack on Titan (2013)/
    └── Season 00/
        ├── Attack on Titan (2013) - S00E01.mkv
        └── Attack on Titan (2013) - S00E02.mkv

    AniDB numbers specials as S1, S2 and so on inside each entry (with C for credits and T for trailers). HAMA and Shoko understand that scheme, but Plex's and Jellyfin's default agents do not, so translate them to S00Exx if you use TMDB or TheTVDB.

    If a special has no match in your database, give it a descriptive name instead of a guessed S00E number, or keep it in a separate folder. A wrong number pulls the wrong artwork and description.

    Dual audio, dubs and subtitle files

    The cleanest setup is one MKV per episode with every track inside: Japanese and English audio, plus subtitle tracks. You pick the track in the player and the file name stays simple. Tags like [Dual Audio] are not needed in the final name.

    If you keep the sub and the dub as separate files, store them side by side as versions of the same episode. Jellyfin and Emby show the text after - as the version name, and Plex groups files with the same SxxEyy in the same season folder under one episode.

    Two versions of one episode
    Season 01/
    ├── Attack on Titan (2013) - S01E01 - Japanese.mkv
    └── Attack on Titan (2013) - S01E01 - English Dub.mkv

    External subtitles must share the video's base name, followed by a language code: Attack on Titan (2013) - S01E01.en.ass. When you rename a video, rename its subtitle files the same way or the player stops pairing them.

    Fansub ASS subtitles often rely on fonts attached inside the MKV. If you extract the subtitles to a separate file, those fonts are lost and the typesetting looks wrong. Some Plex clients also cannot render ASS styling and make the server burn the subtitles into the video, which costs CPU.

    Rename anime files with RenameFlow

    Renaming a 26-episode batch by hand is tedious, and a 1,000-episode show is out of the question. RenameFlow is a web app that renames files directly on your disk from Chrome, Edge or Opera on a desktop computer. Nothing to install, and your videos are never uploaded: only the detected titles are sent to the metadata services.

    1. Open the folder with your episodes. RenameFlow recognizes fansub names such as [SubsPlease] Title - 01 (1080p) [A1B2C3D4] as anime and separates the title from the group, quality and checksum.
    2. It matches the show with AniList (TMDB and TheTVDB are also available) and shows you the result. Confirm the match or pick another one.
    3. Choose a preset, check the preview, then rename. A rename history, which you can export, keeps a record of the original fansub names.
    PresetAnime file nameExample
    Plex, JellyfinTitle - S01E01.extNaruto - S01E01.mkv
    Kodi, SimpleTitle - 01.ext (absolute)Naruto - 01.mkv

    Before confirming, compare the season and episode numbers in the preview with the ordering your server uses, especially for split-cour shows like Attack on Titan. With the Kodi preset, add the pattern from the Kodi section above, or use the Plex/Jellyfin style, which Kodi reads natively.

    RenameFlow renames files only. It does not create, move or rename folders. Create the Attack on Titan (2013)/Season 03 folders yourself and move the renamed files into them.

    Pro plans add custom naming patterns with tokens such as {title}, {season}, {episode}, {quality} and {group}, if you want to keep the resolution or the release group in the name. The Subtitles module can also fetch subtitles from OpenSubtitles and save them next to each video. The free plan renames 15 files a day; see pricing for larger libraries.

    Clean up your anime folder in minutes

    RenameFlow reads fansub names, matches your shows with AniList, TMDB or TheTVDB, and renames the files in place for Plex, Jellyfin or Kodi. Your videos never leave your computer.

    Try RenameFlow free

    Frequently asked questions

    What is the correct anime file naming convention for Plex?
    Name the show folder Title (Year), create Season 01-style folders, and name each file Title (Year) - S01E01.mkv using the season numbers of the ordering your library uses (TMDB by default). Adding {tmdb-ID} or {tvdb-ID} to the folder name forces the right match. For very long shows you can instead set the show to TheTVDB (Absolute) and use S01E1001-style names.
    Should I use absolute episode numbering for anime?
    Only if your metadata source is set to an absolute order, or you use an anime agent like HAMA or Shoko. Absolute numbering suits long single-entry shows like One Piece or Detective Conan. For most series with a few seasons, seasonal numbering from TMDB or TheTVDB is simpler and works with every client.
    How do I number One Piece episodes in Plex?
    First decide on an ordering. With Plex's default TMDB order, use TMDB's arc-based seasons (season 1 has 61 episodes). With TheTVDB (Absolute), put everything in Season 01 and name files One Piece (1999) - S01E1001.mkv. Do not use TheTVDB aired order numbers with TMDB ordering, since TheTVDB's seasons are much shorter.
    How should I name anime for Jellyfin?
    With Jellyfin's default TMDB metadata, use Title (Year)/Season 01/Title (Year) S01E01.mkv and spell out Season 01. If you install the AniDB or AniList plugin, keep in mind those sources treat each season or part as a separate show, so many people give each entry its own folder. Shoko Server with Shokofin is the usual choice for absolute numbering.
    What do [SubsPlease] and the code at the end of an anime file name mean?
    [SubsPlease] is the release group. The 8-character code in brackets at the end, such as [A1B2C3D4], is the file's CRC32 checksum, used to check that the download is not corrupted. Neither helps your media server, and the group tag can hurt matching, so both are usually removed when renaming.
    What is a cour, and why are my anime seasons wrong?
    A cour is a three-month broadcast block of about 10 to 13 episodes. Anime databases like AniList give each cour or part its own entry, while TMDB and TheTVDB often merge them into one season. Attack on Titan Season 3 Part 2, for example, is episodes 1 to 10 on AniList but S03E13 to S03E22 on TMDB and TheTVDB.
    Where do anime movies and OVAs go in Plex or Jellyfin?
    Movies go in the movie library as Title (Year)/Title (Year).mkv. OVAs and specials go in the series' Season 00 folder with S00Exx numbers taken from your metadata source. If a film is also listed as a special, keep it in only one place to avoid duplicates.
    Does Kodi support absolute episode numbers for anime?
    Yes. Use the TheTVDB scraper with Season Type set to Absolute (Single Season). Kodi reads ep01-style names out of the box, but a plain Title - 01.mkv needs a custom tvshowmatching pattern in advancedsettings.xml, and three-digit numbers like - 101 are otherwise read as season 1, episode 1.