Zush Documentation
Zush is an AI file renamer for Mac and Windows. It renames files by content, helps you review a batch before applying changes, monitors folders for new files, and keeps rename history so you can undo a batch.
Get startedRun your first safe rename batch from Finder or File Explorer.
Batch rename filesRename mixed folders with AI suggestions, inline edits, and undo history.
Folder monitoringAutomatically rename new supported files in Downloads, Screenshots, iCloud, OneDrive, and project folders.
TemplatesSave repeatable rename setups for recurring batches and monitored folders.
Naming BlocksBuild consistent filenames from dates, projects, document fields, media context, and AI fields.
Custom AI BlocksDescribe any value AI should extract from a file and reuse it as your own naming block.
Custom promptsGuide filename style, tags, and metadata with workflow-specific AI instructions.
AI modesChoose managed Cloud AI, BYOK with your provider key, or Offline AI with Ollama.
BYOKConnect your own Gemini, Groq, OpenAI, or Claude API key for cloud renaming.
Offline AIUse Ollama for supported local file analysis without cloud AI processing.
Supported file typesCheck the image, PDF, document, design, video, audio, and text formats Zush can analyze.
Privacy and securityUnderstand what Zush processes, where data goes, and how keys are stored.
What Zush can do
Section titled “What Zush can do”- Batch rename files with AI-generated names based on file content.
- Monitor folders and rename new supported files as they arrive.
- Save repeatable workflows with Templates.
- Build consistent filenames from 145+ Naming Blocks.
- Create Custom AI Blocks for workflow-specific details that built-in blocks do not cover.
- Add custom rename and tagging prompts.
- Generate searchable filenames, tags, and metadata.
- Process images, screenshots, RAW photos, PDFs, Office and iWork documents, design files, subtitles, video, and audio.
- Use managed Cloud AI, BYOK, or Offline AI through Ollama.
- Review every result before applying changes and revert from rename history.
Choose a workflow
Section titled “Choose a workflow”| If you want to… | Start here |
|---|---|
| Clean a messy folder once | Batch rename files |
| Keep Downloads or Screenshots clean | Folder monitoring |
| Keep names consistent across folders | Templates and Naming Blocks |
| Extract a workflow-specific detail | Custom AI Blocks |
| Use your own AI provider key | BYOK |
| Keep supported analysis local | Offline AI |
| Understand what data is processed | Privacy and security |