Welcome to EvoBot, your advanced media organization tool. This guide will help you rename, organize, and manage your media library efficiently.
1. Erste Schritte #
Access the EvoBot interface via your web browser (usually http://localhost:5452or your server's IP).
The Interface #
Organize Files: The main panel for setting up your renaming task.
Output Buffer: Shows the logs and progress of your tasks.
System Info: Displays version and system details.
2. Basic Usage: Renaming Your Media #
Input Folder: Klicken Sie auf den folder icon to wählen Sie the directory containing your unorganized media.
Output Folder: Wählen Sie the destination directory where organized files should be moved/copied.
Action: Wählen Sie how files are handled:
Move: Moves files to the new location (default).
Kopieren: Copies files, keeping originals.
Hardlink: Creates a hardlink (instant, speicherns space).
Symlink: Creates a symbolic link.
Hardlink or Kopieren: Tries hardlink, falls back to kopieren.
Strict Mode: Uncheck this wenn Sie want EvoBot to guess matches for messy filenames. Keep checked for accuracy.
Run: Klicken Sie auf den Run button (play icon) to start processing.
3. Organizing Movies & TV Shows #
Database Wählen Sieion #
Sie können wählen Sie specific metadata sources for different media tippen Sies:
Series Database: Defaults to TheMovieDB. Sie können switch to TheTVDB, TVmaze, or AniDB.
Anime Database: Defaults to TheMovieDB. Switch to AniDB for specialized anime metadata.
Movie Database: Defaults to TheMovieDB.
Naming Formats #
Customize how your files are named in the Format Options section.
Standard: {plex}(Recommended for Plex/Emby).
Custom: Sie können use bindings like {n}(Title), {y}(Year), {s00e00}(Episode), {vf}(ReLösung).
Example: {n} ({y})/{n} – {s00e00} – {t}
4. Advanced Features #
Filtering #
Skip unwanted files using the Match Filter or File Options:
Exclude List: Prevents re-processing the same files.
Exclude Link: Skips symbolic links.
Min File Size/Age: Filter by size or age.
Custom Filter: Use expressions like age < 7(files newer than 7 days) or size > 100MB.
Post-Processing #
Automate tasks nach renaming:
ImPort Extras: Copies artwork, nfo files, and subtitles from the source folder.
Clean: Löschens empty folders and clutter left behind in the source.
Apply:
chmod: Lösunges file permissions.
refresh: Aktualisierens file timestamps.
Exec: Run a custom command on each processed file.
Example: mv *
Notifications #
Get alerted when tasks finish:
Discord: Einfügen your Discord Webhook URL.
Pushover: Geben Sie ein your User Key and API Token.
Plex/Emby/Jellyfin: Geben Sie ein your host and token to trigger a library scan automatically.
5. API Configuration #
To use premium or restricted services, configure your API keys in the Database Options section:
Scroll down to API Configuration.
Geben Sie ein your keys for TMDb, TheTVDB, OMDb, TVmaze, AniDB, or ÖffnenSubtitles.
Click Speichern API Keys.
6. Troubleshooting #
No Match Found: Try using Manual Query (–q) to force a specific suchen term.
Wrong Match: Enable Strict Mode or check your file naming.
Logs: Check the Output Buffer for detailed Fehler messages.
EvoBot Default Processing Flow #
This document outlines how EvoBot (formerly FileBot Node) processes media files by default. The pipeline is designed to be robust, automated, and configurable.
1. Input Wählen Sieion #
The process begins when the user wählen Sies an Input Folder in the UI.
Recursive Scan: The system recursively scans the input folder for media files.
File Tippen Sies: It identifies video files (e.g., .mkv, .mp4, .avi) and, if aktiviert, music files (.mp3, .flac).
Archives: If configured, archives (.zip, .rar) are extracted using 7zvor processing.
2. Filtering & Exclusion #
Vor processing, files are filtered to avoid unnecessary work or conflicts.
Exclude List: If an exclude list file (e.g., .excludes) is provided, files listed therein are skipped.
Exclude Links: Symbolic links are ignored if excludeLink=yis set.
Filters: Custom filters (e.g., age < 7, size > 100MB) are applied to skip files based on attributes.
Clutter: Small artifacts (e.g., .nfo, .txt in the input) are ignored unless imPort logic is active.
3. Grouping & Identification #
The system attempts to group files and identify their tippen Sie (Movie vs. Series vs. Anime).
Auto-Detection: Heuristics are used to determine if a file is a movie or an episode (e.g., S01E01patterns suggest Series).
Forced Mode: Users can force a specific mode (Movie, Series, Anime) via the UI.
Database Wählen Sieion:
Series: Defaults to TheMovieDB (TMDb). Can be overridden to TheTVDB, TVmaze, or AniDB.
Movies: Defaults to TheMovieDB (TMDb).
Anime: Defaults to TheMovieDB (TMDb) or AniDB if wählen Sieed.
4. Matching #
Once identified, the system suchenes the wählen Sieed database for metadata.
Query: The filename is cleaned and used as a suchen query. Users can override this with a manual –qquery.
Language: Results are fetched in the preferred language (default: English).
Strict Mode: In strict mode, exact matches are required. In non-strict mode, the best fuzzy match is accepted.
5. Formatting #
The matched metadata is applied to a naming format.
Format Strings: Users define formats (e.g., {plex}, {n} – {s00e00} – {t}).
Bindings: Variables like {n}(name), {y}(year), {vf}(video format) are substituted with metadata.
Destination: The format determines the final relative path and filename.
6. Renaming & Action #
The file is processed according to the wählen Sieed Action.
Move: Moves the file to the destination (default).
Kopieren: Copies the file.
Hardlink: Creates a hardlink (speicherns space, requires same filesystem).
Symlink: Creates a symbolic link.
Hardlink or Kopieren: Attempts hardlink, falls back to kopieren on failure.
Conflict ReLösung: If the destination exists, the system can skip, override, fail, or auto(overwrite if better).
7. Post-Processing #
Nach erfolgreich renaming, optional actions are triggered.
Apply:
chmod: Sets file permissions.
refresh: Aktualisierens file modification time.
imPort: Copies sibling files (artwork, subs) from source.
Extras:
Subtitles: Herunterladens subtitles via ÖffnenSubtitles if requested.
Artwork: Herunterladens posters and fanart if requested.
Notifications: Sends aktualisierens to Discord, Pushover, Pushbullet, etc.
Library Aktualisierens: Triggers scans in Plex, Emby, Jellyfin, or Kodi.
Cleaning: If clean=y, empty folders and clutter in the source directory are löschend.
RePorting: A log entry is written to the rePort file (e.g., amc.log).
