macOS HyprSpace – Enhanced AeroSpace Fork

HYPRLAND

NIRI

AeroSpace is an i3-like tiling window manager for macOS

This fork adds three exclusive features: Centered Workspace Bar + Dwindle Layout + Niri Layout

Download Latest Release • Original AeroSpace • Report Issues

This fork enhances the original AeroSpace with three powerful features not available upstream:

A macOS integrated menu bar that displays workspace indicators and full GUI window icons centered at the top of your screen.

Features:

• 📍 Centered workspace indicators (not in system tray)
• 🪟 Window icons for each workspace
• 🖱️ Interactive: Click to focus workspace or window
• 🎨 Multi-monitor support with configurable target display
• 🔧 Highly customizable via menu:
  • Window level (Status/Popup/Screensaver)
  • Target display (Focused workspace/Primary/Mouse cursor)
  • Notch-aware positioning for MacBook Pro
  • Deduplicate app icons with badge count
  • Toggle workspace numbers

A binary tree-based tiling layout inspired by Hyprland's dwindle algorithm.

Features:

• 📐 Automatic split direction based on available space
  • Wider areas split vertically (left/right)
  • Taller areas split horizontally (top/bottom)
• ⚖️ Weight-aware splitting for precise window sizing
• 🔄 Alternating orientation creates characteristic dwindle pattern
• 🛠️ Full support for resize, balance-sizes, and horizontal/vertical commands
• 🎯 Perfect for dynamic, organic workspace layouts

Inspired by: Hyprland

A carousel-style layout where the focused window is centered with neighboring windows peeking at the edges.

Features:

• 🎯 Focused window centered at 80% screen width
• 👀 Peek effect: 10% margins show neighboring windows on left/right
• 📏 Custom widths: Resize any window, custom sizes preserved
• ➡️ Horizontal-first: Optimized for wide monitors
• 🔄 Smooth focus-based carousel navigation
• 🎨 Works great with minimal gaps for clean aesthetics

Config usage: Use layout scroll in your .toml file

Perfect for: Single-row workflows, presentation mode, MacBook displays

Inspired by: Niri Compositor

Choose your preferred installation method from the latest release:

1. Download HyprSpace-v*.dmg
2. Open the .dmg file
3. Drag HyprSpace.app to the Applications folder
4. First Launch Only - Bypass Gatekeeper:
   • Right-click HyprSpace.app → Select "Open"
   • Click "Open" in the security dialog
   • Alternative: Run in Terminal:
     xattr -cr /Applications/HyprSpace.app
5. Grant Accessibility Permissions when prompted

1. Download HyprSpace-v*.zip
2. Extract the archive
3. Move HyprSpace.app to your Applications folder
4. Optional - Install CLI:
   # Copy CLI binary to a directory in your PATH cp HyprSpace-v*/bin/hyprspace /usr/local/bin/ # Copy man pages (optional) cp HyprSpace-v*/manpage/*.1 /usr/local/share/man/man1/ # Copy shell completion (optional - choose your shell) cp HyprSpace-v*/shell-completion/bash/_hyprspace /usr/local/etc/bash_completion.d/ # OR for zsh: cp HyprSpace-v*/shell-completion/zsh/_hyprspace /usr/local/share/zsh/site-functions/ # OR for fish: cp HyprSpace-v*/shell-completion/fish/hyprspace.fish ~/.config/fish/completions/
5. Bypass Gatekeeper (same as Option 1, step 4)
6. Grant Accessibility Permissions when prompted

1. Click the HyprSpace menu bar icon
2. Navigate to "Experimental UI Settings"
3. Click "Enable centered workspace bar"
4. Customize settings in the same menu

Add to your ~/.hyprspace.toml:

All settings accessible via Menu Bar Icon → Experimental UI Settings:

• ✅ Enable centered workspace bar
• 🔢 Show workspace numbers
• 📊 Window Level:
  • Status Bar
  • Popup (above menu bar) ← Recommended
  • Screen Saver (highest)
• 🖥️ Target Display:
  • Focused Workspace Monitor ← Recommended
  • Primary Display
  • Display Under Mouse
• 💻 Notch-aware positioning (MacBook Pro)
• 🎯 Deduplicate app icons with badge count

Dwindle Layout Progression:

Niri Layout Visual:

All original AeroSpace features are preserved:

• ✅ Tiling window manager based on tree paradigm
• ✅ i3 inspired
• ✅ Fast workspaces switching without animations
• ✅ No SIP (System Integrity Protection) disabling required
• ✅ Virtual workspaces emulation
• ✅ Plain text configuration (dotfiles friendly)
• ✅ CLI first (manpages and shell completion included)
• ✅ Proper multi-monitor support

• 📖 Original AeroSpace Guide
• 📜 AeroSpace Commands
• 🎁 AeroSpace Goodies
• 🔧 Default Config

• YouTube 91 sec Demo (original AeroSpace)
• YouTube Guide by Josean Martinez

Requirements:

• macOS 13.0+ (Ventura)
• Xcode 16+ (from App Store)
• Swift 6.1+

See dev-docs/development.md for more details.

• Author: Nikita Bobko
• Repository: nikitabobko/AeroSpace
• License: MIT

• Centered Bar: Inspired by Barik
• Dwindle Layout: Inspired by Hyprland
• Author: [BarutSRB]

MIT License - Same as original AeroSpace

See LICENSE for full text.

• Centered bar code is isolated with // CENTERED BAR FEATURE comments
• Dwindle layout integrates cleanly with existing layout system
• Minimal touchpoints with core AeroSpace code (~25 LOC modified)
• Easy to merge upstream changes

• Fork-specific features (centered bar, dwindle): Open an issue here
• Core AeroSpace bugs: Report to upstream repository

• 💬 Discussions
• 🐛 Issue Tracker
• 📧 Contact Discord: [Barut1]
• ⭐ Star this repo if you find it useful!

From original AeroSpace:

Now you can move windows by holding ctrl+cmd and dragging any part of the window!

Source: reddit

• AeroSpace (Original) - The original tiling WM
• Hyprland - Inspiration for dwindle layout
• Amethyst - Another macOS tiling WM
• Yabai - Advanced tiling WM
• Rift - New emerging Rust based tiling WM