Scanning
Learn the important quirks of scanning
TL;DR
- Default scanning uses your AniList anime list data to match files, faster.
- Enhanced scanning does not require your AniList data and is more comprehensive, slower.
- Refresh entries manually or automatically to update your library.
- Summaries show the results of your latest scans.
- Resolve unmatched files using the "Resolve unmatched" button.
Default scanning behavior
The default scanning behavior is designed to be efficient and fast. This means reducing the number of external API requests. To achieve this, the scanner uses your AniList anime list data to match files. In other words, if you have files from an anime that is not on your AniList account, these files might not get matched correctly.
Example
##### Local library ######
📁 Attack On Titan Season 3
📁 Jujutsu Kaisen
📁 One Piece
📁 One Piece Film Red <- 🧐 Not in AniList
📁 Blue Lock
📁 Sousou No Frieren
📁 Horimiya: Pieces <- 🧐 Only "Horimiya" in AniList
📁 Bungou Stray Dogs Season 5 <- 🧐 Only Season 1-3 in AniList
📁 Black Lagoon <- 🧐 Not in AniList
##### Results ######
✅ Attack On Titan Season 3
✅ Jujutsu Kaisen
✅ One Piece
❌ One Piece Film Red <- Mismatched to "One Piece"
✅ Blue Lock
✅ Sousou No Frieren
✅ Horimiya: Pieces <- Correctly matched, since it is direct sequel of "Horimiya"
❌ Bungou Stray Dogs Season 5 <- Mismatched to "Bungou Stray Dogs Season 3"
❌ Black Lagoon <- Unresolved
When to use
- When your local library contains anime that is in your AniList lists
- When you aren't scanning files from an anime that is not in your AniList lists
Enhanced scanning
Enhanced scanning is designed to be comprehensive. It does not rely on your AniList anime list data to match files. Although this means the scanning process will take more time, it allows for matching files from anime not included in your AniList lists.
How it works
To achieve this, the scanner pre-fetches data from AniList based on the file names. It then fetches additional data, including prequels, sequels, specials and movies of each anime, increasing the chances of matching files correctly.
Caveats
The catch is that this method requires a lot of API requests, which can be slow and may hit the rate limit multiple times if you have a large library. Additionally, the reliability of the matching is not guaranteed, as it is based on the file names and search results from MyAnimeList.
##### Local library ######
📁 Attack On Titan Season 3
📁 Jujutsu Kaisen
📁 One Piece
📁 One Piece Film Red <- 🧐 Not in AniList
📁 Blue Lock
📁 Sousou No Frieren
📁 Horimiya <- 🧐 Not in AniList
📁 Bungou Stray Dogs Season 5 <- 🧐 Only Season 1-3 in AniList
📁 Black Lagoon <- 🧐 Not in AniList
📁 Shingeki no Kyojin - The Final Season Part 3
##### Results ######
✅ Attack On Titan Season 3
✅ Jujutsu Kaisen
✅ One Piece
✅ One Piece Film Red
✅ Blue Lock
✅ Sousou No Frieren
✅ Black Lagoon
✅ Horimiya
✅ Bungou Stray Dogs Season 5
✅ Black Lagoon
❌ Shingeki no Kyojin - The Final Season Part 3 <- Mismatched to "Shingeki no Kyojin"
As you can see based of this real example, enhanced scanning was able to match more files than the default scanning.
However, it was not able to correctly match complex cases like Shingeki no Kyojin - The Final Season Part 3
.
Make it work
To ensure a smooth scanning experience, follow these tips:
- Only use enhanced scanning when adding media to AniList beforehand is not convenient.
- Make sure that either the files or their folder contains a title that closely matches the anime title from AniList.
- Make sure the structure of the files makes sense. If a human can't tell what anime the file is from, the scanner won't be able to either.
Refreshing entries
Seanime does not automatically refresh your library by default, so you will need to do this manually by clicking the Refresh entries
button when your library is updated.
Automatic refresh
You can enable automatic refresh in the settings page. Seanime will then automatically refresh your entries when it detects changes in your library.
Caveats:
- This works best when single files are added or removed. If you are adding a batch of files, it's recommended to disable this feature.
- This can cause mismatches if the new files are from anime that are not in your AniList collection, as the default scanning behavior will be used.
- This can be slow if you have a large library and haven't locked any files.
Summaries
You can view the summaries of your latest scans by going to the "Scan summaries" page. This page shows the results for each anime entry, including the number of matched and unresolved files and even scanner logs for each file. This allows you to quickly identify and fix any mismatches.
Unresolved files
Unresolved files are files that the scanner was not able to match to any anime entry.
It's recommended to resolve these files manually by finding out the reason they were not matched correctly and fixing the file names or structure accordingly. This will help you avoid any issues when you refresh your entries in the future.
However, you can simply click the "Resolve unmatched" button and choose the appropriate anime entry, the files will be matched and locked.