# Zush

A macOS app that uses AI and custom naming rules to rename files, with previews and batch undo.

> This is the Markdown version of the Zush page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/zush>

- **Latest version**: `3.25.0`
- **Developer**: Kirill Isachenko (lirik)
- **Homepage**: <https://zushapp.com/>
- **Categories**: [Files and Storage](https://opennavo.com/categories/files-storage)
- **Install**: `brew install --cask zush`
- **30-day installs**: 32
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://zushapp.com/releases/Zush-3.25.0.dmg>
- **SHA-256**: `0bb430d539a546ec6639112fc0dcc32242a7844f61b6eecfb2a5cc4f19692564`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "com.lirik.Zush"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Zush.app"
      ],
      "target": "/Applications/Zush.app"
    },
    "phase": "install",
    "sources": [
      "Zush.app"
    ],
    "target": "/Applications/Zush.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Scripts/75V6XX25FG.com.lirik.Zush",
            "~/Library/Application Scripts/com.lirik.Zush",
            "~/Library/Application Scripts/com.lirik.Zush.FinderMenu",
            "~/Library/Application Support/com.lirik.Zush",
            "~/Library/Application Support/Zush",
            "~/Library/Caches/com.lirik.Zush",
            "~/Library/Caches/Zush",
            "~/Library/Containers/com.lirik.Zush",
            "~/Library/Containers/com.lirik.Zush.FinderMenu",
            "~/Library/Group Containers/75V6XX25FG.com.lirik.Zush",
            "~/Library/HTTPStorages/com.lirik.Zush",
            "~/Library/Preferences/ByHost/com.lirik.Zush.*.plist",
            "~/Library/Preferences/com.lirik.Zush.plist",
            "~/Library/Saved Application State/com.lirik.Zush.savedState",
            "~/Library/WebKit/com.lirik.Zush"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Zush is a macOS file-renaming and organization app. It analyzes file content and metadata to suggest names based on rules you define, so files in a batch can receive different names. You can review proposed filenames before applying changes and use rename history to restore original names.

Key characteristics:
- Rename files in batches, using reusable templates and naming blocks to structure filenames.
- Monitor folders to process new files automatically using a template.
- Choose an AI analysis approach: Zush Cloud, your own provider key (BYOK), LM Studio, or Ollama. The official site describes local analysis through LM Studio or Ollama for supported files; those modes work offline after setup.
- Use AI-assisted folder sorting, described by the developer as a beta feature, with automatic grouping or custom instructions.

To install the macOS app, run `brew install --cask zush`. The cask requires macOS 15 or later and installs `Zush.app` in `/Applications`. The supplied Homebrew package is the Mac application; the Windows download mentioned on the product website is a separate offering and is not installed by this cask. The product site describes 50 free AI renames across its modes, with paid plans also available; those limits and plans are product offerings rather than Homebrew installation options.

Sources: [Zush](https://zushapp.com/) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/z/zush.rb)

## System requirements

- macOS 15 or later · Version: 3.25.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · Checked 2026-11-22
  - <https://zushapp.com/releases/Zush-3.25.0.dmg>
  - SHA-256: `0bb430d539a546ec6639112fc0dcc32242a7844f61b6eecfb2a5cc4f19692564`
- macOS 15 or later · Version: 3.25.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · Checked 2026-11-22
  - <https://zushapp.com/releases/Zush-3.25.0.dmg>
  - SHA-256: `0bb430d539a546ec6639112fc0dcc32242a7844f61b6eecfb2a5cc4f19692564`

## Uninstall

- `brew uninstall --cask zush`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask zush`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Scripts/75V6XX25FG.com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Scripts/com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Scripts/com.lirik.Zush.FinderMenu` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Containers/com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Containers/com.lirik.Zush.FinderMenu` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Group Containers/75V6XX25FG.com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/ByHost/com.lirik.Zush.*.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.lirik.Zush.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/com.lirik.Zush.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/WebKit/com.lirik.Zush` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 3.25.0 (2026-11-22)

Zush 3.25.0, released 22 November 2026, lets Mac users rename financial statements from the file itself and fixes iCloud waits and calendar days. Official notes: https://github.com/design-ninja/zush-releases/releases/tag/v3.25.0

**New**

- Financial Statements template names files by date, bank and account.

**Improved**

- Sketch files are named from what the design shows.
- Movie and TV names still resolve when the catalog is busy.
- Three older templates are no longer added for new installs.

**Fixed**

- No brief freeze while iCloud files are still downloading.
- Statistics use the right days on non-Gregorian calendars.

## Facts and sources

- <https://opennavo.com/apps/zush>
- <https://opennavo.com/apps/zush/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/z/zush.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/zush>
