# Shoko

Shoko is an anime-specific library manager that uses AniDB (*the authoritative anime database*) for matching, organisation, and relationship metadata. Where [Radarr](</app/radarr/>) / [Sonarr](</app/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](</app/plex/>), [Jellyfin](</app/jellyfin/>), or [Emby](</app/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](<https://shokoanime.com/wiki/plex/>) on the Plex server side. For Jellyfin / Emby: install the Shoko plugin in the player.

## Symlink and debrid libraries: set Drop Type to None

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! 🪄](<https://store.elfhosted.com/product/shoko/>)

## How do I access Shoko?

Shoko is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-shoko.elfhosted.com](<https://your-username-shoko.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/shoko/>) and these become your personal, clickable links.

> [!NOTE]
>
> **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

- [x] [Plex](</app/plex/>)
- [x] [Jellyfin](</app/jellyfin/>)
- [x] [Emby](</app/emby/>)

## How do I get support for Shoko?

1. For general use of Shoko, refer to the [official site](<https://docs.shokoanime.com>) 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](</get-help/>)!

## Shoko resources

- [Shoko (*official site*)](<https://docs.shokoanime.com>)
- [Shoko Discord](<https://discord.com/invite/vpeHDsg>)

> [!NOTE]
>
> **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](</legal/acceptable-use/>). If you have questions about what is or isn't permitted, please [reach out](</get-help/>) — we're happy to help.
