Welcome to EvoBot, your продвинутый media organization tool. This guide will help you rename, organize, and manage your media library efficiently.

1. Начало работы

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: Выберите 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 кнопка (play icon) to start processing.

3. Organizing Movies & TV Shows

Database Выберитеion

Вы можете choose specific metadata sources for different media types:

Series Database: Defaults to TheMovieDB. Вы можете 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: Вы можете 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 из source folder.

Clean: Удалитьs empty folders and clutter left behind in the source.

Apply:

chmod: Fixes file permissions.

refresh: Обновитьs 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, настроить your API keys in the Database Options section:

Прокрутите вниз to API Configuration.

Enter your keys for TMDb, TheTVDB, OMDb, TVmaze, AniDB, or ОткройтеSubtitles.

Click Сохранить 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 Выберитеion

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 настроитьd, 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 используется для 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 Выберитеion:

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

После успешного renaming, optional actions are triggered.

Apply:

chmod: Sets file permissions.

refresh: Обновитьs file modification time.

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

Extras:

Subtitles: Скачатьs subtitles via ОткройтеSubtitles if requested.

Artwork: Скачатьs posters and fanart if requested.

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

Library Обновитьs: 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).