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

1. Primeros pasos #

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

Action: Elija how files are handled:

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

Copiar: Copies files, keeping originals.

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

Symlink: Creates a symbolic link.

Hardlink or Copiar: 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 Seleccioneion #

Puede choose specific metadata sources for different media types:

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

Apply:

chmod: Correcciónes file permissions.

refresh: Actualizars file timestamps.

Exec: Run a custom command on each processed file.

Example: mv *

Notifications #

Get alerted when tasks finish:

Discord: Pegar your Discord Webhook URL.

Pushover: Ingrese your User Key and API Token.

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

Ingrese your keys for TMDb, TheTVDB, OMDb, TVmaze, AniDB, or AbrirSubtitles.

Click Guardar 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 Seleccioneion #

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

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

2. Filtering & Exclusion #

Antes de 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 Seleccioneion:

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

Copiar: Copies the file.

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

Symlink: Creates a symbolic link.

Hardlink or Copiar: 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 #

Después de exitoso renaming, optional actions are triggered.

Apply:

chmod: Sets file permissions.

refresh: Actualizars file modification time.

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

Extras:

Subtitles: Descargars subtitles via AbrirSubtitles if requested.

Artwork: Descargars posters and fanart if requested.

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

Library Actualizars: 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).