my monochrome macos setup — native spaces, a compact menu bar, and a matching terminal.
overview · installation · setup · keybindings · notes
| component | application | configuration |
|---|---|---|
| window manager | yabai | .config/yabai |
| hotkeys | skhd | .config/skhd |
| menu bar | sketchybar + sbarlua | .config/sketchybar |
| terminal | ghostty | .config/ghostty |
| shell | fish | .config/fish |
| prompt | starship | .config/starship.toml |
| system info | fastfetch | .config/fastfetch |
| wallpapers | personal collection | wallpapers |
- a grayscale palette across the bar, terminal, shell, and prompt
- five native macos desktops with mission control and trackpad gestures
- a 32-point sketchybar with application icons, including helium
- native wi-fi, bluetooth, sound, battery, and now playing menus
- floating window controls with modifier + drag
built for apple silicon, homebrew at /opt/homebrew, and macos 27. native menu integration may vary between macos releases.
install apple's command line tools first:
xcode-select --installonce installed, open the repository and run:
cd ~/macos-dotfiles
./install.sh --dry-run
./install.shrun as your regular user, without sudo. the installer sets up homebrew if needed, installs dependencies, copies the configs, builds the helpers, and starts the services.
dependencies: yabai, skhd, sketchybar, lua, sbarlua, fish, starship, fastfetch, python, ghostty, nowplaying-cli, and switchaudio-osx. fonts include sf mono, sf pro, jetbrains mono nerd font, sf symbols, and the bundled sketchybar app font.
existing configs, the app font, the helper launch agent, and replaced sbarlua files are backed up under:
~/.local/share/macos-dotfiles/backups/<timestamp-id>/
the installer prints the exact backup location. it copies files rather than symlinking them; rerun it to apply repository changes.
| option | behavior |
|---|---|
--dry-run |
show the plan without changing anything |
--skip-deps |
reuse installed dependencies and sbarlua |
--no-start |
install configs and build helpers without starting services |
./install.sh --skip-deps --no-startghostty starts fish directly, so changing your login shell is optional. choose a wallpaper from wallpapers/ in system settings.
open system settings → menu bar. on older macos versions, look under control center.
keep these native items enabled so sketchybar can open their system menus:
| item | setting |
|---|---|
| wi-fi | show in menu bar |
| bluetooth | show in menu bar |
| sound | always show |
| battery | show in menu bar |
| now playing | always show |
set automatically hide and show the menu bar → always. sketchybar stays above it; the hidden native icons remain the targets for the widget buttons.
click the active application name or the spaces toggle to switch between desktops and application menus. the music label refreshes every second; artwork, playback controls, and remaining time are shown in the native now playing panel.
open system settings → privacy & security → accessibility and enable:
| application | executable | purpose |
|---|---|---|
| yabai | /opt/homebrew/bin/yabai |
manage windows |
| skhd | /opt/homebrew/bin/skhd |
global hotkeys |
| sketchybar | /opt/homebrew/bin/sketchybar |
menu bar integration |
| menus | ~/.config/sketchybar/helpers/menus/bin/menus |
open native and application menus |
| float-mouse | ~/.config/yabai/helpers/float-mouse |
resize floating windows with control + option + drag |
in the file picker, press command + shift + g and paste the executable path. helper binaries are created during installation.
allow input monitoring if macos requests it for skhd or the drag helper. allow automation access to spotify or music if prompted for the playback fallback. screen recording may be needed for desktop previews opened with the middle mouse button.
after granting permissions:
~/.config/yabai/enable-floating-controls.sh
brew services restart sketchybarfloat-mouse waits silently for accessibility access. if access appears enabled but resizing does not work after a rebuild, remove its old entry, add the current executable again, and enable it. use the included build script to preserve its signing identifier.
- create five desktops in mission control.
- under desktop & dock → mission control, disable automatically rearrange spaces based on most recent use.
- under keyboard → keyboard shortcuts → mission control, enable control + 1–5 to switch to desktops 1–5.
- under keyboard → keyboard shortcuts → input sources, disable control + space for selecting the previous input source. use the globe key or control + option + space to change languages.
fullscreen applications create additional spaces and may affect desktop numbering.
super means command on macos.
| shortcut | action |
|---|---|
command + 1–5 |
focus desktop 1–5 |
command + shift + 1–5 |
move the focused window to desktop 1–5 |
control + space |
toggle floating / tiling |
option + left drag |
move a window |
control + option + left drag |
resize a floating window |
option + right drag |
resize using yabai's native mouse binding |
command + t |
open one new ghostty window on the current desktop |
physical keycodes keep the number and terminal bindings consistent across english and russian layouts. desktop switching uses native macos shortcuts through skhd.
- window spacing is 5 points, with 3 points of top padding.
- control + option + drag only resizes floating windows, not tiled or fullscreen windows.
- the global command + t overrides the usual new-tab shortcut. it launches a separate ghostty instance without restoring saved windows, so separate dock entries are possible.
- the native player is positioned near the click when macos allows moving it. otherwise, it remains anchored to the hidden native icon.
- no scripting addition is installed and sip is left enabled. yabai operations that require a scripting addition may be unavailable on your macos version.
- wallpapers, keyboard settings, menu bar settings, and permissions are configured manually.
- shell history, fish universal variables, caches, old backups, and compiled helper binaries are excluded.
| issue | check |
|---|---|
| a widget does not open its system menu | enable its native menu bar item and check accessibility access for sketchybar and menus |
| control + space changes the input language | disable the conflicting input source shortcut and reload skhd |
| command + number does not switch desktops | test the corresponding native control + number shortcut first |
| floating resize does not work | check yabai, the window's floating state, and float-mouse accessibility access |
| an application icon is missing | check the bundled app font and .config/sketchybar/helpers/app_icons.lua |
sketchybar --reload
skhd --reload
yabai -m query --spaces
yabai -m query --windows
~/.config/sketchybar/helpers/menus/bin/menus -e
./scripts/check.shthe native player writes positioning errors to sketchybar-native-player.log in your home library's logs folder. to restore an earlier setup, stop the relevant services and replace the managed files with their copies from the backup directory printed during installation.
based on felixkratz's dotfiles, with sketchybar app font, rose-pine fish themes, everforest, and a macos adaptation of simple-fastfetch.
third-party configurations, themes, and fonts retain their upstream licenses. wallpapers belong to their respective creators.