mac-config

The main configuration files I use for my work MacBook.

This repo contains the following config files:

• Zsh shell configuration

  See its own README for details.

• Karabiner key mapping configuration

  I have a lot of muscle memory from using Windows and Linux OSs and keyboards, and this makes it a lot easier.

  Although I previously remapped some of the modifier keys using the native MacOS Preferences interface, I now have implemented almost everything in my Karabiner configuration.

  • On my Windows keyboard, I have the modifier keys (Ctrl ⊞ Win Alt) remapped as the following:

    Physical keyboard key	Mapped to MacOS...
    Ctrl	⌘ Command
    ⊞ Win	⌥ Option
    Alt	^ Control

  • On the built-in MacBook keyboard, I have the modifier keys (fn ^ Control ⌥ Option ⌘ Command) remapped as the following:

    Physical keyboard key	Mapped to MacOS...
    fn	⌘ Command
    ^ Control	fn
    ⌥ Option	⌥ Option
    ⌘ Command	^ Control

    Note for future Lucas: The internal keyboard's product ID and vendor ID is likely different between each MacBook, so you will need to create a new set of these built-in MacBook keyboard mapping for each new laptop.

  I also have a few extra key combination shortcuts that do special things. For example, ⌥ Option(mapped)+Tab opens MacOS Mission Control, and a single press on ⌥ Option(mapped) is mapped to the keyboard shortcut to open Raycast.

  This karabiner/ directory is symlinked from ~/.config/karabiner.

• MacOS key bindings for text navigation

  In addition to the above Karabiner settings to change keys, I have also changed some of the default MacOS keybindings to make keyboard text navigation behave more like Windows.

  This includes changing the behaviour of the Home and End keys to respectively move the cursor to the beginning and end of a line (and using Shift to select the text, if desired).

  Also, I have swapped the ⌘ Command/⌥ Option+ arrow keys behaviour: ⌘ Command(mapped)+←/→ now moves the cursor between words, and ⌥ Option(mapped)+←/→ moves to the start/end of a line (and Shift with both sets to select the text, if desired).

  This seems to work in most places in MacOS, except Electron-based apps (like VS Code, Atom, Slack, etc.). The editors like VS Code have their own keymaps, so I have also had to replicate this behaviour in the VS Code keymap settings. For apps that don't allow you to customise this, like Slack, I've had to resort to Karabiner rules.

  Place this file in the ~/Library/KeyBindings folder (you might need to create that folder).

  Inspiration from: https://damieng.com/blog/2015/04/24/make-home-end-keys-behave-like-windows-on-mac-os-x

• iTerm2 configuration

  Especially for the colour palette that I really got used to when using Fedora, as well as some key mappings (as iTerm2 doesn't recognise/respect most custom DefaultKeyBinding.dict settings).

  Set the iTerm configuration to this file in iTerm2 > Preferences > General > Preferences > Load preferences from a custom folder or URL.

• VS Code configuration

  The files that control the majority of my VS Code editor's configuration.

  These files/folders are symlinked from ~/Library/Application Support/Code/User/

  To get a list of extensions, I used this command: code --list-extensions > vs_code_extensions_list.txt

• Firefox

  Mainly just userChrome.css, this configures some minor (mainly font) changes in the Firefox UI, aka the 'chrome'. The user chrome file is located in the Firefox profile on macOS at ~/Library/Application Support/Firefox/Profiles/xxxxxxxx.default/chrome/userChrome.css, and is symlinked to the file in this repo.

  See https://www.reddit.com/r/FirefoxCSS/ for some good tutorials and required settings for a custom userChrome.css.

  Note: In recent versions of Firefox, you must also go to about:config and set toolkit.legacyUserProfileCustomizations.stylesheets to true for the userChrome.css file to take effect.

• Some other minor settings:

  • After the Big Sur upgrade, fonts were heavy and ugly. Run this command to get them looking good again, and restart:

    defaults -currentHost write -g AppleFontSmoothing -int 0

  • I use uBar as a Windows-like taskbar, so I have the MacOS Dock set to autohide on the right of the screen. This command sets the Dock to be less sensitive to appear, so it's less prone to accidental activation when I move the cursor near the right edge of the screen.

    defaults write com.apple.dock autohide-delay -float 0.20
    killall Dock

  • For uBar showing document icons over the application icons, use this command to only show the application icon for windows:

    defaults write ca.brawer.uBar useAppIconForWindows -bool YES