Set Up an Anime Library in Plex With Correct Metadata
Published 2026-10-16 · PlexBeam
Anime libraries in Plex are notoriously difficult to set up correctly. Episode numbering differs between databases, seasons are structured differently than Western TV shows, and metadata sources frequently disagree on how to organize a series. A show that TVDB lists as multiple seasons may appear as one continuous series in TMDB, and your files might follow a completely different numbering scheme. This guide covers how to get anime working properly in Plex.
The Core Problem
Western TV shows follow a simple pattern: Season 1, Season 2, Season 3, with consecutive episode numbers within each season. Anime does not follow this pattern consistently:
- Long-running series: Shows like Naruto Shippuden or One Piece may have hundreds of episodes numbered continuously (Episode 1 through Episode 500+), not broken into seasons.
- Split cours: A show that aired in two halves (e.g., Attack on Titan Season 3 Part 1 and Part 2) may be listed as one season in one database and two separate seasons in another.
- OVAs and specials: Original Video Animations, recap episodes, and specials are inconsistently placed across databases — sometimes in Season 0, sometimes as extra episodes within a season, sometimes as separate entries entirely.
- Reboots and alternate versions: Multiple versions of the same series (e.g., Fullmetal Alchemist 2003 vs Brotherhood) need distinct library entries.
Choosing a Metadata Agent
Plex uses metadata agents to match your files to online databases. For anime, the agent choice determines how episodes are numbered and organized.
TMDB (Plex Default)
The default Plex agent uses TMDB (The Movie Database) for TV shows. TMDB organizes anime using seasons and episode numbers. For many popular anime, TMDB ordering is straightforward and matches common file naming conventions. However, TMDB may split long-running series differently than other databases, and coverage for older or obscure anime can be incomplete.
TVDB
TheTVDB is the traditional metadata source for anime in Plex. It has extensive anime coverage and community-maintained episode ordering. TVDB uses a season-based structure and assigns unique series IDs. The challenge: TVDB frequently reorders anime series, splitting or merging seasons in ways that invalidate your existing file naming.
HAMA (HTTP AniDB Metadata Agent)
HAMA is a third-party Plex agent specifically designed for anime. It pulls metadata from AniDB (the definitive anime database), maps it to TVDB or TMDB numbering, and handles the edge cases that standard agents miss:
- Absolute episode numbering (Episode 1 through Episode 500 without season breaks).
- AniDB-to-TVDB mapping for series that TVDB has restructured.
- OVA and special placement that matches AniDB's authoritative ordering.
- Franchise grouping that keeps related series together.
HAMA requires manual installation as a Plex plugin and uses the ASS (Absolute Series Scanner) for file matching. The setup is more complex than the built-in agents but produces dramatically better results for large anime collections.
File Naming for Anime
Season-Based Naming
If using the default Plex agent (TMDB) or TVDB agent, name files using standard Plex TV show conventions:
Anime/Show Name (Year)/Season 01/Show Name - S01E01 - Episode Title.mkv
This works well for anime that maps cleanly to a season structure — most seasonal anime (12-24 episodes per season) fits this pattern.
Absolute Numbering
Long-running anime with continuous episode numbers works better with absolute numbering. Files are named with just the episode number:
Anime/Naruto Shippuden (2007)/Naruto Shippuden - 001.mkv
Anime/Naruto Shippuden (2007)/Naruto Shippuden - 150.mkv
The Absolute Series Scanner (ASS), used with HAMA, reads these numbers and maps them to the correct season/episode in the metadata database. Without ASS, the default Plex scanner may not recognize absolute numbering.
AniDB Naming
When using HAMA with AniDB as the primary source, file naming follows AniDB conventions. AniDB treats each anime series or season as a separate entity with its own episode numbering starting from 1. Files can be organized by AniDB series rather than by TVDB seasons.
Setting Up a Dedicated Anime Library
The recommended approach is to create a separate Plex library for anime rather than mixing it with Western TV shows:
- Create a new library in Plex: type TV Shows.
- Point it at a dedicated anime folder separate from your regular TV show folders.
- Choose your preferred agent (TMDB, TVDB, or HAMA if installed).
- If using HAMA and ASS, select them as the library's scanner and agent.
A dedicated library lets you use a different scanner and agent for anime without affecting your Western TV show matching. It also keeps anime browsing separate, which many users prefer for navigation.
Handling Common Edge Cases
Movies vs Series
Anime movies (Dragon Ball Super: Broly, Spirited Away, Your Name) should go in a Movies library, not the anime TV library. Plex handles movie metadata differently from TV metadata, and anime movies are well-covered by TMDB's movie database.
OVAs and Specials
Place OVAs and specials in a Specials or Season 00 folder:
Anime/Show Name/Season 00/Show Name - S00E01 - OVA Title.mkv
Check the metadata database you are using (TVDB, TMDB, or AniDB) for the correct special episode number. TVDB and AniDB frequently disagree on special numbering — use the number from whichever database your Plex agent is configured to use.
Multi-Season Series
Series like My Hero Academia or Sword Art Online have multiple distinct seasons. Each season may have its own TVDB entry or be grouped under a single entry with multiple seasons. Check your metadata source to determine the expected structure before organizing files.
Fansub Groups and Release Tags
Anime files from fansub groups often include group tags and quality indicators in the filename:
[SubGroup] Show Name - 01 [1080p].mkv
Plex generally handles these tags correctly by ignoring the brackets. However, the Absolute Series Scanner is more reliable than the default Plex scanner at parsing these filenames. If Plex mismatches files with fansub naming, consider using ASS or renaming the files.
Subtitle Considerations
Anime relies heavily on subtitles. Many anime files include multiple subtitle tracks — the original Japanese audio with English subtitles is the standard setup. Common subtitle issues in Plex:
- ASS/SSA subtitles: Styled subtitles (colored text, positioned dialogue, karaoke effects) display correctly on some Plex clients but not others. Clients that cannot render ASS/SSA natively trigger a transcode because Plex must burn the subtitles into the video stream.
- Forced subtitles: Signs and song translations that should display even when other subtitles are off. Mark these as forced in the file metadata or external subtitle naming (
.forced.srt). - Multiple subtitle tracks: Files with English, Romaji, and other subtitle options may confuse Plex's automatic subtitle selection. Set your preferred subtitle language in Plex settings and configure per-library subtitle behavior.
Troubleshooting
Episodes Matched to Wrong Series
- Use Fix Match on the series in Plex. Search by the official title and year to find the correct metadata entry.
- If TVDB has restructured the series since you organized your files, the episode mapping may be outdated. Check the current TVDB listing and rename files to match.
Missing Episodes in Library
- Verify file naming matches the expected format for your scanner (standard Plex or ASS).
- Check that the metadata database has entries for the episodes you are missing. Some newer episodes may not yet be in TVDB or AniDB.
- Run a manual library scan after adding or renaming files.
Metadata Agent Not Available
- HAMA and ASS must be manually installed in the Plex plugins directory. They are not available from the Plex plugin catalog.
- After plugin installation, restart the Plex server. The agent should appear in the library creation/edit screen under Advanced settings.