Flavio's app supportAll guides · Sign in

← All guides

How to use CSV File Renamer

CSV File Renamer

Use a two-column CSV to preview filename changes, catch missing files and collisions, and save renamed copies on Mac.

Bought CSV File Renamer? Sign in with the email you bought it with to download the latest version or ask me a question.

On this page

Install

Download the ZIP from the purchase page or your Creem receipt. Unzip it and move CSV File Renamer to Applications. The app is signed and notarized, and runs on macOS 14 Sonoma or later on Apple silicon and Intel.

The app checks for updates once a day. When a new version is ready, click Install and Relaunch. To check anytime, choose CSV File Renamer → Check for Updates….

If your copy still asks for a key, download the latest version from your purchase page and replace the old app in Applications.

Prepare a CSV

Put the original filenames in the first column and the proposed filenames in the second. Include each file extension. The selected source folder should contain the files at its top level.

Existing filename,New filename
Scan 1.pdf,Juniper Archive - 001.pdf
Scan 2.pdf,Juniper Archive - 002.pdf
Scan 3.pdf,Juniper Archive - 003.pdf

This one has column names in its first row, so it needs First row contains column names. Under the box, the app counts the rows it will use.

Use Import… to open a UTF-8 CSV, or paste the CSV into Filename mapping CSV. Enable First row contains column names if your CSV has a header. Enable Read new filenames from the first column if the columns are reversed.

A filename containing a comma goes in quotes. To include a quote in a quoted filename, write it twice.

Preview and make copies

Choose the source folder and Save in location. Enter a new output folder name, then click Preview. Each row shows the existing filename, an arrow and the new filename, with a green Rename copy pill. A missing file, a repeated source filename, an output collision or an invalid name gets a red pill and moves to the top, with a line that explains it. Fix those rows in the CSV and preview again.

Click Create Renamed Copies. The app lists each renamed copy with its old name, and Rename map.csv. Show in Finder opens the new folder, and Rename Another Batch takes you back to the start. The original files are still available under their original names.

CSV File Renamer preview mapping six scans, Scan 1.pdf to Scan 6.pdf, to the Juniper Archive filenames, each with a green Rename copy pill

If an output folder already exists, choose a different name or location and preview again. Changes to the inputs also require a new preview. Cancel stops the work before delivery.

CSV File Renamer is $20, a one-time purchase.