Welcome to EvoBot, your advanced 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 from the 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).