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).
