Welcome to EvoBot, your advanced media organization tool. This guide will help you rename, organize, and manage your media library efficiently.

1. Pour commencer

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: Sélectionnez the destination directory where organized files should be moved/copied.

Action: Choisissez how files are handled:

Move: Moves files to the new location (default).

Copier: Copies files, keeping originals.

Hardlink: Creates a hardlink (instant, saves space).

Symlink: Creates a symbolic link.

Hardlink or Copier: 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 Sélectionnezion

Vous pouvez choose specific metadata sources for different media types:

Series Database: Defaults to TheMovieDB. Vous pouvez 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: Vous pouvez 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: Supprimers empty folders and clutter left behind in the source.

Apply:

chmod: Correctiones file permissions.

refresh: Mettre à jours file timestamps.

Exec: Run a custom command on each processed file.

Example: mv *

Notifications

Get alerted when tasks finish:

Discord: Coller your Discord Webhook URL.

Pushover: Entrez your User Key and API Token.

Plex/Emby/Jellyfin: Entrez 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.

Entrez your keys for TMDb, TheTVDB, OMDb, TVmaze, AniDB, or OuvrirSubtitles.

Click Enregistrer 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 Sélectionnezion

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 activé, music files (.mp3, .flac).

Archives: If configured, archives (.zip, .rar) are extracted using 7zbefore processing.

2. Filtering & Exclusion

Avant 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 Sélectionnezion:

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

Copier: Copies the file.

Hardlink: Creates a hardlink (saves space, requires same filesystem).

Symlink: Creates a symbolic link.

Hardlink or Copier: 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

Après réussi renaming, optional actions are triggered.

Apply:

chmod: Sets file permissions.

refresh: Mettre à jours file modification time.

import: Copies sibling files (artwork, subs) from source.

Extras:

Subtitles: Téléchargers subtitles via OuvrirSubtitles if requested.

Artwork: Téléchargers posters and fanart if requested.

Notifications: Sends updates to Discord, Pushover, Pushbullet, etc.

Library Mettre à jours: 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).