Zush Documentation

Zush names files from their content and can sort them into folders. Start with a small batch you can review, then save your settings for the next batch or automate a folder.

Start here

Your first renameInstall Zush, add a few files, review their new names, and apply the changes.

Rename a batchWork through a folder of files with editable names and a preview before applying.

Automate a folderHave Monitor rename new arrivals automatically after you test the setup.

Sort files into foldersChoose a destination and group files with AI, with or without changing their names.

Need the app first? See Install and update. For the free allowance and PRO, see Pricing and limits.

Rename and organize files

• Batch rename — review and edit suggested filenames before applying changes.
• Quick Rename — rename selected files with a shortcut or the Mac Finder action.
• Folder monitoring — automatically process new files in a watched folder.
• Folder sorting — move files into suggested folders, use nested rules, or keep current names.
• Undo history — restore names and locations, and handle files that cannot be restored immediately.
• Find files later — make filenames useful in Finder, File Explorer, and system search.

Set up your filenames

Start with Smart Rename, the default naming setup. Save a separate Template when a workflow needs different names or sorting rules.

• Templates — save a setup and use it in a batch or monitored folder.
• Naming Blocks — combine titles, dates, sequence numbers, and file details.
• Custom AI Blocks — create a field for a detail you want AI to extract.
• Custom prompts — guide the wording of names and tags.
• Metadata and tags — add extra context, with different storage options on Mac and Windows.
• Import and export Templates — back up a setup or share it with another computer.

Choose where AI runs

Zush Cloud AI is the starting point if you do not want to configure a provider. Choose a local mode when supported analysis content needs to stay on your computer. The AI mode is shared across workflows; it is not saved per Template or monitored folder.

• Compare AI modes — choose managed cloud, your own API key, or a local server.
• Zush Cloud AI — start without an API key or local model.
• Your own API key (BYOK) — connect Gemini, OpenRouter, OpenAI, or Anthropic.
• Local AI overview — understand local setup and limitations.
• Ollama setup — download and start Ollama, then set up a local model using Zush’s buttons.
• LM Studio setup — connect a vision-capable LM Studio model.
• Privacy and security — understand what is processed and where it goes.

Follow a workflow example

Use a guide to build or adapt a Template for your files:

• Invoices
• Receipts and expenses
• Medical records
• Legal documents
• Movies and TV shows

Check formats and processing details

• Supported file types — check formats and Mac/Windows differences.
• Audio and video analysis — understand speech excerpts, subtitles, music recognition, and local-mode limits.

See Zush in action

Rename a mixed batch, then use an invoice Template to build names and sort files by vendor.

Product information: Zush for Mac, Zush for Windows, pricing, and support.