Zephyr

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #llm #android #rust #deep-learning #docker #macos #kubernetes #pytorch #openai #open-source

(★ 18)

Zephyr tweak for macOS Dock

Zephyr Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Zephyr

A tweak for Dock on macOS 15.0+ for use with [ammonia](https://github.com/CoreBedtime/ammonia)

## Features

Background
* Override background style
  * System
  * Dark
  * Light
* Hide all background layers
* Hide border layer (macOS 15.x)
* Color border layer (macOS 15.x)
* Use custom blur layer
  * Blur radius
  * Saturation
  * Brightness
  * Opacity
  * Window passthrough amount
  * Corner radius

Badges
* Custom badge color
* Use icon average color
* Add trash contents count badge
* Add contents count to Dock folders
* Use a custom badge image

Separators (Main & Recents)
* Hide separator
* Custom separator color
* Custom width & height

Indicators
* Custom indicator color
* Use icon average color
* Custom width & height

Launchpad (macOS 15.x)
* Hide open folder background

Extra
* Add spacer tiles (small & large
* Highlight hovered item in stack grids
* Only display running apps
* Lock Dock contents

<details>
  <summary>Screenshots</summary>
  <img width="1352" height="878" alt="background" src="https://github.com/user-attachments/assets/d2051bf8-bde4-4a8f-9d24-bc5f795161f9" />
  <img width="1352" height="878" alt="layer" src="https://github.com/user-attachments/assets/dab62b60-5244-4e54-9641-0ead131653e3" />
  <img width="1352" height="878" alt="badges" src="https://github.com/user-attachments/assets/dee564f5-8f66-4ae7-bc8f-2d3a2e76443b" />
  <img width="1352" height="878" alt="separators" src="https://github.com/user-attachments/assets/d18826e4-f17d-48e5-9a11-31691f597e64" />
  <img width="1352" height="878" alt="indicators" src="https://github.com/user-attachments/assets/266c7036-1b94-4b0d-bbda-2a90b81dc70f" />
  <img width="1352" height="878" alt="launchpad" src="https://github.com/user-attachments/assets/80fdbb44-a1a1-4c4d-8c31-d7a21e6c6fb6" />
  <img width="1352" height="878" alt="launchpadfolder" src="https://github.com/user-attachments/assets/c1beab8f-f852-4598-8eeb-c6b8d3458e56" />
  <img width="1352" height="878" alt="extra" src="https://github.com/user-attachments/assets/ea5e5426-6639-4ec6-8272-aba4610f1cc1" />
  <img width="1352" height="878" alt="settings" src="https://github.com/user-attachments/assets/8b692010-0a32-4a9c-86f2-0d22ca0c14a4" />

</details>

## Installation

Download the [latest release](https://github.com/MTACS/Zephyr/releases) and unzip. Copy `Zephyr.app` to `/Applications` and `libZephyr.dylib`, `libZephyr.dylib.whitelist`, and `libZephyr.dylib.blacklist` to `/private/var/ammonia/core/tweaks`. Open the Zephyr and click the apply button in the top right corner to restart Dock

## Building

To build the dylib run `make install`. To build the application run `xcodebuild -project Zephyr.xcodeproj -target "ZephyrApplication" -configuration Release CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO`. Output files are located in `/build`

Special thanks to [bedtime](https://github.com/CoreBedtime) for ammonia, [Alex Zielenski](https://github.com/alexzielenski) for [ZKSwizzle](https://github.com/alexzielenski/ZKSwizzle), [Alex Spaulding's](https://github.com/aspauldingcode) [apple-sharpener](https://github.com/aspauldingcode/apple-sharpener) which inspired code to allow some settings to apply instantly, and [Jeremy Legendre](https://github.com/jslegendre) for [JLMaterialLayer](https://github.com/jslegendre/JLMaterialLayer)

Zephyr

Zephyr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Zephyr

Zephyr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README