From install to your first batch takes about five minutes — four of which go into Safari’s settings. Once that’s done, every rename after it is just: pick files, pick a rule, hit run.
Install & enable
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” — 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 Safari’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 — no retyping when you apply 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.
Only the filename body is touched by default — 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 — a space, -, _. 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 — reorder with search or filters first if you need a different sequence.
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 this replaces rather than deletes, so the length is unchanged.
Custom characters to remove
An extra set of characters, and these are deleted outright — no underscore left behind.
Runs of spaces are collapsed to one, and leading/trailing spaces are trimmed.
Regex replace
Advanced
Match and replace with a regular expression — 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 — no surrounding slashes needed.
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 — 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 — plus 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 execution, not discovered after the damage.
Rename cycles that can complete safely are ordered correctly for you — no manual untangling. Only the genuinely unsolvable cases (three files all wanting the same name) get escalated.
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 — the previous batch is no longer recoverable. So check the result right after each run, and undo on the spot if it’s wrong.
FAQ
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 — 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, Mac only. The mobile versions of these drives either have no usable web interface, or their page structure is a completely different codebase from the desktop one — it wouldn’t be maintainable.
Where are my rule settings stored?
In local browser storage, never uploaded. Clear Safari’s website data or uninstall the extension and they’re gone with it.
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 — it makes the diagnosis much faster.