AniList Anime Tracking

🎌 AniList Anime Tracking

Freak-Flix leverages the AniList API to provide a specialized experience for anime enthusiasts. Unlike standard TV shows, anime content is processed through AniList’s extensive database to ensure accurate metadata, including romaji/english titles, seasonal information, and studio credits.

⚙️ How it Works

When you add a library folder to Freak-Flix, you can designate its content type as Anime. The application then initiates a specialized scanning process:

1. Title Parsing: The scanner extracts the series name from your file/folder structure (stripping release group tags like [SubsPlease] or [Erai-raws]).
2. AniList Matching: The app queries the AniList GraphQL API to find the closest match.
3. Metadata Enrichment: Freak-Flix downloads high-resolution banners, cover art, descriptions, and episode counts.

📂 Recommended Folder Structure

To ensure the highest matching accuracy, it is recommended to organize your anime library using one of the following structures:

Standard Series:

Anime/
└── Frieren Beyond Journey's End/
    ├── Frieren - 01.mkv
    └── Frieren - 02.mkv

Movies / OVAs:

Anime/
└── Akira (1988)/
    └── Akira.mkv

🚀 Usage and Configuration

Enabling AniList Metadata

By default, the app is configured to use AniList for any folder marked with the "Anime" tag.

1. Navigate to Settings > Library.
2. Click Add Folder.
3. Select your local or OneDrive folder.
4. Set the Content Type dropdown to Anime.
5. Click Scan.

Displayed Metadata

Once matched, the interface will display anime-specific data points:

• Format: TV, Movie, OVA, or ONA.
• Status: Finished, Releasing, or Not Yet Released.
• Season: (e.g., Fall 2023).
• Genres: Dynamic tags imported directly from AniList's community-driven tagging system.

🛠️ Troubleshooting Matches

If a series is incorrectly identified:

1. Check the Folder Name: Ensure the folder name matches the Romaji or English title found on AniList.
2. Manual Search (Internal): The system uses a fuzzy search algorithm. If a match fails, ensure the file name doesn't contain excessive metadata (like CRC hashes) that might confuse the parser.

[!TIP] Freak-Flix prioritizes Romaji titles for internal organization but will display the title based on your localized system settings where available.