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.
If Preview reports any errors, the console stops without changing files. Session logging follows your config (same AppData log area as the UI).
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.
| 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. |
| 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.
| 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. |
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
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.