Skip to content

Shoko

Updated

Shoko is an anime-specific library manager that uses AniDB (the authoritative anime database) for matching, organisation, and relationship metadata. Where Radarr / Sonarr use TheMovieDB and TVDB and struggle with the messy realities of anime (multiple seasons, OVAs, specials, multi-episode arcs, naming conventions in different scene-tagging styles), Shoko handles them natively because AniDB does.

When does managed Shoko make sense?

  • Serious anime collections where TVDB / TMDB matching keeps misidentifying episodes, breaking on naming conventions, or losing track of OVAs and specials.
  • Multi-season / multi-arc series where you want Shoko's relation graph (sequels, side stories, related works) instead of flat metadata.
  • Subtitled releases that come with non-standard naming patterns. Shoko parses fansub-group naming conventions natively.
  • Pair with Plex, Jellyfin, or Emby: Shoko exports metadata for the player to pick up, so the player gets accurate anime information without needing player-side anime agents.

How to wire it up on ElfHosted

  1. Open Shoko from your apps dashboard.
  2. Connect AniDB. Settings β†’ AniDB β†’ enter your AniDB account credentials. AniDB is free; the account is needed for metadata API access.
  3. Point Shoko at your anime library: typically a folder under /storage/... containing your anime files. When you add the import folder, set its Drop Type to None (see below for why this matters).
  4. Run the initial scan. Shoko hashes every file and matches against AniDB. First pass is slow because of AniDB rate limits; subsequent runs are incremental.
  5. Wire up your media server. For Plex: install the Shoko Metadata agent on the Plex server side. For Jellyfin / Emby: install the Shoko plugin in the player.

If your anime library is built from symlinks pointing at a debrid mount (TorBox, Real-Debrid, debridge, etc.), your import folders must have their Drop Type set to None in Shoko's settings. Do not mark them as a Drop Source.

Here's why: Shoko opens files in a Drop Source folder with write access (so it can move them out later). It follows your symlinks to the real files first, and debrid mounts are read-only, so every hash attempt fails with Read-only file system and Shoko retries each file 60 times before giving up. The symptom is a scan that crawls for hours and a log full of Could not access file errors.

With Drop Type set to None, Shoko opens files read-only and hashing works normally. You lose nothing: Drop Source only matters if Shoko is renaming and moving files for you, which it shouldn't be doing in a symlink library anyway.

Two things to know about scanning a debrid-backed library:

  • Shoko identifies files by ED2K hash, which means reading every file in full. There's no way to hash a symlink without reading its target, so the initial scan streams each file from your debrid provider once. Expect it to take a while on a large library.
  • Hashes are cached after the first pass, so rescans are quick as long as paths and file sizes don't change.

Why anime needs its own tool

The TVDB / TMDB approach to TV is "one show, numbered seasons, numbered episodes". Anime breaks every assumption: split-cours seasons, year-numbered seasons treated as different shows, OVAs that aren't part of the main run, movies that are canon to the series, recap episodes, specials. AniDB models all of this; Shoko is the integration layer between AniDB and your media server.

Get a 7-day trial of ElfHosted Shoko! πŸͺ„

How do I access Shoko?

Shoko is available:

Signed-in users see their own URLs

The addresses above show the general pattern. Sign in and these become your personal, clickable links.

Info

Shoko is an open-source tool. ElfHosted provides hosting infrastructure only. Users are responsible for their use of this service in compliance with applicable laws and third-party terms of service.

Shoko also works with

How do I get support for Shoko?

  1. For general use of Shoko, refer to the official site or to one of the links in the resources section below.

  2. For specific support re your ElfHosted configuration / account, see the ElfHosted support options!

Shoko resources

Your content, your responsibility

ElfHosted provides Shoko as a hosted application β€” we do not supply content, accounts, or third-party credentials. You are responsible for ensuring that your use of this app complies with applicable laws and our Acceptable Use Policy. If you have questions about what is or isn't permitted, please reach out β€” we're happy to help.

What users say..

We're rocking some excellent ⭐⭐⭐⭐⭐ TrustPilot Reviews, and here's what some of our usersfriends say..

Really great team, lots of products. and support team are heros, they solve all problems i had in no time with perfect solutions.

β˜…β˜…β˜…β˜…β˜… Eni p. (Trustpilot)

This was the best experience ever. I am so thankful that Elfhosted provides a white glove experience to setup your service for you. Togx90 was amazing.

β˜…β˜…β˜…β˜…β˜… Randall M. (Trustpilot)

I was having issues with Overseerr’s automation and a rep from ElfHosted came to the rescue and fixed my issue in less than an hour. You can't beat that level of customer service. I will happily continue to be a customer.

β˜…β˜…β˜…β˜…β˜… Gabriel G. (Trustpilot)

An amazing service and even better support so incredibly helpful and a special thanks to funky penguelf

β˜…β˜…β˜…β˜…β˜… TopHail (Trustpilot)