Clamper

A macOS utility for customizing menu bar icon spacing

---

Screenshot

---

Overview

Clamper lets you customize the spacing between menu bar icons on macOS.

Key Features

• Spacing Control — Adjust the pixel distance between menu bar icons
• Padding Control — Fine-tune selection padding independently or auto-linked to spacing
• Live Preview — See a real-time icon strip preview as you adjust
• Restore Defaults — One click to reset to macOS system defaults

---

Requirements

• macOS 15.0 (Sequoia) or later

---

Installation

Option 1: Install via Homebrew

brew install --cask validatedev/tap/clamper

Option 2: Download Pre-built Release

1. Download the latest .dmg from the Releases page
2. Open the DMG and drag Clamper to your Applications folder
3. Launch the app from Applications or Spotlight

Option 3: Build from Source

1. Clone the repository:

   git clone https://github.com/validatedev/Clamper.git
   cd Clamper

2. Open the project in Xcode:

   open Clamper.xcodeproj

3. Configure Code Signing (first time only):

   # Copy the development config template
   cp Config/Development.shared.xcconfig Config/Development.xcconfig
   
   # Edit the file and replace YOUR_TEAM_ID with your Apple Developer Team ID
   # You can find your Team ID at: https://developer.apple.com/account
   # OR in Xcode: Settings → Accounts → [Your Account] → Team ID
   nano Config/Development.xcconfig

4. Build and run (⌘R) or archive for distribution (Product → Archive)

---

Building & Development

Prerequisites

• Xcode 26.0 or later
• macOS 15.0 or later (for running)
• Apple Developer account (free or paid, for code signing)

Build Commands

# Build for development
xcodebuild -scheme Clamper -configuration Debug build

# Build for release
xcodebuild -scheme Clamper -configuration Release build

# Run tests
xcodebuild -scheme Clamper test

---

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Acknowledgments

• Barbee — For providing the initial pixel values for menu bar spacing
• TighterMenubar — Open-source macOS app by Vanja Ivancevic for adjusting menu bar spacing
• Menu Bar Spacing — Free macOS utility by Sindre Sorhus for adjusting menu bar spacing
• SF Symbols — Apple's iconography system
• Sparkle — Open-source software update framework
• SwiftAgents — Base AGENTS.md file for best practices

---

Made with 🦆