FileOps

A working CLI prototype of the bulk-rename engine: a real template language (regex capture groups, counters, case transforms, date and size tokens), all-or-nothing collision safety so a clashing batch renames nothing at all, and a journal that reverses the entire operation. Verified: a mixed batch aborted without moving one file, and undo restored every path and hash exactly. EXIF/ID3 tokens and content find-and-replace are on the roadmap.

Recorded session

Naming status

Working name only — brand verdict **AVOID** (Very High). Collision: FileOps. Rename completely.

What it draws on

Existing paid software whose best ideas shaped this program: Directory Opus, Listary Pro, Duplicate Cleaner Pro, Advanced Renamer Commercial.

Command line

There is nothing extra to install. The program you download is the command-line tool as well: give it arguments instead of double-clicking it and it runs as one, with its output on your terminal. The standalone builds below are the same engine on its own, for machines where you would rather not ship a window at all.

fileops 1.0.0 - bulk rename engine with collision safety and undo

USAGE
  fileops rename  <dir> --match <regex> --to <template> [options]
  fileops preview <dir> --match <regex> --to <template> [options]
  fileops undo    --journal <file> [--apply] [--json]
  fileops help

COMMANDS
  rename    Plan renames; DRY RUN unless --apply is given.
  preview   Always read-only. Never touches the filesystem.
  undo      Reverse every rename recorded in a journal, newest first.
            DRY RUN unless --apply is given.

OPTIONS
  --match <regex>   Go regular expression matched against the FILE NAME.
  --to <template>   Destination name template (see TEMPLATE TOKENS).
  --recursive       Descend into subdirectories. Files are renamed in place;
                    directories themselves are never renamed.
  --start <N>       First value of the {n} counter (default 1).
  --pad <N>         Zero-pad {n} to N digits (default 0, no padding).
  --apply           Actually perform the renames. Without it, nothing changes.
  --journal <file>  Write (rename) or read (undo) the JSON undo journal.
  --json            Emit machine-readable JSON on stdout.
  -h, --help        Show this help and exit 0.

TEMPLATE TOKENS
  {1} {2} ...       Regex capture groups ({0} is the whole match).
  {name}            Original file name without its extension.
  {ext}             Extension including the leading dot ("" if none).
  {n}               Sequence counter, honours --start and --pad.
  {date}            File mtime formatted YYYY-MM-DD.
  {size}            File size in bytes.
  {upper:X}         Uppercase whatever X renders to.
  {lower:X}         Lowercase whatever X renders to.
  {title:X}         Title-case whatever X renders to.
                    Transforms nest, e.g. {upper:{name}}-{n}{ext}

SAFETY
  Files are visited in a deterministic sorted order, so {n} is reproducible.
...

Recorded from the shipped binary, not written by hand.

Source

Every file the program is built from:

console.go · console_test.go · guided.go · main.go

SHA-256 checksums · build instructions & scope notes · full build plan