👋 Welcome to my home!

This is my personal collection of dotfiles for my macOS setup, which is focused on a minimal, elegant, keyboard-driven workflow.

Here’s an overview of my current setup:

• Operating System: macOS Tahoe
• Window Manager: yabai
• App Borders: JankyBorders
• Hotkeys: skhd
• Status Bar: Sketchybar
• Terminal: ghostty
• Shell: fish
• Prompt: starship
• Resource Monitor: btop

After using Linux for the past few years, I was surprised by how limited macOS felt out of the box, especially when it came to window management. This setup aims to address those shortcomings, by creating an environment similar to Sway or Hyprland. If you're coming from another tiling window manager, you'll feel right at home with these dotfiles.

🔎 Details

🌈 Color Scheme

The main color scheme of my setup is Rosé Pine, a minimal yet elegant theme that is easy on the eyes.

🌦️ Sketchybar Weather

For the sketchybar weather plugin to work properly, you have to create an account and get an API key from OpenWeather. After signing up, go grab your API key here and paste it at the top of ~/.config/sketchybar/plugins/weather.sh.

Note

After creating your account, your API key might not work right away. Wait about 20-30 minutes for it to activate.

🔠 Fonts

• System/Interface Font: SF Pro
• Monospace Font: Jetbrains Mono Nerd

Additionally, my sketchybar config uses sketchybar-app-font for the app icons on the left of the bar, and SF Symbols for the icons on the right.

⌨️ Keyboard Shortcuts

I highly suggest binding capslock to control + option + command using Karabiner-Elements, since that combination of keys is used as the modifier key for my yabai/skhd config. After installing, go to Complex Modifications -> Add Your Own rule -> And paste the following:

{
    "description": "Caps lock key -> hyper key without shift (⌘⌥⌃), Escape when tapped",
    "manipulators": [
        {
            "from": {
                "key_code": "caps_lock",
                "modifiers": { "optional": ["any"] }
            },
            "to": [
                {
                    "key_code": "left_command",
                    "modifiers": ["left_option", "left_control"]
                }
            ],
            "to_if_alone": [{ "key_code": "escape" }],
            "type": "basic"
        }
    ]
}

On top of that, pressing capslock normally will register it as the esc key, which is useful for vim users.

Below is an overview of the most important keyboard shortcuts.

• capslock + h/j/k/l - Move focus left/down/up/right
• shift + capslock + h/j/k/l - Move window left/down/up/right
• capslock + 1, 2, 3, ... - Focus space 1, 2, 3, ...
• shift + capslock + 1, 2, 3, ... - Move window to space 1, 2, 3, ... and focus it
• capslock + q/w - Focus monitor 1/2
• shift + capslock + q/w - Move window to monitor 1/2 and focus it
• capslock + u/i/o/p - Resize windows left/down/up/right

For a complete list, please check out the skhd config file.

⚙️ Installation

Clone this repository, and move all of the directories to ~/.config. The wallpapers are in the Assets directory.

Note

My dotfiles are still a work in progress, so expect some changes. If you encounter any problems, feel free to open an issue or a pull request.