Wiki

Your library

Add a folder

  1. Open SettingsLibrary.
  2. Press Add folder.
  3. Pick the folder that holds your shows, such as ~/Videos/Anime. Add the folder above the shows, not each show on its own.

The scan starts at once. Library and Home fill in as it finds shows. An empty Library or Home page has an Add a folder button that does the same.

You can add more than one folder, on more than one drive. Each folder inside them becomes a series.

Name folders and files

  • One folder per show, named the way AniList writes the title.
  • Each file carries its episode number, the way releases do: Frieren - 01.mkv or Frieren S01E01.mkv.
  • A later season is a folder of its own with the season after the title, or a Season 2 folder inside the show.
  • Films go in a folder named Movies, one file each.
Anime/
  Frieren/
    Frieren - 01.mkv
    Frieren - 02.mkv
    Season 2/
      Frieren S02E01.mkv
  Movies/
    Suzume.mkv

Subtitle files next to an episode, with the same name, are picked up with it. Openings, endings and specials land under their own heading on the show's page.

What a scan does

  1. Reads every folder and finds the video files in it.
  2. Looks each show up by its folder name: on AniList first, then on TVmaze for shows that are not anime. The order is under SettingsLibrary.
  3. Fetches posters, episode titles and related seasons.
  4. Reads your AniList or MyAnimeList progress, when one is connected.

Anibeam only reads your folders. It never moves, renames or deletes a file on its own.

After the first scan it watches the folders, so a new episode shows up by itself. To read a folder again by hand, press Rescan on its row in SettingsLibrary, or Scan all.

A show is not recognised, or is the wrong show

  1. Open the show and press Fixes, then Find a match. A show that already has a match says Match there.
  2. Search for the title, or paste its AniList or MyAnimeList link.
  3. Pick the right show.

A match you pick by hand is never replaced.

Episodes are read wrong

  1. Open the show and press Fixes, then Files.
  2. For each file, say what it really is under Should be: an episode and its number, or an opening, ending, preview or special.
  3. Press Apply. The button counts your fixes, as in Apply 2 fixes.

Every later scan keeps the fix. Renaming the files the way Name folders and files shows works too.

Remove or move a folder

In SettingsLibrary, each folder has its own row. Removing one takes its shows and their history out of Anibeam and leaves the files alone.

A folder on a drive that is not plugged in shows Unavailable. Plug the drive in and press Rescan. If the folder moved, remove it and add the new place.