MacOS

Lightweight macOS desktop environment: SketchyBar topbar and AeroSpace window manager, configured for productivity and visual clarity.

---

Preview

---

Contents

• About
• Colors
• Preview
• Structure
• Quick Install
• Remote Install
• Manual Install
• Uninstall
• Usage
• Keybindings
• Customization
• Contributing
• License
• Related repos
• X

About

Two tools, one setup:

• SketchyBar — A customizable macOS topbar with workspace indicators, system stats, clock, volume, battery, and app launcher icons.
• AeroSpace — A tiling window manager with virtual desktops (workspaces), keyboard-driven navigation, and automatic window placement rules.

Colors

Structure

• sketchybar/ — SketchyBar config: bar styles, items, plugins, colors, icons, and themes.
• aerospace/ — AeroSpace config: workspace bindings, gaps, window rules, and keybindings.
• install.sh — Automated install script for dependencies and dotfiles.
• uninstall.sh — Removes configs, services, and packages.

Quick Install

git clone https://github.com/xscriptor-colors/macos.git ~/macosx-dotfiles
cd ~/macosx-dotfiles
chmod +x install.sh
./install.sh

Remote Install

Run directly from the repo without cloning:

# Install
curl -fsSL https://raw.githubusercontent.com/xscriptor-colors/macos/main/install.sh | bash

# Or with wget
wget -qO- https://raw.githubusercontent.com/xscriptor-colors/macos/main/install.sh | bash

# Uninstall
curl -fsSL https://raw.githubusercontent.com/xscriptor-colors/macos/main/uninstall.sh | bash

Manual Install

1. Install Homebrew if not already installed.
2. Run brew install sketchybar aerospace.
3. Install Hack Nerd Font: brew install --cask font-hack-nerd-font.
4. Copy sketchybar/ to ~/.config/sketchybar/.
5. Copy aerospace/aerospace.toml to ~/.config/aerospace/aerospace.toml.
6. Start services: brew services start sketchybar.
7. Reload AeroSpace: aerospace reload-config.

Uninstall

git clone https://github.com/xscriptor-colors/macos.git ~/macosx-dotfiles
cd ~/macosx-dotfiles
chmod +x uninstall.sh
./uninstall.sh

Or run remotely:

curl -fsSL https://raw.githubusercontent.com/xscriptor-colors/macos/main/uninstall.sh | bash

Usage

• Switch workspace: Ctrl + number (1-9).
• Move window to workspace: Ctrl + Shift + number.
• Focus window: Ctrl + h/j/k/l (left/down/up/right).
• Move window: Ctrl + Shift + h/j/k/l.
• Resize: Ctrl + - / Ctrl + =.
• Fullscreen: Ctrl + f.
• Close window: Ctrl + w.
• Toggle floating: Ctrl + t.
• Open apps: Ctrl + Enter (Kitty), Ctrl + v (VS Code), Ctrl + b (Brave).
• Reload AeroSpace: Ctrl + Shift + r.
• Click workspace number on the topbar to switch.

Keybindings

All bindings use Ctrl as the primary modifier to avoid conflicts with macOS Option-key characters (useful for Spanish and other non-US keyboard layouts).

Customization

Themes

SketchyBar supports multiple color palettes. Themes live in sketchybar/themes/ and are defined with the same palette names as the VS Code Xscriptor Themes (colors.md): X, Madrid, Lahabana, Miami, Paris, Tokio, Oslo, Helsinki, Berlin, London, Praha, and Bogota.

# List the current theme and available palettes
./sketchybar/theme.sh

# Switch to a palette and reload the bar
./sketchybar/theme.sh miami

You can also cycle themes directly from the topbar: click the palette item (󰑩 + current theme name) to switch to the next palette.

The active theme is persisted in ~/.config/sketchybar/theme (default: x).

• Colors: Edit sketchybar/themes/<theme>.sh to change accent colors for a palette, or add a new file to define a custom theme.
• Icons: Edit sketchybar/icons.sh to change icon glyphs (Nerd Font required).
• Window rules: Edit aerospace/aerospace.toml under on-window-detected to add new app-to-workspace bindings.
• Keybindings: Edit [mode.main.binding] in aerospace/aerospace.toml.

Contributing

Contributions are welcome. Fork the repo, make your changes, and open a pull request.

License

MIT License. See LICENSE for details.

Related Repos

• Terminal
• Nvim
• VSCode
• Jetbrains
• Obsidian
• Xcode

X

& &