macOS Xscriptor

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

---

Preview

---

Contents

• About
• 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.

Structure

• sketchybar/ — SketchyBar config: bar styles, items, plugins, colors, and icons.
• 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.
• assets/ — Screenshots and branding.

Quick Install

git clone https://github.com/xscriptor/macosx.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/macosx/main/install.sh | bash

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

# Uninstall
curl -fsSL https://raw.githubusercontent.com/xscriptor/macosx/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/macosx.git ~/macosx-dotfiles
cd ~/macosx-dotfiles
chmod +x uninstall.sh
./uninstall.sh

Or run remotely:

curl -fsSL https://raw.githubusercontent.com/xscriptor/macosx/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

• Colors: Edit sketchybar/colors.sh to change accent colors for the topbar.
• 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
• Gitnapse
• Obsidian
• XFetch
• Xcode

X

& &