SCRUB.

SCRUB. guide

Clean up messy filenames, sort media into a Plex-style library, and rename documents and photos by template — all in your browser, files renamed in place, nothing uploaded.

Quick start

• Drop folders or files onto the page (several at once is fine), click Pick files… to multi-select individual files (PDFs, XLS, photos), or click Open folder to scoop up everything inside one folder.
• Review the proposed names — every name is editable, just click and type.
• Tick what you want and hit Rename selected. Cleaned items drop off the list; Undo last batch reverts the whole run.

Modes

• Auto — decides movie vs. TV per item automatically.
• Movie — Title (Year).
• TV — Show S01E02 (add the episode title with Keep episode title).
• Clean — just strips junk, lightest touch, keeps your structure.
• File Renamer — build names from tokens; great for documents, photos, statements (any file type).
• Library — sort items into Movies/Title (Year) and TV/Show, and optionally watch a folder to auto-file.

Folder options

• Clean movie folders — rename the folder itself, not just the files.
• Match files inside — also rename the files within a folder to match.
• Folders only — rename folder names and leave every file inside untouched.
• Deep scan — recurse through all subfolders (seasons, nested folders).
• Auto-number duplicates — append (2), (3) instead of flagging a clash.

Preview tools

• Select all checkbox toggles every row; Only changes hides anything already clean; Clear empties the list.
• A progress bar tracks renames, library filing, and TMDb lookups, with a time estimate on longer runs.

Metadata (TMDb)

• Paste your free TMDb API key once (saved in this browser; Show/Copy to reveal or grab it).
• Look up on TMDb corrects cleaned names to the real title, year, and show name. Matched rows show a tmdb ✓ badge. Runs only when you click.

File Renamer tokens

• {type} {month} {mon} {MM} {monthnum} {year} {date} {orig} — date pulled from filename, EXIF, or file-modified.
• {right #} walks across the original name by however many characters you type. Example: {right 2}.{right 2}. turns 04054040 into 04.05.4040.
• {left #} moves the insertion point to that many characters from the left of the built name. Example: {orig}{left 5} ! turns helloworld into hello !world.
• {n} {nn} {nnn} — running sequence, zero-padded.
• {1} {2} … — capture groups from your Capture from name (regex) field ({0} is the whole match).

Rename rules (wildcards + regex)

• Add an ordered list of Find → Replace rules. Each runs in order on the original filename before the File Renamer template (or Auto/Movie/TV cleaning).
• Default syntax is WILD: * = any chars, ? = one char. Click the WILD badge to flip a rule to REGEX.
• Captures show up as {1} {2} in the replacement. Example: rule Henri* → Henrietta, or 20-(??) → 20{1} to fix "20-26" → "2026".
• Toggle the checkbox to disable a rule without deleting it. Presets save your whole rule list — one preset per batch type (BoFA Checking, Costco receipts, etc.).
• Each rule has a NAME↔ALL scope toggle. NAME (default) leaves the file's extension untouched — a rule like .→(space) changes BofA Checking June.2024.pdf to BofA Checking June 2024.pdf without breaking .pdf.
• Quick add chips above the list one-click common transforms: dots/underscores/dashes → space, or strip dedupe markers like (2).
• Date detection reads month names too (June 2024, March.2021, 2020 Jan) — token {month} and {year} resolve from these even when the source isn't a numeric date.

Output folder (File Renamer mode)

• Pick a Save renamed files to folder in the File Renamer panel. With one set, Rename selected moves (or copies, if you toggle Copy) the renamed files there instead of renaming in place.
• Each row previews the destination as → folder/newname.pdf. Move actions are undo-able.
• The chosen output folder persists across sessions — same one-click reconnect as the library folders.

Library & Watch

• Set Inbox, Movies, and TV folders, then File to library to sort everything into place.
• Watch & auto-file polls the Inbox while the tab stays open and files new arrivals automatically (move mode only).
• Copy (keep originals) copies into the library instead of moving.

Tips & gotchas

• To rename a folder's own name, drop it directly or open its parent (which lists the folder as a row). Renaming a folder you dropped may need write permission per item.
• Settings & folders persist per web address. Open SCRUB from your deployed URL or the installed app so they survive updates and reopens — a downloaded local file uses separate, unreliable storage. Use Reconnect saved folders if the browser drops access between sessions.
• Plex watched history is safe. It's tied to matched metadata, not the filename, so correct names keep your history — just rescan the library afterward.

Privacy & local file safety

SCRUB is designed to work on your device. File names are previewed locally, and files are renamed only after you approve the selected rows.

What stays on your device

• Your files and folder contents are not uploaded to SCRUB.
• Rename settings, presets, TMDb key, and saved folder permissions are stored in this browser on this device.
• The app asks for file or folder access only when you choose files, open a folder, pick an output folder, or reconnect saved folders.

Optional network use

• TMDb lookup runs only when you paste your own TMDb API key and click Look up on TMDb. Movie/show titles you selected may be sent to TMDb to find better metadata.
• The app shell is cached for offline use after it loads. Normal hosting logs may be created by the web host.

Safe-use tips

• Preview names before renaming, especially on large folders.
• Use Copy (keep originals) when testing a new File Renamer template.
• Use Undo last batch immediately after a rename if you want to revert that run.