This project provides an automated tool to rename and reorganize media files, particularly anime series, into formats compatible with Emby's auto-scraping. It targets users seeking to streamline their media library management, ensuring accurate metadata acquisition for diverse collections.

How It Works

The tool offers flexible file handling via cut, copy, or hard links (default). Its key feature is optional AI integration (OpenAI/Google Gemini) for intelligent mapping of files to TMDB metadata, resolving naming discrepancies and classifying special content. It falls back to traditional rule-based recognition when AI is unavailable or fails.

Quick Start & Requirements

Requires Python (>= 3.9) and Git. Clone the repo (-b web), install dependencies (pip install -r requirements.txt), and run python -m src.start. A web UI (http://127.0.0.1:5999) requires TMDB API key configuration and optional AI API keys/settings.

Highlighted Details

• AI Recognition: Utilizes OpenAI/Google Gemini for intelligent file-to-metadata mapping, handling naming conflicts and special content with adjustable confidence.
• Automated Workflows: Integrates with qBittorrent for post-download renaming/organization via curl commands and optional tags (anime, movie, no_process).
• Complex Directory Handling: Parses and sorts files from nested source directories into categorized destinations.

Maintenance & Community

User contributions for test cases and issue reporting are encouraged. Specific details on maintainers, community channels, or sponsorships are not provided in the README.

Licensing & Compatibility

Licensed under GPL-3.0. A critical restriction states, "This project is for learning use only, please do not use for commercial purposes," impacting commercial application compatibility.

Limitations & Caveats

AI recognition is experimental; avoid using it in "move" mode. It requires network access and incurs API costs. Primarily optimized for anime series; Emby's native scraping is sufficient for movies/general series. Extremely complex series (e.g., Monogatari) may not be handled correctly. Default hard-linking ensures source file safety.