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 modesCompare Zush Cloud AI, BYOK, LM Studio, and Ollama.
Zush Cloud AIStart renaming with managed cloud analysis and no API key or local model setup.
Local AI overviewCompare private local analysis through LM Studio and Ollama on Mac or Windows.
LM StudioConnect a vision-capable LM Studio model and local server to Zush.
BYOKConnect your own Gemini, OpenRouter, OpenAI, or Claude API key for cloud renaming.
OllamaUse an installed Ollama model for supported local file analysis.
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.
- Choose Zush Cloud AI, BYOK, LM Studio, or 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 |
| Start without configuring a provider | Zush Cloud AI |
| Compare local model connections | Local AI overview |
| Use models managed in LM Studio | LM Studio |
| Use your own AI provider key | BYOK |
| Use models managed in Ollama | Ollama |
| Understand what data is processed | Privacy and security |
Product pages
Section titled “Product pages”AI folder sorting and Template sharing
Section titled “AI folder sorting and Template sharing”AI folder sorting and destination folders organize renamed files into subfolders. Template import and export lets you share or back up naming workflows.