config.ini

[GENERAL]
# Path to the folder containing the video files to rename.
# Example: "E:\\dl_torrent" or "/home/user/videos"
# Use double backslashes \\ on Windows or forward slashes /

folder_path = E:\\dl_torrent

# Enable interactive mode for manual search and selection when multiple or no matches are found.
# Set to True to allow user input during processing; False for fully automated batch mode.

interactive = True

# Enable or disable skipped file saving and reloading.
# When set to true, skipped files (e.g. unmatched or multi-match entries)
# will be saved during interactive mode and can be reloaded in a future run.
# Only has an effect when interactive mode is enabled.

skipped = False

# Minimum video file size (in megabytes) to include in processing.
# Helps exclude sample clips or other small, irrelevant video files.


# Enable undo functionality to restore original filenames from history
undo = False

# Path to the rename history JSON file used for undo
# If you leave it empty, it uses your latest rename session.
history_file = \rename_history\rename_history_2025-07-25_1310.json

vid_size = 500

# Whether to search subdirectories recursively for video files.
# Possible values: True or False

recursive = True

# Source of metadata (title and optionally year) used for API lookup.
# Options: "file", "folder", "fallback"
# "file": uses the filename to extract title/year.
# "folder": uses the parent folder name instead.
# "fallback": tries filename first; if no valid API result, falls back to folder name (recommended).

source_mode = fallback

# If True, the program will actually rename files.
# If False, it's a dry run that only prints changes.

live_run = False

# Whether to detect and separate sample video files (e.g., trailer, preview, sample clips)
sample = False

# Comma-separated keywords to detect sample videos (case insensitive, supports - and _ suffixes)
sample_keywords = sample,minta,trailer

# Whether to display emojis in terminal messages for better readability.
# Set to True to enable emojis, or False to keep output plain and compatible with all terminals.

# Emojis usually work well in:
#   - Modern terminals (Windows Terminal, macOS Terminal, Linux with UTF-8 support)
#   - IDE-integrated terminals (e.g. VSCode, PyCharm)

# Emojis may not display correctly in:
#   - Legacy Windows CMD or PowerShell without Unicode font support
#   - Non-UTF-8 terminals or basic remote shells (e.g. some SSH clients)

# For maximum compatibility (e.g. when running scripts on remote servers), keep this set to False.

use_emojis = False

[TEMPLATES]

# Note #1:
# If a variable cannot be extracted from the source (API, filename, or folder name),
# or the data does not exist, the value will be replaced with "unknown".

# Note #2:
# The variables below are extracted from your file or folder names.
# They are available for both movie and episode templates.
# If a variable isn't found for a movie or episode, it will default to "unknown".

# Available variables:
#   release_group       - Release group (e.g. SCammerGRoup)
#   source              - Source of the file (e.g. Blu-ray, Web)
#   other               - Additional tags (e.g. Retail, Remux, HDR10, Hybrid, Read NFO)
#   edition             - Edition type (e.g. Extended, Director's Cut)
#   streaming_service   - Streaming platform (e.g. AppleTV)

# Note #3:
# Some variables above like source or other may appear twice:
# once extracted from the file or folder name, and once from the file's technical metadata
# (such as video/audio codecs, resolution, HDR type, etc.).
# Important: these values do NOT overwrite each other.
# If your setup uses both sources, they can show up separately in the output.
# For example, a file might be marked as "Dual Audio" in the filename and also detected as "Dual Audio"
# via media analysis, in that case, both may be included depending on your configuration.

# Always check the log during a dry run to verify which values are being picked up
# and ensure they match your expectations.

# Custom variable for use in renaming templates.
# You can define any custom string value here to be included in your
# movie or episode filename templates, allowing personalized or
# project-specific tags, markers, or metadata.
# Example usage in a template: "{series_title} - S{season}E{episode} - {custom_variable}"

custom_variable = default

# Template for renaming movie files.
# Available variables:
#   movie_title                  - Movie title
#   movie_release_date           - Full release date (e.g. 2022-03-15)
#   movie_year                   - Release year (e.g. 2022)
#   resolution                   - Video resolution (e.g. 1080p, 4K)
#   video_codec                  - Video codec (e.g. H.264, H.265)
#   video_bitrate                - Video bitrate (e.g. 5 mbps)
#   framerate                    - Framerate (e.g. 23.98 fps, 25 fps)
#   audio_codec                  - Audio codec of the first audio track (e.g. Dolby Digital, DTS)
#   audio_channels               - Number of audio channels of the first audio track (e.g. Stereo, 5.1)
#   first_audio_channel_language - Language of the first audio track (e.g. en, hu)
#   audio_channels_description   - Human-readable audio description (e.g. Single Audio, Dual Audio, Multi Audio)
#   custom_variable              - A user-defined custom string that can be included in renaming templates for additional personalization or metadata.
#   genres			 - Genres of the movie (e.g: Action Drama Sci-Fi, it gives you a list if there're more genres than one with space separator)
#   imdb_rating			 - IMDb rating of the movie(format: 7.0)
#   rotten_rating		 - Rotten Tomatoes rating of the movie (format: 52)
#   metacritic_rating		 - Metacritic rating of the movie (format: 49)

movie_template = {custom_variable} + {movie_title} {movie_year}-{resolution}

# Example:
#   "Inception 2010-1080p H.264 AAC Stereo"

# Template for renaming episode files.
# Available variables:
#   series_title                  - Name of the TV series
#   first_air_date                - Series first air date (e.g. 2010-04-17)
#   first_air_year                - Year of the first air date (e.g. 2010)
#   last_air_date                 - Series last air date (e.g. 2024-12-01)
#   last_air_year                 - Year of the last air date (e.g. 2024)
#   status                        - Current status of the series (e.g. Returning Series, Ended)
#   episode_title                 - Title of the episode
#   season_number                 - Season number (with zero padding, next setting, e.g. 01, 02)
#   episode_number                - Episode number (with zero padding, next setting, e.g. 03, 10)
#   air_date                      - Episode air date (e.g. 2023-03-05)
#   air_year                      - Year of the air date (e.g. 2023)
#   resolution                    - Video resolution (e.g. 1080p, 4K)
#   video_codec                   - Video codec (e.g. H.264, H.265)
#   video_bitrate                 - Video bitrate (e.g. 5 mbps)
#   framerate                     - Framerate (e.g. 23.98 fps, 25 fps)
#   audio_codec                   - Audio codec of the first audio track (e.g. Dolby Digital, DTS)
#   audio_channels                - Number of audio channels of the first audio track (e.g. Stereo, 5.1)
#   first_audio_channel_language  - Language of the first audio track (e.g. en, hu)
#   audio_channels_description    - Human-readable audio description (e.g. Single Audio, Dual Audio, Multi Audio)
#   custom_variable               - A user-defined custom string that can be included in renaming templates for additional personalization or metadata.
#   genres			  - Genres of the series (e.g: Action Drama Sci-Fi, it gives you a list if there're more genres than one with space separator)
#   imdb_rating			  - IMDb rating of the series (format: 7.0)
#   rotten_rating		  - Rotten Tomatoes rating of the series (format: 52)
#   metacritic_rating		  - Metacritic rating of the series (format: 49)

episode_template = {custom_variable} + {series_title} - S{season_number}E{episode_number} - {episode_title}-{air_date}-{resolution}

# Example:
#   "Friends - S01E03 - The One with the Thumb-1994-09-22-720p"

# Whether to use zero-padding for season and episode numbers.
# True -> S01E01
# False -> S1E1

zero_padding = True

# Controls the case of the new filename: lower, upper, title, or none

filename_case = title

# Controls the separator used between words in the filename:
# options: space, dot, dash, underscore

separator = space

[API]
# Your API key for OMDb.
# Even though, the script uses TMDb as the main metadata source, some informations obtained from OMDb.

omdb_key = your_omdb_key_here

# Your API key for TMDb.
# Required to run the script.

tmdb_key = your_tmdb_key_here

# Bearer token for TMDb API authorization.
# Required to run the script.

tmdb_bearer_token = your_tmdb_token_here