AeroSpace is an i3-like tiling window manager for macOS
Project homepage: https://github.com/nikitabobko/AeroSpace
Do you have a cool automatization, AeroSpace integration, or workflow?
Feel free to open an issue or pull request to add it to this list!
The source code of the page can be found in ./docs
directory.
1. Move windows by dragging any part of the window
defaults write -g NSWindowShouldDragOnGesture YES
Now, you can move windows by holding ctrl + cmd
and dragging any part of the window (not necessarily the window title)
2. Highlight focused windows with colored borders
To highlight the focused window with colored border you can use JankyBorders.
You can also use after-startup-command
to start JankyBorders together with AeroSpace
after-startup-command = [
# JankyBorders has a built-in detection of already running process,
# so it won't be run twice on AeroSpace restart
'exec-and-forget /opt/homebrew/opt/borders/bin/borders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0'
]
3. Disable windows opening animations
Observable in Google Chrome
defaults write -g NSAutomaticWindowAnimationsEnabled -bool false
4. Use trackpad gestures to switch workspaces
You can use BetterTouchTool to assign trackpad gestures to switch workspaces
The following commands focus next or previous workspaces on monitors where the mouse is located
aerospace workspace "$(aerospace list-workspaces --monitor mouse --visible)" && aerospace workspace next
aerospace workspace "$(aerospace list-workspaces --monitor mouse --visible)" && aerospace workspace prev
Beware that you might need to specify full path to aerospace executable https://community.folivora.ai/t/how-to-execute-terminal-command-to-switch-workspaces-with-aerospace/35914
5. Show AeroSpace workspaces in Sketchybar
You can integrate AeroSpace workspace indicators with Sketchybar. Use these snippets as a starting point.
# Run Sketchybar together with AeroSpace
# sketchbar has a built-in detection of already running process,
# so it won't be run twice on AeroSpace restart
after-startup-command = ['exec-and-forget /opt/homebrew/opt/sketchybar/bin/sketchybar']
# Notify Sketchybar about workspace change
exec-on-workspace-change = ['/bin/bash', '-c',
'/opt/homebrew/opt/sketchybar/bin/sketchybar --trigger aerospace_workspace_change FOCUSED_WORKSPACE=$AEROSPACE_FOCUSED_WORKSPACE'
]
sketchybar --add event aerospace_workspace_change
for sid in $(aerospace list-workspaces --all); do
sketchybar --add item space.$sid left \
--subscribe space.$sid aerospace_workspace_change \
--set space.$sid \
background.color=0x44ffffff \
background.corner_radius=5 \
background.height=20 \
background.drawing=off \
label="$sid" \
click_script="aerospace workspace $sid" \
script="$CONFIG_DIR/plugins/aerospace.sh $sid"
done
#!/usr/bin/env bash
# make sure it's executable with:
# chmod +x ~/.config/sketchybar/plugins/aerospace.sh
if [ "$1" = "$FOCUSED_WORKSPACE" ]; then
sketchybar --set $NAME background.drawing=on
else
sketchybar --set $NAME background.drawing=off
fi
6. Open a new window with AppleScript
Invoking Safari/Terminal with a command the obvious way (exec-and-forget open -a Safari
) results in an outcome that is probably not the intended one.
Namely, that any workspace already containing an instance of Safari/Terminal is brought in focus.
Opening a new window of a program that can supports multiple windows (such as Safari or Terminal.app) can be accomplished with an AppleScript inlined in aerospace.toml
as follows:
-
Safari
ctrl-g = '''exec-and-forget osascript <<EOF tell application "Safari" make new document at end of documents activate end tell EOF'''
-
Terminal
ctrl-g = '''exec-and-forget osascript <<EOF tell application "Terminal" do script activate end tell EOF'''
7. Disable annoying and useless "hide application" shortcut
[mode.main.binding]
cmd-h = []
8. Colemak keys remap
[key-mapping.key-notation-to-key-code]
q = 'q'
w = 'w'
f = 'e'
p = 'r'
g = 't'
j = 'y'
l = 'u'
u = 'i'
y = 'o'
semicolon = 'p'
leftSquareBracket = 'leftSquareBracket'
rightSquareBracket = 'rightSquareBracket'
backslash = 'backslash'
a = 'a'
r = 's'
s = 'd'
t = 'f'
d = 'g'
h = 'h'
n = 'j'
e = 'k'
i = 'l'
o = 'semicolon'
quote = 'quote'
z = 'z'
x = 'x'
c = 'c'
v = 'v'
b = 'b'
k = 'n'
r = 'm'
comma = 'comma'
period = 'period'
slash = 'slash'
9. List of popular and built-in applications IDs
The list is useful to compose custom on-window-detected callback.
Application name | Application ID |
---|---|
1Password |
|
Activity Monitor |
|
AirPort Utility |
|
Alacritty |
|
Android Studio |
|
App Store |
|
AppCode |
|
Arc Browser |
|
Audio MIDI Setup |
|
Automator |
|
Battle.net |
|
Books |
|
Brave |
|
CLion |
|
Calculator |
|
Calendar |
|
Chess |
|
Clock |
|
ColorSync Utility |
|
Console |
|
Contacts |
|
Dictionary |
|
Disk Utility |
|
Docker |
|
FaceTime |
|
Figma |
|
Find My |
|
Finder |
|
Firefox |
|
Freeform |
|
GIMP |
|
Google Chrome |
|
Grapher |
|
Home |
|
Inkscape |
|
IntelliJ IDEA Community |
|
IntelliJ IDEA Ultimate |
|
Karabiner-Elements |
|
Keychain Access |
|
Keynote |
|
Kitty |
|
|
|
Maps |
|
Marta |
|
Messages |
|
Music |
|
Notes |
|
Obsidian |
|
Pages |
|
Photo Booth |
|
Photos |
|
Podcasts |
|
Preview |
|
PyCharm Community |
|
PyCharm Professional |
|
QuickTime Player |
|
Reminders |
|
Safari |
|
Shortcuts |
|
Slack |
|
Spotify |
|
Steam |
|
Stocks |
|
Sublime Merge |
|
Sublime Text |
|
System Settings |
|
TV |
|
Telegram |
|
Terminal |
|
TextEdit |
|
Thunderbird |
|
Time Machine |
|
Todoist |
|
Tor Browser |
|
Transmission |
|
VLC |
|
Visual Studio Code |
|
VoiceMemos |
|
VoiceOver Utility |
|
Weather |
|
WezTerm |
|
Xcode |
|
iMovie |
|
iTerm2 |
|
kdenlive |
|