Media Renamer Pro support
Something not behaving? Start here. If the answer is not below, email me and I will actually reply.
Email: mediarenamerpro@gmail.com
Include your device, your macOS or iOS version, the app version, and a couple of example filenames before and after. Most replies go out within two business days.
Community: Prefer chat? Join the Media Renamer Pro Discord to ask questions, share your naming setups and suggest features. Email still works for anything private.
Getting started
Nothing happens after I add files.
Renaming never starts on its own. Add your files, pick the media type tab, then press Preview. The app builds a plan and shows you every old and new name. Nothing on disk changes until you press Rename.
On Mac it says Grant Access and will not let me continue.
macOS only gives the app the exact folder you select. In the picker, go up one level, select the target folder itself rather than looking inside it, then click Grant Access. If you hand the app individual files instead of a folder, it can work with those files but cannot see anything else in the folder.
Do I need an API key?
No. The app works without one. TVmaze, OpenLibrary, MusicBrainz and RAWG need nothing. TMDb, OMDb and IGDB use your own free key if you add one in Settings. Cloud photo descriptions use your own OpenAI, Gemini or Anthropic key. There is no account and nothing to subscribe to.
How do I rename from Finder?
In version 1.3.2 and later, select files in Finder, right click, and choose Rename with Media Renamer Pro. The app opens with those files already loaded. If you do not see the item, open the app once first, then look under the Services submenu.
New in 2.0
How do I edit tags and cover art?
Turn on Tag editor in Settings, General, Tags (it is off until you do). Then right-click a file in the list, or long-press on iPhone and iPad, and choose Edit tags. Change the fields, press Preview changes to see the before and after, then Write tags. Undo puts the file back exactly. The edit tags guide has the full steps.
I cannot find Edit tags.
The Tag editor switch in Settings, General, Tags is off by default, and the menu item only appears when it is on and the file type can be written. Tags can be written in MP3, MP4, M4V, M4A, M4B, MKV and WebM files. Other types, such as FLAC, OGG, MOV and AVI, are renamed only. Game files are not tag edited.
Does changing tags change my files?
Yes. Changing tags changes the file itself. Apps that watch files for changes (backup, sync, download or media-manager tools) may treat it as a new or changed file. Undo puts it back exactly. Try a small folder first and keep a backup of anything you cannot replace.
How do I fix a wrong match?
Click the tag icon on the row and choose Fix match, or open it from the Edit tags panel. Search by title and year (artist for music, author for audiobooks), pick the right result and press Use this match. Nothing is renamed until you apply, and your pick is remembered. See how to fix a wrong match.
How do I clear the matches it remembered?
Open Settings and look in the Tags area. It shows how many Fix match picks are remembered, with a Forget All button.
What does the confidence percentage mean?
It shows how much evidence backs a match: how closely the title matches, whether the year agrees, how many candidates there were, and for music and audiobooks whether the artist or author agrees. Hover over it to see the reason. A pick the app had to guess from many results never shows as high. See what the confidence percentage means.
How do I clean junk tags or fill empty ones?
Right-click rows in the preview and choose Clean tags, Fill tags from filename or Fill tags from lookup. Each one lists every file and what will change before anything is written, and one Undo reverses the whole job. Fill only ever writes blank tags. The clean and fill tags guide has the details.
Where do the cover pictures come from?
Music covers come from the online music database and its cover archive, movie and TV posters from TMDb and TVmaze, and audiobook covers from Google Books. You choose the picture. Media Renamer Pro embeds cover art inside the file's tags and still never renames, moves or deletes poster files. See how to find cover art online.
A tag write was refused. Why?
The writer refuses rather than risk your file, and it always gives a reason and leaves the file untouched. Common reasons are a cover that does not fit, a file with unusual or damaged structure, or a very large file over 400 MB whose tag area is full. When only the cover does not fit, the editor retries without it and says so.
The tags and the file name disagree. What now?
The app lists those files in a review popup and asks which to trust. Choose Keep filename and, with the tag editor and the repair option on, the tags are rewritten to match the name. See when the tags and the file name disagree.
New in 1.4
How do I add more files without starting over?
In version 1.4 and later, use the + button under your file list, or drag more files in. They join the list you already have instead of replacing it. The same file is never added twice, even when it sits inside a folder you already added. The − button only takes a row off the list. It never touches the file on disk.
What are Watched Folders and how do I set them up?
Watched Folders (version 1.4 and later) are the folders you rename most, saved so you can load them in one click. Open Settings, then Watched Folders, click Add Folder, pick the folder and give it a type: Movies, TV Shows, Music or Audiobooks. Then choose that media type and click the eye button under your file list. You still preview and confirm every rename. Watched folders do not run in the background. The rename only new files guide has the full walkthrough.
Why are some files missing after I load a watched folder?
That is New only, which is on by default. It skips files the app already renamed and hides files whose name already matches your naming pattern. Undo makes a file count as new again. If you changed a naming template, turn New only off for one run, or use Forget All in Settings, then Watched Folders, so everything is checked again.
A watched folder says Unavailable.
The drive or NAS share it lives on is not connected. Mount the share in Finder, or plug the drive in, and load again. The app shows Unavailable instead of an empty list so you never mistake a missing drive for nothing new.
Where did the Save button in Settings go?
In version 1.4 Settings save automatically as you change them. There is no Save button any more. Settings now has a sidebar, and each media type page is grouped into Naming templates and Data source.
How do I fit more rows on screen?
Turn on the Experienced layout in Settings, then General, then Layout. It hides the guidance, tightens the spacing and moves Preview, Rename and Undo to a bar at the bottom. Switch back to Guided any time.
Results and safety
Can I undo a rename?
Yes, for the last saved rename session. Press Undo. The undo log is written after a batch finishes, so it is not crash recovery. A force quit, power loss or a dropped network connection during a batch can leave temporary filenames that need fixing by hand. Keep a backup before a large batch.
It renamed my file to something with _1 on the end.
That is collision protection, not a bug. Two files in the batch resolved to the same final name, so the second one was given a suffix instead of overwriting the first. The app never overwrites a file.
It picked the wrong movie or episode.
Online lookups match on the text in the filename, and scene releases are often ambiguous. In 2.0, click the tag icon on the row and choose Fix match to pick the right one, and your pick is remembered. You can also edit the new name in the Preview table before pressing Rename. If a whole batch is matching badly, try a different provider in Settings, or turn on Local-Only Mode to use only what is inside the files.
Does it work on a NAS or SMB share?
Yes. Mount the share in Finder and point the app at it. Preview first, and keep the share mounted until the batch finishes. Network renames are slower and a dropped connection mid-batch is the one case that can leave temporary filenames behind.
Will my subtitles follow the video?
In version 1.3.2 and later, yes, if you turn on Carry subtitle files with renamed media in Settings under Exclusions. A renamed video takes its matching subtitle files with it and keeps language and forced tags, so Plex and Jellyfin still pair them. Artwork and .nfo sidecars are deliberately left alone, because media centres look those up by exact name and renaming them breaks the library.
Privacy, purchases and contact
What happens to my photos and face data?
Renaming happens on your device. Apple Vision is the default photo engine and runs on-device. Face Library profiles are stored on your device and never uploaded. Optional cloud photo descriptions send the photo, never face crops, to the provider whose key you configured. Turn on Local-Only Mode to block all network requests. There is no account, tracking, ads or telemetry. Full details are in the privacy policy linked below.
I want a refund.
Purchases are handled by Apple, so refunds go through Apple rather than through me. Use reportaproblem.apple.com with the Apple Account you bought it with. If something is broken, email me first. I would rather fix it.
How do I report a bug or request a feature?
Email mediarenamerpro@gmail.com with what you expected, what happened, and example filenames. Feature requests are welcome and genuinely do get built. Several shipped features started as one user's email.
How do I contact support?
Email mediarenamerpro@gmail.com. Include your device, your macOS or iOS version, the app version from the App Store, and a few example filenames before and after. Most replies go out within two business days.
Before a large batch
Keep a backup. Preview the whole plan first. Undo history is written after a batch finishes, so it covers a completed rename, not a crash. If you are renaming across a network share, keep the share mounted and the Mac awake until it is done.
Privacy and data
The app has no account, no tracking, no ads and no telemetry. Renaming and photo analysis happen on your device by default. Read the full app privacy policy, or the website privacy notice.
Guides
Longer write-ups on the things that actually go wrong:
- How to rename only the new files in a folder
- How to edit tags and cover art
- How to find cover art online and embed it
- How to fix a wrong match
- How to clean junk tags and fill the blanks
- What the confidence percentage means
- When the tags and the file name disagree
- Five workflows for Media Renamer Pro 2.0
- How to set up your folders and filenames so renaming just works
- How to name TV and movie files so Plex and Jellyfin match them
- Emby file naming: getting your library to match
- Why your subtitles do not show up in Plex or Jellyfin
- How to move a Plex library without losing watch history
- Why batch renaming eats files, and the two-phase fix
- What breaks when you rename files over SMB and NAS shares
- How to rename iPhone photos by the date they were taken
- How to name ROMs without breaking your verification set
Media Renamer Pro is a one-person app. Support emails come to me, not a queue.