dotfiles

Here are instructions to reproduce my development environment on macOS, along with all my dotfiles.

Check out the companion blog post: Your dev environment is your ideal supermarket.

Installation instructions for Mac

Foundation

After the first boot, perform all the possible OS updates:

• install major and minor upgrades in System Settings > Software Updates, then reboot and check again until there are no more updates
• in terminal, install XCode command line tools: xcode-select --install
• check again System Settings > Software Updates and install updates if available, then reboot again. Repeat until there are no more updates.
• System Settings > Privacy & Security > FileVault: click Turn On FileVault then set a recovery key and save it in password manager

Create workspace directory:

• mkdir workspace

Configure Mac settings:

• Appearance: set Show scroll bars to Always
• Lock Screen > Turn display off on ...: turn display off after 20 min on battery, after 1h for power adapter
• Trackpad > Scroll & Zoom > uncheck Scroll direction: Natural
• Keyboard > Text Input > Edit... then disable "Use smart quotes and dashes"
• Keyboard: set Key Repeat to fastest and Delay until Repeat to shortest
• Keyboard > Keyboard Shortcuts
  • Input Sources: uncheck Select the previous ... and Select the next ...
  • Keyboard > Move focus to active or next window: press CMD + <
• Mouse > Tracking speed: set to 3rd cursor from the right
• Desktop & Dock: set a small size, set Position on screen to right and set Automatically hide and show the Dock
• remove all optional icons from Dock
• Desktop & Dock > Keyboard and Mouse Shortcuts: deactivate ALT-DOWN (Mission Control) and ALT-UP (Application windows) by replacing them with -
• Control Centre > Battery: Show Percentage
• Screenshot app: go to Options > Save to and select Other location, then create folder in ~/workspace called screenshots and put it there
• Finder app: go to Settings > Advanced and check Show all filename extensions, add home directory to Favourites, run mkdir ~/dailydirs and add dailydirs to Favourites

Terminal

Populate iTomate config file:

• nano ~/.itomate.yml

version: "1.0"
profile: "pwalch profile"
tabs:
  workspace:
    root: "~/workspace"
    title: "workspace"
    panes:
      - position: "1/1"

Install Brew:

• /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• close and re-open Terminal

• brew install --cask iterm2

• close Terminal app and open iTerm app

• System Settings > Privacy & Security > Privacy > Full Disk Access: add iTerm from Applications directory

• generate SSH key

  • ssh-keygen -t ed25519 -C "$(date "+%Y%m%d")-DEVICE-NAME"

• brew install zsh-completions tmux

• install tmux Powerline font: GitHub link

• Settings > General > Magic and check Enable Python API

• Settings > Appearance > Dimming set Dimming amount to 15

• Settings > Profiles > Text and select Fira Mono for Powerline

• Settings > Profiles > Keys and do (...) Presets... then Natural Text Editing, then Remove, then and press + then set Keyboard shortcut to OPTION+SPACE, Action to Send text and the text below to

• Settings > General > Selection: check Applications in terminal may access keyboard

• Settings > Keys > Key Bindings

  • set Next Pane to CMD+j
  • set Split Vertically with Profile (Default) to CMD+k
  • set Split Horizontally with Profile (Default) to CMD+l
  • set New Tab with "Default" Profile" to CMD+t
  • set Scroll One Line Up to CMD+up
  • set Scroll One Line Down to CMD+down
  • set Previous Tab to ALT+CMD+LEFT and CMD-UP
  • set Next Tab to ALT+CMD+RIGHT and CMD-DOWN

• Settings > Keyboard > Keyboard Shortcuts > App Shortcuts, add a new item with application iTerm.app with menu title Restart Session and set shortcut CMD+SHIFT+R

• iTerm2 > Install Shell Integration and follow instructions

• install oh-my-zsh

  • sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
  • potential nice theme
    • curl -sL https://raw.githubusercontent.com/moarram/headline/main/headline.zsh-theme -o ~/.oh-my-zsh/themes/headline.zsh-theme ZSH_THEME="headline"

• close and re-open terminal

• install some oh-my-zsh extensions

  • git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
  • git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
  • git clone https://github.com/MichaelAquilina/zsh-you-should-use.git $ZSH_CUSTOM/plugins/you-should-use

• close and re-open terminal

• cd ~

• install Tmux and gpakosz

  • git clone https://github.com/gpakosz/.tmux.git
  • ln -s -f .tmux/.tmux.conf

• apply chezmoi

  • sh -c "$(curl -fsLS git.io/chezmoi)" -- init --apply pwalch

GUI applications

Install all Brew Cask applications and start each of them for the first time:

brew install --cask google-chrome firefox \
    rectangle flycut notunes \
    visual-studio-code pycharm-ce docker git-lfs \
    thunderbird obsidian vlc gimp zoom libreoffice \
    tailscale

• Rectangle: start app and set up permissions, set shortcuts for left/right half, next/previous display and fullscreen, launch on login
• Chrome
  • make default browser, disable form autofill and password management, install uBlock Origin and 1Password
  • Settings > Privacy and security > Security > Scroll to bottom: toggle Always use secure connections
  • in Settings > Keyboard > App Shortcuts, set Select Previous Tab to CMD-UP Select Next Tab to CMD-DOWN, Move Tab to New Window to CMD-D
  • start a meeting on Google Meet and try to get audio, video and share screen, which will trigger permissions request and require restarting the app
• Firefox
  • make default browser, disable password autofill, install uBlock Origin extension
  • Privacy & Security > Passwordsuncheck Ask to save passwords
  • Privacy & Security HTTPS-Only Mode select Enable HTTPS-Only mode in all windows
• Flycut: start app and set up permissions, set shortcut to CMD + SHIFT + K, check Move pasted item to top of stack, Privacy & Security > Privacy > Accessibility add Flycut, launch on login by going to "Login Items" and adding "Flycut.app" (TermiT/Flycut#206)
• Thunderbird: set up email accounts
  • Gmail: imap.gmail.com:993, smtp.gmail.com:993 with email address as user name and application password as password
  • in account settings in Copies & Folders, check Bcc these email addresses with the email address of the account so all sent messages go to the inbox
• Zoom
  • log in, start a meeting and try to get audio, video and share screen, which will trigger permissions request and require restarting the app
  • in Background & Effects and enable virtual background
  • in Audio check Automatically join computer audio when joining and Mute my mic when joining
  • in Video check Stop my video when joining
  • in PMI Settings (appears when clicking on down-arrow next to New Meeting button), check Waiting Room and Mute participants upon entry
  • disable audio and video when starting a meeting
• PyCharm: start app and set it up
• GIMP: start app as it takes longer the first time
• noTunes
  • start noTunes app and accept to open
  • System Preferences > Login Items in Open at Login add noTunes

VS Code:

• in macOS System Settings, go to Privacy & Security > Privacy > Full Disk Access then add VS Code
• Settings > Profile then Import Profile...
• import profile from pwalch.code-profile in the repo

Notes about profile:

• "key": "cmd+[Backslash]" is actually '#', not backslash
• various points of interest
  • workbench.action.previousEditor
  • workbench.action.nextEditor
  • viewContainer.workbench.view.explorer.enabled
  • explorer.openAndPassFocus
  • workbench.action.splitEditorRight

Terminal applications

brew tap pwalch/lonesnake
brew install \
    micro bat sd the_silver_searcher ripgrep up \
    fd eza tree broot ranger highlight fzf zoxide \
    direnv git-lfs diff-so-fancy lazygit shellcheck mosh \
    nvm lonesnake \
    coreutils procs dust ctop lazydocker viddy \
    wget cowsay ffmpeg ipmitool awscli docker-credential-helper-ecr \
    jless

micro ~/.config/micro/settings.json

{
    "tabstospaces": true
}

micro ~/.config/micro/bindings.json (Ctrl-d solves the issue with backspace duplicating the line)

{
    "Alt-/": "lua:comment.comment",
    "CtrlUnderscore": "lua:comment.comment",
    "Ctrl-d": "Delete",
    "AltShiftUp": "SpawnMultiCursorUp",
    "AltShiftDown": "SpawnMultiCursorDown",
    "AltUp": "MoveLinesUp",
    "AltDown": "MoveLinesDown",
    "CtrlUp": "DuplicateLine",
    "CtrlDown": "DuplicateLine"
}

micro ~/.config/ranger/rc.conf

copymap <UP>       k
copymap <DOWN>     l
copymap <LEFT>     j
copymap <RIGHT>    é

Node

• nvm install 18

Python

• cd ~
• lonesnake
• close and re-open terminal
• check that which python points to ~/.lonesnake/venv/bin (this should be done by zshrc_custom)
• ~/.lonesnake/venv/bin/pip install pipx
• for PACKAGE in itomate thefuck httpie magic-wormhole black isort flake8; do pipx install "$PACKAGE"; done

AWS

• install AWSCLI with tutorial
• aws configure and enter default keys
• mkdir -p ~/.docker && echo '{"credsStore": "ecr-login"}' > ~/.docker/config.json
• workaround for Docker for Mac issue
  • alias docker-configure-ecr="mkdir -p ~/.docker && echo '{\"credsStore\": \"ecr-login\"}' > ~/.docker/config.json"

Kinesis Keyboard config

• enter Power User Mode: PROGM + SHIFT + ESC
• enable/disable virtual drive: PROGM + F1

state.txt

startup_file=p_qwerty.txt
key_click_tone=ON
toggle_tone=ON
macro_disable=OFF
macro_speed=3
status_play_speed=3
power_user=true

v_drive_open_on_startup=off

p_qwerty.txt

{=}>{speed8}{-lshift}{=}{+lshift}{space}
{lshift}{=}>{speed8}{=}
{caps}>{speed8}{-lctrl}{z}{+lctrl}
[lctrl]>[rctrl]
[lalt]>[lalt]
[ralt]>[rctrl]
[rctrl]>[lalt]
[delete]>[lwin]
[end]>[delete]
{home}>{speed8}{-lshift}{2}{+lshift}

Tips

• on virtual keyboard, rctrl points to left CTRL key
• in Kinesis config file, rctrl corresponds to the expected CTRL-RIGHT key
• LeftOpt and RightOpt lead to the same key in virtual keyboard
• known correspondances between physical keyboard and Kinesis key names
  • STRG LEFT => lctrl
  • ALT LEFT => lalt
  • ALT GR => ralt
  • STRG RIGHT => rctrl

optional paging replacement

{pup}>{speed8}{up}{up}{up}{up}{up}{up}{up}{up}{up}{up}
{pdown}>{speed8}{down}{down}{down}{down}{down}{down}{down}{down}{down}{down}