Anime is the hardest media type to organize in Plex. Series have multiple seasons that aired years apart, OVAs and movies that are part of the storyline, absolute episode numbering that doesn’t match season-based numbering, and metadata sources that disagree on how to structure everything. Here’s how to make it work.

The Core Problem

Plex’s default scanner assumes Western TV conventions: Season 01, Episode 01 through Episode 22, then Season 02. Anime doesn’t work that way. A show like Naruto has 220 episodes in one continuous run. One Piece has 1000+ episodes. Some series have "seasons" that are really just separate entries on different metadata databases. The solution is using scanners and agents designed for anime.

HAMA: The Anime Scanner

The HTTP AniDB Metadata Agent (HAMA) is the standard solution. It pulls metadata from AniDB (the most complete anime database) and maps it correctly to your file structure.

Installation

  1. Download the HAMA bundle and the Absolute Series Scanner (ASS)
  2. Place the HAMA bundle in your Plex Plug-ins folder
  3. Place the ASS scanner in your Plex Scanners/Series folder
  4. Create a new TV library in Plex
  5. Set the scanner to "Absolute Series Scanner" and the agent to "HamaTV"

Folder Naming for HAMA

HAMA supports multiple naming conventions, but the most reliable is using the AniDB ID:

The AniDB ID in square brackets tells HAMA exactly which series this is, eliminating matching errors. Find the ID on anidb.net in the URL of the series page.

Absolute vs Season Ordering

Most anime uses absolute ordering (Episode 1 through Episode 500) rather than Season 1 Episode 1. The Absolute Series Scanner handles this natively. Name your files with absolute numbers:

If you’re using Sonarr, set the series type to "Anime" and it will download with absolute numbering automatically.

Handling OVAs, Movies, and Specials

Anime OVAs and specials create the most confusion. The convention:

For HAMA specifically, use AniDB’s episode numbering for specials — it often differs from TVDB’s numbering.

Subtitle Considerations

Anime releases commonly use ASS/SSA subtitle formats for styled typesetting (karaoke, signs, special effects). These are image-based when burned in and force transcoding on most clients.

Kometa (PMM) for Anime Collections

Kometa (formerly Plex Meta Manager) can automatically create anime-specific collections: by genre (shonen, seinen, isekai), by studio (MAPPA, Ufotable), by season (Fall 2026 anime), or custom lists from AniList/MyAnimeList.

This gives your anime library a browsable, organized feel similar to Crunchyroll or MyAnimeList without manual curation.

Common Issues and Fixes

Wrong series matched

Use the AniDB ID in the folder name. This is the most reliable fix. Without it, shows with similar names (multiple versions of Hunter x Hunter, Dragon Ball variations) will mismatch frequently.

Missing episodes

Check that your file numbering matches AniDB’s numbering. Some groups number differently than AniDB. Use FileBot or Sonarr for consistent renaming.

Posters and artwork wrong

HAMA can pull art from AniDB, TVDB, and fanart.tv. If the wrong poster shows up, use Plex’s "Fix Match" feature and manually select the correct entry, then refresh metadata.