Magic File Renamer Help


Console Mode

Use console mode to rename from a saved preset in a script. It also works from Task Scheduler. You do not need the desktop window.

Magic File Renamer 8 ships a console program named mfrc, separate from the graphical desktop app. Automatic renaming always requires a preset name and one or more source paths or wildcards.

To open the desktop UI with paths (seed the Rename List or browse a folder) without running a preset, see Command Line Parameters. Console mfrc remains the path for scripted rename automation.

Build or save the Filter Chain in the UI first (Save preset), then call the console with that preset. The console loads presets from the default AppData presets file unless you pass --presets-file.

On the desktop app, Tools → Command Line Builder writes that line for you. Pick a saved preset, check the File List source, then Copy. See Command Line Builder.

What it does

  1. Loads configuration (config.json) and optional --set overrides.
  2. Resolves sources into a Rename List (files and/or folders, optional recursion / hidden).
  3. Runs Preview with the preset's Filter Chain.
  4. If Preview has no errors, applies the changes (unless --dry-run).
  5. Optionally writes a JSON results file (--output-file).

If Preview reports any errors, the console stops without changing files. Session logging follows your config (same AppData log area as the UI).

Command-line parameters

Usage

mfrc <SOURCES>… -p|--preset <NAME> [options]

SOURCES are one or more files, directories, or wildcards (space-separated). Quote paths that contain spaces. Run mfrc --help for the built-in summary.

Required

Argument / option Description
<SOURCES> One or more files, directories, or wildcards to process.
-p, --preset <NAME> Preset name from the presets file (required). Save presets in the UI first. See Save preset.

Options

Option Description
--presets-file <PATH> Override the presets JSON file path (default: AppData finebytes MFR presets).
-o, --output-file <PATH> Write rename results as JSON to this path.
--include-hidden Include hidden and system files when expanding sources.
--files <yes|no> Include files from sources (default: yes).
--folders <yes|no> Include folders from sources (default: no).
-r, --recursive Expand directory sources recursively into subdirectories.
--continue-on-rename-error Keep going after a rename error instead of stopping at the first failure.
-c, --confirm Prompt for confirmation before applying each rename.
--dry-run Preview and report what would change, without changing files on disk.
--no-preview-details Do not log per-item preview change dumps (shown at info by default).
-l, --log-level <LEVEL> Minimum log level: debug, info, warn, or error (default info).
--show-log-levels Prefix console log lines with the level (for example [INF]). Off by default.
--config <PATH> Path to config.json (default: AppData). The file must exist when this option is set.
--set <KEY=VALUE> Override one preference (repeatable). Name the setting, then =, then the value (example: log.maxSessionFiles=200).

At least one of --files or --folders must be yes.

Exit codes

Code Meaning
0 Success (including when help/version output was requested).
1 User or configuration error (invalid arguments, missing preset, no matching sources, Preview errors, a rename failure when the run stops on the first error, and similar).
2 Unexpected application fault.

Examples

mfrc C:\Music\*.mp3 -p clean --dry-run mfrc C:\Music\*.flac -r -p lowercase-extension --log-level debug mfrc C:\Music -p name_from_id3 -r mfrc C:\Music C:\Podcasts -p my_preset --files yes --folders yes --output-file C:\Temp\mfr-results.json mfrc C:\Music -p clean --config C:\Temp\config.json --set log.maxSessionFiles=50

Command Line Builder

Command Line Builder
Command Line Builder.

Tools → Command Line Builder builds a ready-to-run mfrc line from the current window. It does not rename files itself.

The copied line starts with & so it runs in Command Prompt and PowerShell. Generate Rename Script is different: it writes .bat / .ps1 path ops from the current preview, not an mfrc command.

See also: Command Line Parameters (desktop UI), Presets, Rename Log, FAQs - scripting, User Interface.