This page documents launching the desktop UI with optional paths and flags. For the console program (mfrc) that renames with a saved preset, see Console Mode.
Launch the graphical app with optional paths and flags. Paths on the command line add items to the Rename List so you can preview and press GO in the UI. The desktop app does not accept preset, dry-run, confirm, or commit options - those belong to mfrc.
mfr.exe [<SOURCES>…] [--file-list <PATH>] [--initial-folder <PATH>]
[--config <PATH>] [-p|--preset <NAME>] [-l|--log-level <LEVEL>] [add
options]
SOURCES are one or more files, directories, or wildcards (space-separated). Quote paths that contain spaces. In a pattern such as D:\music\*.mp3, the include mask matches file names; it does not filter folders.
| Argument / option | Description |
|---|---|
<SOURCES>… |
Files, folders, or wildcards that seed the Rename List (same role as console sources, without running a preset). |
--file-list <PATH> |
UTF-8 text file with one filesystem path per line (blank lines skipped; path text is not trimmed). Lines are appended after any positional SOURCES. |
--initial-folder <PATH> |
Open the File List at this directory. Does not add paths by itself (UI-only; the console has no File List). When both sources and this option are set, sources still seed the Rename List and this path sets the File List folder. |
-p, --preset <NAME> |
Load this saved preset (exact name) after sources / browse intents. |
--config <PATH> |
Use this config.json instead of the usual AppData prefs file (File List mask, Rename List columns, Options, and other session settings). Missing path fails startup. Saves from this launch write back to the same file. |
-l, --log-level <LEVEL> |
Minimum log level for this process: debug, info, warn, or error (same names as console; default info). Applies to this launch only. |
After a successful add, if --initial-folder was not set, the File List opens the folder that contains the first added item and selects that item.
These options use the same names as the console. They apply only when seeding from
SOURCES or --file-list. When omitted, the desktop UI
uses the matching
Options preferences (Files inside, Folder itself,
Subfolders, Include hidden/system files).
| Option | Description |
|---|---|
--files <yes|no> |
Include files found inside folder sources and patterns (when omitted: Options - Files inside). File paths given directly are always included. |
--folders <yes|no> |
Include folders from sources (when omitted: Options - Folder itself). A folder path given directly is included when this is yes. |
-r, --recursive |
Expand directory sources recursively (when omitted: Options - Subfolders). |
--include-hidden |
Include hidden and system items found inside folder sources and patterns (when omitted: Options - Include hidden/system files). Paths given directly are always included. |
mfr.exe D:\music\*.mp3
mfr.exe D:\photos --files yes --folders no -r
mfr.exe --initial-folder D:\photos
mfr.exe D:\batch\a.jpg D:\batch\b.jpg --initial-folder D:\batch
mfr.exe --file-list D:\temp\paths.txt
mfr.exe D:\music --files yes --preset "Audio: Artist - Track - Title"
mfr.exe --log-level debug
See also: Console Mode, Options, FAQs - scripting.