The Agents accesses an API that is running on my own server, the log files contain the IP-Address and API endpoint of each request, this is necessary for security reasons. Those log files are being rotated daily and those rotations will contain anonymized IP-Addresses.


This Project is a Plex Media Server (PMS) Metadata Agent for

This Metadata Agent loads the information from the Anime Website and adds that information to your Plex Library.


Metadata Sources:

The Agent will request information from not only MyAnimeList but also TheTVDB or TheMovieDB, what each source provides is listed below.

The website is the main source for the information and the Agent relies on a stand-alone installation of the Atarashii API.

More Information

More specifically the Agent will use the following values from the API and add them as Metadata to the Plex Library:

  • ID
  • Title
  • Synopsis (Plex: Summary)
  • Member Score (Plex: rating)
  • Start Date (Plex: originally available at)
  • Classification (Plex: Content Rating)
  • Cover and Pictures (Plex: Posters)
  • Duration (Plex: Duration)
  • Genres (Plex: Genres)
  • Producers (Plex: Studio) (Currently there is a mismatch between Plex and the Atarashii API. Atarashii doesn’t provide Studios in a response and Plex doesn’t provide a way to store the Studios in the Metadata)
  • Episode Number
  • Episode Title
  • Episode Air Date

The website (or rather API) is used to request more image information for an episodic Anime. In the Agent settings, you can enable or disable the functionality to fetch images from and also set the size of the images (by default it is “original”).

More Information
  • Posters (Plex: Posters)
  • Fanart (Plex: Art)
  • Series (Plex: Banners)

The TheMovieDB website (or rather API) is also used to request more image information but for Anime Movies. You can also enable or disable the functionality to fetch the images and also set the size of the images as well (by default it is “original”).

More Information
  • Posters (Plex: Posters)
  • Backdrops (Plex: Art)

Other Sources:

The Agent also accepts information from other Agents like the “Local Media Assets” (for both TV and Movie) and “”.


Because, unlike the last version of this Agent, the API doesn’t provide the necessary information used to make the connection between a MyAnimeList and TheTVDB or TheMovieDB entry the solution is a mapping file that is loaded whenever a mapping is required. The Mapping is in a JSON format and can be found on the GitHub project page. The Agent will automatically request the file from my server and cache it for 7 days when a mapping is required, which means whenever a metadata update is triggered and the “Fetch information from TheTVDB/TheMovieDB” is enabled in the Agent settings.

There are currently 14923 entries in the mapping file and some of them might be wrong. Should you find any wrong mapping please report it and create an Issue here.


Anime usually rely on the absolute episode numbering format instead of seasons. Therefore I recommend using a scanner that can follow this format like the following

Scanners need to be placed in the following directories for a TV-Show Scanner (the folders might not exist so just create them):

  • Linux: /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Scanners/Series
  • Windows: %LOCALAPPDATA%\Plex Media Server\Scanners\Series

More Information to Scanners


Installation is straightforward, place the MyAnimeList.bundle folder into the directories (depending on your OS) listed below and restart your Plex Media Server (Note: Plex only loads the Agent on restart!).


  • Linux: /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-ins/
  • Windows: %LOCALAPPDATA%\Plex Media Server\Plug-ins
  • FreeNAS: ${JAIL_ROOT}/var/db/plexdata/Plex Media Server/

More information


I recommend to disable the feature to fetch image information from TheTVDB and TheMovieDB initially or the match process will be extremely long. Any mismatches will pull additional images that might be wrong.

  1. Stop Plex
  2. Download the Agent and extract it into your Plug-ins folder
  3. Check permissions
  4. Start Plex
  5. Go to the Agent Settings and disable “Fetch Images for TV-Shows/Movies”
  6. match your library and fix matches that were wrong or not matched at all
  7. activate “Fetch Images for…” again
  8. refresh metadata and go do something else, this will take some time


For all support related or general questions please use the thread in the official plex forums

For any issues like bugs, unintended behaviour please create a new Issue on the GitHub issue tracker

For development stages, release information, download link or anything else you can visit my dev Blog here

See the Wiki Page for the FAQ


Current Release:



  • Bugfix: Movie Posters are added to backgrounds instead of Posters


  • Bugfix: unknown url type while the main Cover should be requested.







  • Accepting SubZero Plugin Metadata
Old Releases