From install to your first batch takes about five minutes, most of it spent in Safari’s settings. After that, every rename is just picking files, picking a rule and running it.
Install & enable (Safari)
These are the steps for the Safari version. The Chrome version is on the Chrome Web Store and works in Chrome, Edge and other Chromium browsers (Windows, macOS and Linux, Chrome 110+). Click “Add to Chrome” there and skip the TestFlight steps below. Both versions have the same interface and features, so everything after installation applies to either.
1
Install TestFlight on your Mac
Search for TestFlight in the Mac App Store and install it. Requires macOS 12 Monterey or later · Safari 15+。
2
Open the public beta link and install BatchName
Open the beta link on your Mac. TestFlight takes over and shows BatchName. Click Install.
Launch BatchName and enable the extension in Safari
Open BatchName once after installing. It tells you whether the extension is currently on or off, and gives you a button that jumps straight to Extensions in Safari settings.
Tick BatchName in the list on the left, then set each drive’s permission to Allow on the right. Skip this and the extension will be installed but inert.
Extensions
BatchName0.1.0
Other extension
BatchName
Batch-rename cloud drive files
Allow this extension to read content on these websites:
drive.uc.cnAllow
pan.quark.cnAllow
Safari → Settings → Extensions. Tick to enable on the left, grant site access on the right.
4
Open any supported drive
Sign in and go to “All files”, and the extension recognises the site automatically. Nine drives are supported:
Quark Drivepan.quark.cn
Alibaba Cloud Drivealipan.com
Baidu Netdiskpan.baidu.com
Xunlei Drivepan.xunlei.com
115 Drive115.com
UC Drivedrive.uc.cn
123 Pan123pan.com
China Mobile Cloudyun.139.com
Tianyi Cloudcloud.189.cn
Opening the panel
Two ways in. Either works.
The floating button (the usual way)
Once you’re on a file list, a “Batch rename” pill appears in the bottom-right corner of the page. Click it to open the panel.
Hold and drag it anywhere; the position is remembered
Each drive remembers its own position, independently
Right-click the button to reset its position
Batch rename
The toolbar icon
Click the pencil icon in your browser’s toolbar to open the settings popup. From there you can:
Check whether the current site is recognised (the green-dot pill at the top)
Toggle the floating button
Switch interface language and light / dark appearance
BatchName
UC Drive
Show floating button
Open a file list on a supported drive and the floating button appears in the bottom-right corner. Drag it anywhere.
Renamed12·Failed0
The basic flow
Configure the rule on the left, watch the result on the right. Change one character on the left and the right updates instantly. Keep going until the right side reads the way you want, then run it.
The panel opens with every file in the current folder. Filter by keyword with the search box, or narrow to files / folders only with the type filter, then tick what you want. “Select all” applies to the current filtered result, not to the whole folder.
2
Choose a rule and fill in the parameters
Pick a rule from the dropdown at the top left; its parameters appear below. Your parameters are remembered, so the next folder starts where you left off and you don’t retype anything when applying the same rule across several folders.
3
Check the preview
Each row on the right reads old name → new name, with the changed part highlighted. The status bar at the bottom tells you how many conflict, how many are unchanged, and how many are ready. If something looks wrong, go back to the left and adjust.
4
Run it
Click Rename. The number on the button is how many files this run will touch. You can pause or cancel mid-run; anything already renamed stays renamed. Failures are listed separately so you can retry just those.
The six rules
The first four are the everyday ones; the last two sit under “Advanced” in the dropdown.
Replace text
Common
Swap one piece of text for another. Optionally match case, and replace either the first occurrence or all of them.
Before[电影天堂]星际穿越.2014.mkv
After星际穿越.2014.mkv
Find [电影天堂] → replace with nothing
Find
The text to be replaced.
Replace with
What it becomes. Leave empty to simply delete it.
Match case
When on, ABC and abc are treated as different.
Replace all matches
When off, only the first occurrence in each filename is replaced.
By default only the filename body is changed; the extension is left alone.
Add text
Common
Insert fixed text at the start or end of the filename, with a separator of your choosing.
Before第01集.mp4
After流浪地球 - 第01集.mp4
Prepend "流浪地球", separator " - "
Position
Insert at the start or at the end.
Text
What to insert.
Separator
What sits between the inserted text and the original name, such as a space, - or _. Leave empty for no gap.
Appending puts the text before the extension, so you never end up with .mp4suffix.
Add numbering
Common
Number files sequentially in list order. Set the starting value, zero padding, and whether the number goes first or last.
Before风景照.jpg
After001 风景照.jpg
Start at 1, pad to 3 digits, prefix, space separator
Start at
The first number.
Digits
Zero-pad to this width. 3 gives 001, 002.
Position
Number goes first or last.
Separator
What sits between the number and the original name.
Numbering follows the order in the preview list. If you need a different sequence, reorder with search or filters first.
Clean up filename
Common
Replace characters the file system rejects with underscores. You can also list extra characters to delete outright.
Before会议纪要<最终版>?.docx
After会议纪要_最终版__.docx
Remove illegal characters (replaced with _)
Remove illegal characters
Characters the file system rejects (\ / : * ? " < > |) become underscores _. Note that this replaces rather than deletes, so the length is unchanged.
Custom characters to remove
An extra set of characters, and these are deleted outright, leaving no underscore behind.
Runs of spaces are collapsed to one, and leading/trailing spaces are trimmed.
Regex replace
Advanced
Match and replace with a regular expression. Supports capture groups, custom flags, and an option to include the extension. Invalid patterns are flagged as you type, so a broken rule never reaches execution.
BeforeS01E05.1080p.WEB-DL.mkv
AfterS01E05.mkv
Pattern \.\d+p.*$ → replace with nothing
Pattern
The regular expression, without surrounding slashes.
Replace with
Supports capture group references like $1 and $2.
Match case / Replace all
These map to the i and g flags.
Extra flags
Put m, s, u here when you need them.
Include extension
When on, .mp4 takes part in the match too, which is useful for changing extensions.
An invalid pattern is flagged in red as you type, so a broken rule never reaches execution. When in doubt, read the preview.
Extract episode
Advanced
Find the episode number buried in a messy filename and rebuild it as a clean show + season/episode name. Set the season, an episode offset and zero padding, and add anchor words when the number is ambiguous.
Before[SubGroup] Show - 05 [1080p][x265].mkv
After毕业季 S01E005.mkv
Show "毕业季", season 1, pad to 3 digits
Show name / prefix
The show name in the output filename.
Season
Defaults to 1, zero-padded to two digits on output (S01).
Episode offset
Added to the detected episode number. Use a negative value when season two is numbered from 13 and you want it back to 1.
Zero padding
How many digits the episode number is padded to. Default 3.
Output template
Defaults to {prefix} S{season}E{episode}{ext}; the four variables can be arranged freely.
Anchor before / after
When the number is ambiguous, tell it which words sit immediately before and after the episode number.
The target format depends on your scraper, but the mainstream ones follow the same convention: Show Name - SxxExx. For the full naming spec see the Kodi Wiki article on TV show naming, a community-maintained technical document; Emby, Jellyfin and Plex broadly match its detection logic.
Conflicts & undo
What counts as a conflict
Two files resolving to the same new name, or A wanting B’s name while B wants A’s: run either of those straight through and you lose files. BatchName finds them before execution and asks you what to do.
2 conflicts found
These files would overwrite each other. Resolve them first.
Name clash
纪录片 01.mp4自然 S01E001.mp4
Name clash
纪录片 1.mp4自然 S01E001.mp4
Skip conflictsEdit the rule
Conflicts are stopped before anything runs.
Rename cycles that can complete safely are put in the right order for you, so there is no manual untangling. Only the genuinely unsolvable cases, such as three files all wanting the same name, are escalated to you.
Undo the last batch
Once a run finishes, the undo button in the bottom-left of the panel lights up. One click restores that entire batch to its original names.
Only the most recent batch is kept. Run another rename and the undoable batch becomes that new one, and the previous batch can no longer be restored. So check the result right after each run, and undo on the spot if it’s wrong.
FAQ
Is there a Chrome version?
Yes, it is on the Chrome Web Store. It works in Chrome, Edge and other Chromium browsers, with the same interface and features as the Safari version.
The floating button hasn’t appeared
It only shows on file list pages, not on a drive’s home page, not on the Videos / Images / Documents category views, not in the recycle bin or share lists. Those views have no concept of a “current folder”, so renaming there would behave unpredictably; better to show no button at all. Go back to “All files”. Also check that “Show floating button” is switched on in the extension popup.
It says the extension resources can’t load, or the panel won’t open
Safari hasn’t been granted access to the site. Click the BatchName pencil icon to the left of the address bar and set the current website to “Allow” or “Always allow on this website”, then reload the page.
The run failed halfway through
Failed items are flagged individually and you can retry just those, and successful ones are not touched again. The usual causes are an expired drive session (sign in again and retry) or rate limiting from the drive itself (wait a bit).
How many undos do I get?
One, the most recent batch. After a run, undo restores that batch to its original names. Run another rename and the undoable batch becomes the new one.
Is there an iPhone or iPad version?
No, and phone browsers aren’t supported either. For now it covers desktops only: the Safari version on a Mac, the Chrome version on Windows, macOS and Linux. The mobile versions of these drives either have no usable web interface or are built differently from the desktop ones, which would be too much to maintain.
Where are my rule settings stored?
In local browser storage, never uploaded. Safari version: clear Safari’s website data or uninstall BatchName and the settings go with it. Chrome version: remove the extension on the extensions management page and its local data is cleared.
Can it rename folders?
Yes. The panel toolbar has an “Include folders” toggle. Switch it on and folders join the list for renaming.
Still stuck?
Send feedback straight from TestFlight, or email us. Tell us which drive, which rule, and what the filenames look like, and we can pin it down much faster.