Jellyfin MyAnimeList Metadata Plugin

About

This plugin adds the metadata provider for MyAnimeList using Jikan and MyAnimeList's public API.

To automate syncing with MyAnimeList using this metadata you can try using MyAnimeList Sync which is a fork of vosmiic/jellyfin-ani-sync customized to use the MyAnimeList metadata.

Folders must be formatted as shown below to get the best results.
For accurate data use the anime name from MyAnimeList and Season 01 or the first season anime's name with the anime's season number.
Please report any issues you find.

Anime
├── Anime Name A
│   ├── Specials
│   │   └── Anime Name - S00E0# - Special Title.mkv
│   ├── Season 01
│   │   ├── Anime Name A S01E01-E02.mkv
│   │   ├── Anime Name A S01E03.mkv
│   │   └── Anime Name A S01E04.mkv
│   └── Season 02
│       ├── Anime Name A S02E01.mkv
│       ├── Anime Name A S02E02.mkv
│       ├── Anime Name A S02E03 Part 1.mkv
│       └── Anime Name A S02E03 Part 2.mkv
└── Anime Name B
    └── Season 01
        ├── Anime Name B S01E01.mkv
        └── Anime Name B S01E02.mkv

Example of folders with file:

Anime
└── Dungeon ni Deai wo Motomeru no wa Machigatteiru Darou ka V: Houjou no Megami-hen
    └── Season 01
        └── Dungeon ni Deai wo Motomeru no wa Machigatteiru Darou ka V: Houjou no Megami-hen S01E01.mkv

or

Anime
└── Dungeon ni Deai wo Motomeru no wa Machigatteiru Darou ka
    └── Season 05
        └── Dungeon ni Deai wo Motomeru no wa Machigatteiru Darou ka S05E01.mkv

Example Special episode + special movie: Note: If a special have multiple episodes the episode number needs to be incremented to select the correct special.

Anime
└── Violet Evergarden
    └── Specials
        ├── Violet Evergarden - S00E01 - The Day You Understand I Love You Will Surely Come.mkv
        └── Violet Evergarden - S00E01 - Recollections.mkv

Installation

Automatic (recommended)

1. Navigate to Settings > Admin Dashboard > Plugins > Repositories
2. Add a new repository with a Repository URL of https://raw.githubusercontent.com/ryandash/jellyfin-plugin-myanimelist/refs/heads/main/manifest.json. The name can be anything you like.
3. Save, and navigate to Catalogue.
4. Myanimelist should be present. Click on it and install the latest version.
5. Navigate to Plugins in Jellyfin (Settings > Admin Dashboard > Plugins) to verify installation.

Manual

See the official Jellyfin documentation for install instructions.

1. Download a version from the releases tab that matches your Jellyfin version.
2. Extract the zip file.
3. Copy the dll files into plugins/myanimelist (see official documentation on where to find the plugins folder).
4. Restart your Jellyfin instance.
5. Navigate to Plugins in Jellyfin (Settings > Admin Dashboard > Plugins) to verify installation.

Building from visual studio

1. Git clone the latest version of this repository, jikan.net, and FuzzierSharp
2. Download and install visual studio with .Net desktop development
3. Build jikan.net
4. Open my repository solution and add any missing references and build
5. By default a debug build should output to $(USERPROFILE)\AppData\Local\jellyfin\plugins\myanimelist, if not then Copy all dll files from the output directory to Jellyfins Plugin directory under plugins/myanimelist
6. Restart Jellyfin Server (Administration> Dashboard > Restart) and navigate to Plugins in Jellyfin (Administration > Dashboard > My Plugins) to verify installation.

Licence

This plugins code and packages are distributed under the GPLv2 License. See LICENSE for more information.