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

1. Başlarken

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: Seçin 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 düğme (play icon) to start processing.

3. Organizing Movies & TV Shows

Database Seçinion

Yapabilirsiniz choose specific metadata sources for different media types:

Series Database: Defaults to TheMovieDB. Yapabilirsiniz 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: Yapabilirsiniz 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 den source folder.

Clean: Silins empty folders and clutter left behind in the source.

Apply:

chmod: Fixes file permissions.

refresh: Güncelleyins 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, yapılandırın your API keys in the Database Options section:

Aşağı kaydırın to API Configuration.

Enter your keys for TMDb, TheTVDB, OMDb, TVmaze, AniDB, or AçınSubtitles.

Click Kaydedin 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 Seçinion

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 yapılandırınd, 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 kullanılır 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 Seçinion:

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

Başarılı renaming, optional actions are triggered.

Apply:

chmod: Sets file permissions.

refresh: Güncelleyins file modification time.

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

Extras:

Subtitles: İndirins subtitles via AçınSubtitles if requested.

Artwork: İndirins posters and fanart if requested.

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

Library Güncelleyins: 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).