Welcome to EvoBot, your advanced media organization tool. This guide will help you rename, organize, and manage your media library efficiently.
1. Getting Started #
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: Click the folder icon to select the directory containing your unorganized media.
Output Folder: Select the destination directory where organized files should be moved/copied.
Action: Choose how files are handled:
Move: Moves files to the new location (default).
Copy: Copies files, keeping originals.
Hardlink: Creates a hardlink (instant, saves space).
Symlink: Creates a symbolic link.
Hardlink or Copy: Tries hardlink, falls back to copy.
Strict Mode: Uncheck this if you want EvoBot to guess matches for messy filenames. Keep checked for accuracy.
Run: Click the Run button (play icon) to start processing.
3. Organizing Movies & TV Shows #
Database Selection #
You can choose specific metadata sources for different media types:
Series Database: Defaults to TheMovieDB. You can 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: You can use bindings like {n}(Title), {y}(Year), {s00e00}(Episode), {vf}(Resolution).
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 after renaming:
Import Extras: Copies artwork, nfo files, and subtitles from the source folder.
Clean: Deletes empty folders and clutter left behind in the source.
Apply:
chmod: Fixes file permissions.
refresh: Updates file timestamps.
Exec: Run a custom command on each processed file.
Example: mv *
Notifications #
Get alerted when tasks finish:
Discord: Paste your Discord Webhook URL.
Pushover: Enter your User Key and API Token.
Plex/Emby/Jellyfin: Enter 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.
Enter your keys for TMDb, TheTVDB, OMDb, TVmaze, AniDB, or OpenSubtitles.
Click Save API Keys.
6. Troubleshooting #
No Match Found: Try using Manual Query (–q) to force a specific search term.
Wrong Match: Enable Strict Mode or check your file naming.
Logs: Check the Output Buffer for detailed error 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 Selection #
The process begins when the user selects an Input Folder in the UI.
Recursive Scan: The system recursively scans the input folder for media files.
File Types: It identifies video files (e.g., .mkv, .mp4, .avi) and, if enabled, music files (.mp3, .flac).
Archives: If configured, archives (.zip, .rar) are extracted using 7zbefore processing.
2. Filtering & Exclusion #
Before 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 type (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 Selection:
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 selected.
4. Matching #
Once identified, the system searches the selected database for metadata.
Query: The filename is cleaned and used as a search 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 selected Action.
Move: Moves the file to the destination (default).
Copy: Copies the file.
Hardlink: Creates a hardlink (saves space, requires same filesystem).
Symlink: Creates a symbolic link.
Hardlink or Copy: Attempts hardlink, falls back to copy on failure.
Conflict Resolution: If the destination exists, the system can skip, override, fail, or auto(overwrite if better).
7. Post-Processing #
After successful renaming, optional actions are triggered.
Apply:
chmod: Sets file permissions.
refresh: Updates file modification time.
import: Copies sibling files (artwork, subs) from source.
Extras:
Subtitles: Downloads subtitles via OpenSubtitles if requested.
Artwork: Downloads posters and fanart if requested.
Notifications: Sends updates to Discord, Pushover, Pushbullet, etc.
Library Updates: Triggers scans in Plex, Emby, Jellyfin, or Kodi.
Cleaning: If clean=y, empty folders and clutter in the source directory are deleted.
Reporting: A log entry is written to the report file (e.g., amc.log).
