{"id":17507,"date":"2026-03-16T13:23:23","date_gmt":"2026-03-16T12:23:23","guid":{"rendered":"https:\/\/evoseedbox.com\/docs\/evobot-user-guide-pt-pt\/"},"modified":"2026-03-16T13:23:23","modified_gmt":"2026-03-16T12:23:23","password":"","slug":"evobot-user-guide-pt-pt","status":"publish","type":"docs","link":"https:\/\/evoseedbox.com\/pt-pt\/wiki\/evobot-user-guide-pt-pt\/","title":{"rendered":"Evobot Guia do usu\u00e1rio"},"content":{"rendered":"

Welcome to EvoBot<\/strong>, your avan\u00e7ado media organization tool. This guide will help you rename, organize, and manage your media library efficiently.<\/p>\n

1. Primeiros passos<\/h2>\n

Access the EvoBot interface via your web browser (usually http:\/\/localhost:5452or your server's IP).<\/p>\n

The Interface<\/h3>\n

Organize Files<\/strong>: The main panel for setting up your renaming task.<\/p>\n

Output Buffer<\/strong>: Shows the logs and progress of your tasks.<\/p>\n

System Info<\/strong>: Displays version and system details.<\/p>\n

2. Basic Usage: Renaming Your Media<\/h2>\n

Input Folder<\/strong>: Click the folder icon to select the directory containing your unorganized media.<\/p>\n

Output Folder<\/strong>: Selecione the destination directory where organized files should be moved\/copied.<\/p>\n

Action<\/strong>: Choose how files are handled:<\/p>\n

Move<\/strong>: Moves files para o new location (default).<\/p>\n

Copy<\/strong>: Copies files, keeping originals.<\/p>\n

Hardlink<\/strong>: Creates a hardlink (instant, saves space).<\/p>\n

Symlink<\/strong>: Creates a symbolic link.<\/p>\n

Hardlink or Copy<\/strong>: Tries hardlink, falls back to copy.<\/p>\n

Strict Mode<\/strong>: Uncheck this if you want EvoBot to guess matches for messy filenames. Keep checked for accuracy.<\/p>\n

Run<\/strong>: Click the Run<\/strong> bot\u00e3o (play icon) to start processing.<\/p>\n

3. Organizing Movies & TV Shows<\/h2>\n

Database Selecioneion<\/h3>\n

Voc\u00ea pode choose specific metadata sources for different media types:<\/p>\n

Series Database<\/strong>: Defaults to TheMovieDB<\/strong>. Voc\u00ea pode switch to TheTVDB<\/strong>, TVmaze<\/strong>, or AniDB<\/strong>.<\/p>\n

Anime Database<\/strong>: Defaults to TheMovieDB<\/strong>. Switch to AniDB<\/strong> for specialized anime metadata.<\/p>\n

Movie Database<\/strong>: Defaults to TheMovieDB<\/strong>.<\/p>\n

Naming Formats<\/h3>\n

Customize how your files are named in the Format Options<\/strong> section.<\/p>\n

Standard<\/strong>: {plex}(Recommended for Plex\/Emby).<\/p>\n

Custom<\/strong>: Voc\u00ea pode use bindings like {n}(Title), {y}(Year), {s00e00}(Episode), {vf}(Resolution).<\/p>\n

Example<\/em>: {n} ({y})\/{n} – {s00e00} – {t}<\/p>\n

4. Advanced Features<\/h2>\n

Filtering<\/h3>\n

Skip unwanted files using the Match Filter<\/strong> or File Options<\/strong>:<\/p>\n

Exclude List<\/strong>: Prevents re-processing the same files.<\/p>\n

Exclude Link<\/strong>: Skips symbolic links.<\/p>\n

Min File Size\/Age<\/strong>: Filter by size or age.<\/p>\n

Custom Filter<\/strong>: Use expressions like age < 7(files newer than 7 days) or size > 100MB.<\/p>\n

Post-Processing<\/h3>\n

Automate tasks after renaming:<\/p>\n

Import Extras<\/strong>: Copies artwork, nfo files, and subtitles do source folder.<\/p>\n

Clean<\/strong>: Excluirs empty folders and clutter left behind in the source.<\/p>\n

Apply<\/strong>:<\/p>\n

chmod<\/strong>: Fixes file permissions.<\/p>\n

refresh<\/strong>: Atualizars file timestamps.<\/p>\n

Exec<\/strong>: Run a custom command on each processed file.<\/p>\n

Example<\/em>: mv *<\/p>\n

Notifications<\/h3>\n

Get alerted when tasks finish:<\/p>\n

Discord<\/strong>: Paste your Discord Webhook URL.<\/p>\n

Pushover<\/strong>: Enter your User Key and API Token.<\/p>\n

Plex\/Emby\/Jellyfin<\/strong>: Enter your host and token to trigger a library scan automatically.<\/p>\n

5. API Configuration<\/h2>\n

To use premium or restricted services, configurar your API keys in the Database Options<\/strong> section:<\/p>\n

Role para baixo to API Configuration<\/strong>.<\/p>\n

Enter your keys for TMDb<\/strong>, TheTVDB<\/strong>, OMDb<\/strong>, TVmaze<\/strong>, AniDB<\/strong>, or AbrirSubtitles<\/strong>.<\/p>\n

Click Salvar API Keys<\/strong>.<\/p>\n

6. Troubleshooting<\/h2>\n

No Match Found<\/strong>: Try using Manual Query<\/strong> (–q) to force a specific search term.<\/p>\n

Wrong Match<\/strong>: Enable Strict Mode<\/strong> or check your file naming.<\/p>\n

Logs<\/strong>: Check the Output Buffer<\/strong> for detailed error messages.<\/p>\n

EvoBot Default Processing Flow<\/h1>\n

This document outlines how EvoBot (formerly FileBot Node) processes media files by default. The pipeline is designed to be robust, automated, and configurable.<\/p>\n

1. Input Selecioneion<\/h2>\n

O processo begins when the user selects an Input Folder<\/strong> in the UI.<\/p>\n

Recursive Scan<\/strong>: The system recursively scans the input folder for media files.<\/p>\n

File Types<\/strong>: It identifies video files (e.g., .mkv, .mp4, .avi) and, if enabled, music files (.mp3, .flac).<\/p>\n

Archives<\/strong>: If configurard, archives (.zip, .rar) are extracted using 7zbefore processing.<\/p>\n

2. Filtering & Exclusion<\/h2>\n

Before processing, files are filtered to avoid unnecessary work or conflicts.<\/p>\n

Exclude List<\/strong>: If an exclude list file (e.g., .excludes) is provided, files listed therein are skipped.<\/p>\n

Exclude Links<\/strong>: Symbolic links are ignored if excludeLink=yis set.<\/p>\n

Filters<\/strong>: Custom filters (e.g., age < 7, size > 100MB) are applied to skip files based on attributes.<\/p>\n

Clutter<\/strong>: Small artifacts (e.g., .nfo, .txt in the input) are ignored unless import logic is active.<\/p>\n

3. Grouping & Identification<\/h2>\n

The system attempts to group files and identify their type (Movie vs. Series vs. Anime).<\/p>\n

Auto-Detection<\/strong>: Heuristics are usado para determine if a file is a movie or an episode (e.g., S01E01patterns suggest Series).<\/p>\n

Forced Mode<\/strong>: Users can force a specific mode (Movie, Series, Anime) via the UI.<\/p>\n

Database Selecioneion<\/strong>:<\/p>\n

Series<\/strong>: Defaults to TheMovieDB<\/strong> (TMDb). Can be overridden to TheTVDB<\/strong>, TVmaze<\/strong>, or AniDB<\/strong>.<\/p>\n

Movies<\/strong>: Defaults to TheMovieDB<\/strong> (TMDb).<\/p>\n

Anime<\/strong>: Defaults to TheMovieDB<\/strong> (TMDb) or AniDB<\/strong> if selected.<\/p>\n

4. Matching<\/h2>\n

Once identified, the system searches the selected database for metadata.<\/p>\n

Query<\/strong>: The filename is cleaned and used as a search query. Users can override this with a manual –qquery.<\/p>\n

Language<\/strong>: Results are fetched in the preferred language (default: English).<\/p>\n

Strict Mode<\/strong>: In strict mode, exact matches are required. In non-strict mode, the best fuzzy match is accepted.<\/p>\n

5. Formatting<\/h2>\n

The matched metadata is applied to a naming format.<\/p>\n

Format Strings<\/strong>: Users define formats (e.g., {plex}, {n} – {s00e00} – {t}).<\/p>\n

Bindings<\/strong>: Variables like {n}(name), {y}(year), {vf}(video format) are substituted with metadata.<\/p>\n

Destination<\/strong>: The format determines the final relative path and filename.<\/p>\n

6. Renaming & Action<\/h2>\n

The file is processed according para o selected Action<\/strong>.<\/p>\n

Move<\/strong>: Moves the file para o destination (default).<\/p>\n

Copy<\/strong>: Copies the file.<\/p>\n

Hardlink<\/strong>: Creates a hardlink (saves space, requires same filesystem).<\/p>\n

Symlink<\/strong>: Creates a symbolic link.<\/p>\n

Hardlink or Copy<\/strong>: Attempts hardlink, falls back to copy on failure.<\/p>\n

Conflict Resolution<\/strong>: If the destination exists, the system can skip, override, fail, or auto(overwrite if better).<\/p>\n

7. Post-Processing<\/h2>\n

Ap\u00f3s o sucesso renaming, optional actions are triggered.<\/p>\n

Apply<\/strong>:<\/p>\n

chmod: Sets file permissions.<\/p>\n

refresh: Atualizars file modification time.<\/p>\n

import: Copies sibling files (artwork, subs) from source.<\/p>\n

Extras<\/strong>:<\/p>\n

Subtitles<\/strong>: Baixars subtitles via AbrirSubtitles if requested.<\/p>\n

Artwork<\/strong>: Baixars posters and fanart if requested.<\/p>\n

Notifications<\/strong>: Sends updates to Discord, Pushover, Pushbullet, etc.<\/p>\n

Library Atualizars<\/strong>: Triggers scans in Plex, Emby, Jellyfin, or Kodi.<\/p>\n

Cleaning<\/strong>: If clean=y, empty folders and clutter in the source directory are deleted.<\/p>\n

Reporting<\/strong>: A log entry is written para o report file (e.g., amc.log).<\/p>\n","protected":false},"excerpt":{"rendered":"

Welcome to EvoBot, your avan\u00e7ado media organization tool. This guide will help you rename, organize, and manage your media library efficiently. 1. […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[],"doc_tag":[],"class_list":["post-17507","docs","type-docs","status-publish","hentry"],"year_month":"2026-04","word_count":967,"total_views":"11","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Tim Michels","author_nicename":"admin","author_url":"https:\/\/evoseedbox.com\/pt-pt\/author\/admin\/"},"doc_category_info":[],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/docs\/17507","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=17507"}],"version-history":[{"count":0,"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/docs\/17507\/revisions"}],"wp:attachment":[{"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=17507"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/doc_category?post=17507"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/evoseedbox.com\/pt-pt\/wp-json\/wp\/v2\/doc_tag?post=17507"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}