Skip to content

Ziran

epulla · Switch, search, pin, and arrange Mac windows with keyboard shortcuts.

CaskUtilitiesMenu BarApple silicon · Intel
Official download · github.com

SHA-256 recorded by Homebrew · Not disabled by Homebrew · Checked

Homepage
From epulla/tap
30-day installs
0
#2549 in App
1-year installs
0
Last 365 days
Latest version
0.1.12
Download size
—
arm64 / x86_64 · zip
Release cadence
Daily
4 releases in 30 days

Ziran is a Utilities app for Mac. It is made by epulla.

Quick facts

Chips
Apple silicon · Intel
macOS
macOS 14 or later
Developer
epulla
Install
brew install --cask epulla/tap/ziran
Homebrew
Available; updated by Homebrew
Also known as
ziran

These facts were checked on or after . See each source

About

Ziran is a keyboard-first macOS window switcher that runs in the menu bar.

  • Switch between apps and windows, search all windows, and pin or reorder windows.
  • Save quick-navigation bookmarks for apps, folders, files, and web pages.
  • Save window-layout templates and apply them with keyboard shortcuts.
  • Resize, center, maximize, restore, or move windows between displays.

Ziran uses the MIT license and requires macOS 14 or later and Accessibility permission. The app is ad-hoc signed, not notarized; first launch may require Open Anyway in Privacy & Security. After an upgrade, you may need to remove and re-add its Accessibility permission.

System requirements

macOSVersionChipsDownloadSource
macOS 14 or later0.1.12Intelgithub.com/epulla/ziran/releases/download/v0.1.12/Ziran-0.1.12.zipSHA-256 5fea7186f3c02c52c4d5356e6e1cd0618d0ceb620cf97fbc3a2e6b223af58fd4HomebrewChecked
macOS 14 or later0.1.12Apple silicongithub.com/epulla/ziran/releases/download/v0.1.12/Ziran-0.1.12.zipSHA-256 5fea7186f3c02c52c4d5356e6e1cd0618d0ceb620cf97fbc3a2e6b223af58fd4HomebrewChecked

How to install Ziran on Mac

  1. In Terminal, run: brew install --cask epulla/tap/ziran
  2. Homebrew installs the app in your Applications folder.

Install without Homebrew

Download the same file Homebrew uses: github.com/epulla/ziran/releases/download/v0.1.12/Ziran-0.1.12.zip

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

Uninstall Ziran and optional data cleanup

Uninstall command
brew uninstall --cask ziran

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

Deep clean (optional)

Uninstall command
brew uninstall --zap --cask ziran

--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.

Files Ziran can leave on your Mac (1)
Files and folders
~/Library/Preferences/com.epulla.ziran.plist

These entries come from the Homebrew definition, checked . They say what it declares, not what is on your Mac.

What’s new in 0.1.12

New OpenNavo editorial

Ziran refreshes its visual identity.

Ziran security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

Distribution
Homebrew
Open source
Yes · github.com/epulla/ziran · MITChecked
Scan with OpenNavoOpens a scan preview in the OpenNavo app; you decide whether to start it. ClamAV on Mac

Install Details

Tap
epulla/tap
Download URL
https://github.com/epulla/ziran/releases/download/v0.1.12/Ziran-0.1.12.zip
SHA-256
5fea7186f3c02c52c4d5356e6e1cd0618d0ceb620cf97fbc3a2e6b223af58fd4
Homebrew definition
github.com/epulla/homebrew-tap/blob/HEAD/Casks/ziran.rb
Source code
github.com/epulla/ziran

Installation and removal contents

  • Install app

    Source file: Ziran.app

    Declared destination: /Applications/Ziran.app

    View full declaration
    {
      "app": [
        "Ziran.app"
      ],
      "target": "/Applications/Ziran.app"
    }
  • Remove user data zap

    View full declaration
    {
      "zap": [
        {
          "trash": "~/Library/Preferences/com.epulla.ziran.plist"
        }
      ]
    }

Questions about Ziran

Is Ziran open source?

Ziran’s source code is public on GitHub (epulla/ziran) under the MIT license.

How do I completely uninstall Ziran on a Mac?

Run brew uninstall --cask ziran. To delete its settings and caches as well, run brew uninstall --zap --cask ziran. --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. That also deletes ~/Library/Preferences/com.epulla.ziran.plist.

Does Ziran run on Apple silicon (M1 and later) Macs?

Homebrew installs it on both Apple silicon and Intel Macs, from the same download. It needs macOS 14 or later.

Where does Ziran store its settings and data?

Its settings are in ~/Library/Preferences/com.epulla.ziran.plist. These locations come from Homebrew’s clean-up list.

What is the latest version of Ziran?

The latest version is 0.1.12, added to Homebrew on Oct 28, 2026. Run brew upgrade --cask ziran to update it.

Sources

Every fact on this page names its source and check date. Facts past their validity read “as of” their date and are no longer stated as current.