How to Rename Files in Terminal on Mac

How Do You Rename a Single File in Terminal on Mac?

The mvcommand is built into macOS and requires no installation. Open Terminal from Applications, Utilities, or by pressing Cmd+Space and typing "Terminal." Navigate to the directory containing your file with cd /path/to/directory and run mv report_draft.txt report_final.txt to rename the file instantly.

Quoting filenames is essential when they contain spaces or special characters. The command mv "My Document.txt" "My Report.txt" handles spaces correctly because the quotes prevent the shell from splitting the filename into separate arguments. Unquoted filenames with spaces cause the shell to interpret each word as a separate file, which produces errors or renames the wrong files entirely.

The mv command overwrites existing files without warning by default. Running mv notes.txt readme.txt when readme.txt already exists destroys the original readme.txt silently. The -i flag adds an interactive prompt: mv -i notes.txt readme.txt asks for confirmation before overwriting. The -n flag prevents overwriting entirely by refusing to replace any existing file.

How Do You Batch Rename Files Using a for Loop in Terminal?

The glob pattern after in determines which files the loop processes. The pattern *.jpg matches all JPEG files. The pattern IMG_*.pngmatches PNG files starting with "IMG_" and the pattern * matches every file in the directory. Each iteration assigns the current filename to the variable $f which you reference inside the do ... done block.

Parameter expansion transforms filenames within the loop without external tools. The expression ${f%.jpg}.png strips the .jpg extension and appends .pnginstead, which effectively changes every file's extension. The expression ${f#IMG_}removes the prefix "IMG_" from the beginning of each filename. These expansions are built into Bash and execute faster than piping through sed or awk.

A counter variable inside the loop adds sequential numbers to filenames. Initialize the counter with i=1 before the loop, use mv "$f" "photo_$i.jpg" inside the loop body, and increment with ((i++)) after each rename. Zero padding requires printf formatting: mv "$f" "$(printf 'photo_%03d.jpg' $i)" produces filenames like photo_001.jpg, photo_002.jpg, and photo_003.jpg.

How Do You Use the rename Utility for Regex Renaming?

Homebrew must be installed before you can use the rename utility. Visit brew.sh to install Homebrew if you have not done so already, then run brew install rename in Terminal. The installation adds the rename command to your PATH and makes it available in every Terminal session.

The renamesyntax follows Perl's substitution operator: s/pattern/replacement/flags. The pattern uses full Perl regex syntax including character classes like \d for digits, \w for word characters, and quantifiers like + and *. Capture groups enclosed in parentheses store matched text for use in the replacement string as $1, $2, and so on. The g flag applies the replacement to every occurrence within the filename rather than just the first match.

The -n flag runs a dry run that prints the proposed renames without executing them. Always run rename -n 's/pattern/replacement/' *.ext first to verify the output before committing. The -v flag enables verbose mode, which prints each rename as it happens. Batchio's find and replace with regex support provides the same Perl regex power in a visual interface where every change appears in a live preview before you commit.

Can You Add Prefixes or Suffixes to Files in Terminal?

Prefix addition is the simplest batch operation in Terminal because string concatenation places the new text before the variable. The command for f in *.pdf; do mv "$f" "2026_$f"; done adds the year prefix to every PDF file. The rename equivalent is rename 's/^/2026_/' *.pdf where the caret ^ anchors the match to the start of the filename.

Suffix addition requires more care because the new text must appear before the extension rather than after it. Parameter expansion handles this cleanly: for f in *.jpg; do mv "$f" "${f%.jpg}_edited.jpg"; done strips the extension, appends the suffix, and reattaches the extension. The rename approach uses a capture group: rename 's/(\.\w+)$/_edited$1/' *.jpg captures the extension and places the suffix before it.

Date based prefixes are common for organizing files chronologically. The command for f in *.png; do mv "$f" "$(date +%Y-%m-%d)_$f"; doneprepends today's date to every PNG file. For more complex date patterns or metadata based dates, see the regex file renaming guide which covers advanced pattern construction.

How Do You Remove Characters from Filenames in Terminal?

Parameter expansion provides the fastest method for removing specific characters without external tools. The syntax ${variable//pattern/replacement}performs global substitution within the variable's value. Setting the replacement to empty effectively deletes every match. The command for f in *; do mv "$f" "${f// /_}"; done replaces all spaces with underscores in every filename in the current directory.

The tr command translates or deletes characters from a string piped through it. The command for f in *; do mv "$f" "$(echo "$f" | tr -d ' ')"; done deletes all spaces from filenames by piping each name through tr with the delete flag. The tr command works on single characters only and cannot match multi character patterns or regular expressions.

The rename utility handles complex character removal with regex. The command rename 's/\s+/_/g' * replaces all whitespace sequences with a single underscore. The command rename 's/[()]//g' * strips parentheses and curly braces from every filename. For bulk character removal across large file collections, Batchio's batch rename files on Mac approach provides a dedicated remove characters rule with checkboxes for common character categories.

What Are the Limitations of Terminal File Renaming?

The absence of a preview is the most significant limitation. The rename utility's -n dry run flag helps, but mv commands in for loops have no equivalent. You must visually parse the command and mentally simulate its effect on every filename. Complex parameter expansions and nested substitutions make this mental simulation unreliable for large batches.

Terminal provides no undo mechanism for file renames. Once mv executes, the original filename is gone. Recovering requires either running a reversal command, restoring from Time Machine, or recreating the original names manually. Accidental overwrites caused by naming collisions are permanent because mv replaces existing files silently unless you remembered the -i or -n flag.

Batchio's live previewsolves every limitation of Terminal renaming. The two column view shows original names on the left and new names on the right, with changed portions highlighted. Conflict detection warns you before any files would overwrite each other. Full undo support stores up to 100 rename operations in history, so you can revert any mistake with Cmd+Z. For users who need Terminal's regex power without Terminal's risks, Batchio provides the best of both approaches in a native macOS interface.

Frequently Asked Questions