Skip to content

About

my macos setup for daily usage

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

macos-dotfiles

my monochrome macos setup — native spaces, a compact menu bar, and a matching terminal.

desktop preview

overview · installation · setup · keybindings · notes

overview

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

installation

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 --install

once installed, open the repository and run:

cd ~/macos-dotfiles
./install.sh --dry-run
./install.sh

run 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-start

ghostty starts fish directly, so changing your login shell is optional. choose a wallpaper from wallpapers/ in system settings.

setup

native menu bar

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.

permissions

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 sketchybar

float-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.

spaces and keyboard

  1. create five desktops in mission control.
  2. under desktop & dock → mission control, disable automatically rearrange spaces based on most recent use.
  3. under keyboard → keyboard shortcuts → mission control, enable control + 1–5 to switch to desktops 1–5.
  4. 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.

keybindings

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.

notes

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

troubleshooting

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.sh

the 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.

credits

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.

About

my macos setup for daily usage

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

⌂