Ziran
epulla · Switch, search, pin, and arrange Mac windows with keyboard shortcuts.
SHA-256 recorded by Homebrew · Not disabled by Homebrew · Checked
- 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
| macOS | Version | Chips | Download | Source |
|---|---|---|---|---|
| macOS 14 or later | 0.1.12 | Intel | github.com/epulla/ziran/releases/download/v0.1.12/Ziran-0.1.12.zipSHA-256 5fea7186f3c02c52c4d5356e6e1cd0618d0ceb620cf97fbc3a2e6b223af58fd4 | HomebrewChecked |
| macOS 14 or later | 0.1.12 | Apple silicon | github.com/epulla/ziran/releases/download/v0.1.12/Ziran-0.1.12.zipSHA-256 5fea7186f3c02c52c4d5356e6e1cd0618d0ceb620cf97fbc3a2e6b223af58fd4 | HomebrewChecked |
How to install Ziran on Mac
- In Terminal, run:
brew install --cask epulla/tap/ziran - 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
brew uninstall --cask ziranA regular uninstall removes the app and keeps its settings and caches.
Deep clean (optional)
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
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
appSource file: Ziran.
app Declared destination: /
Applications/ Ziran. app View full declaration
{ "app": [ "Ziran.
app" ], "target": "/Applications/ }Ziran. app" Remove user data
zapView 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 ~/.
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 ~/. 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.
- Homebrew definition: github.com/epulla/homebrew-tap/blob/HEAD/Casks/ziran.rb · Checked
- Security facts: github.com/epulla/ziran · Checked