Notes

Tools installed via brew

Name	Description
fzf	Used by ZSH plugins
dive	Browse contents of Docker images
jq	Manipulating JSON
direnv	Per-directory environment-configuration
pandoc	Generating man from markdown
ipcalc	Working out CIDR ranges
powerline-go	Advanced command prompt
kubernetes-cli	kubectl
kubectx	Switch between Kubernetes contexts
stern	Tail multiple Kubernetes pods
k9s	Visualise Kubernetes cluster in CLI
pgcli	PostgreSQL tool
pv	Monitor the progress of data through a pipe

`bash/.bash_profile`

When bash is invoked as an interactive login shell, or as a non-interactive shell with the --login option, it first reads and executes commands from the file /etc/profile, if that file exists. After reading that file, it looks for ~/.bash_profile, ~/.bash_login, and ~/.profile, in that order, and reads and executes commands from the first one that exists and is readable

`bash/.bashrc`

When an interactive shell that is not a login shell is started, bash reads and executes commands from /etc/bash.bashrc and ~/.bashrc

Go & private Git servers

To get go get to work with private Git servers, like BitBucket server, ssh-add the SSH key and then git config --global.url url."ssh://git@server:port/".insteadOf "https://server/scm"

Useful commands

Why has Homebrew installed a dependency - brew uses --recursive --installed formulae-name
Remove dependencies automatically installed but no longer needed - brew autoremove
Slowly display a file - cat filename | pv --quiet --line-mode --rate-limit 5
Mark a package as automatically installed again - sudo apt-mark auto $PKG_NAME

Workarounds

Unable to compile Go programs on Linux using Go installed using Homebrew (cgo: C compiler "gcc-5" not found: exec: "gcc-5": executable file not found in $PATH) - see home/private_dot_config/go/env (https://stackoverflow.com/questions/59227456/go-1-13-gcc-5-not-in-path)
Repeatedly ask to install clang on macOS when running Homebrew - run sudo xcode-select --switch /Library/Developer/CommandLineTools
Unable to access reMarkable via USB on a Mac:
1. Unplug reMarkable
2. ifconfig > without.txt
3. Plug in reMarkable
4. diff without <(ifconfig) - e.g. > en6: flags=8822<BROADCAST,SMART,SIMPLEX,MULTICAST> mtu 1500
5. sudo ifconfig en6 10.11.99.2
6. If the mac address always stays the same (matches SHA-256 e3d9ad308787a51594be1fbf589bf41479f45df173784e1e7c0657f7b3383edb), then:
  - for f in $(ifconfig -l); do if [ "$(ifconfig $f | grep ether | cut -d' ' -f2)" = "$MAC_ADDRESS" ]; then; sudo ifconfig $f 10.11.99.2; fi; done
Unable to install Visual Studio Code extensions - getting the error unable to get local issuer certificate
- Unset Http: Proxy Strict SSL setting. HTTPS traffic is being intercepted and this can be verified by going to https://google.com and checking who the certificate is signed by.

ShellCheck notes

Use foo | while read to loop through a list of items
- https://www.shellcheck.net/wiki/SC2013
- https://www.shellcheck.net/wiki/SC2044
- while read do; done < <(foo) seems to have issues when foo fails, so best avoided

Installing

Initial per-O/S steps

macOS

Sign in to the app store
Install all updates
Launch the app store and sign in

Ubuntu

Install packages required by Homebrew

Common steps

Install Homebrew - either at the standard location (/usr/local/bin or /home/linuxbrew/.linuxbrew/bin) or at $HOME/dev/brew
Add Homebrew to the path of the current shell (eval "$(/path/to/homebrew/install/bin/brew shellenv)")
brew install chezmoi
chezmoi init wjam
chezmoi apply

Common post installation

Set up GitHub SSH key
1. ssh-keygen -t ed25519 -C "" -f ~/.ssh/keys/github.com
2. git remote set-url origin git@github.com:wjam/dotfiles.git
3. git fetch
  - Fingerprint for GitHub can be found at https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints

Ubuntu post installation

Configure rclone TODO

macOS post installation

Create two shortcuts (app added with Monterey): focus-mode (turn on do not disturb), and unfocus-mode (turn off do not disturb)
Add 'Home' network location & create ~/.hammerspoon/ssid.json like {"home": "SSIDOfHomeNetwork"}
Tweak Finder
- Add home directory to the sidebar
Settings > Display > Resolution: Scaled (More Space)
Settings > Display > Show mirroring options in the menu bar when available
Start hammerspoon
- launch at login
- enable accessibility
Start Stats and select start at login
Start JetBrains toolbox
Show sound in menu bar
Show bluetooth in menu bar
Settings > Keyboard > Keyboard Shortcuts > Function Keys > 'Use F1, F2, etc. keys as standard function keys'
KeeWeb
- Security & Privacy > Privacy > Accessibility
Settings > Date & Time > Clock: Show date
Neuter Spotlight (stop it crawling & using results from files being changed on disk)
- Settings > Spotlight:
  - Privacy:
    - Add dev folder, e.g. /Users/wjam/dev
Set up Firefox
- Language: English (GB)
- British English Dictionary (Marco Pinto)
- uBlock Origin
- Auto Tab Discard
- Firefox Multi-Account Containers

Testing

Run the Go tests inside a Docker container with Homebrew, etc. installed:

docker run --rm -v $(pwd):/home/docker/.local/share/chezmoi -it $(docker build -q .) /home/docker/.local/share/chezmoi/testing.sh --promptBool "Have admin access? y or n:"=y,"Install everything? y or n:"=n --promptString "Email address for Git:"=ci@example.test

TODO

Find out why meeting interruption stuff isn't working when streamdeck is connected
Find something cask-like for Linux.
- Software:
  - Visual Studio Code
  - Slack
  - Firefox
  - Jetbrains Toolbox
  - wezterm
  - LibreOffice
- Options:
  - Snap - Ubuntu only, must be run as root unless you've snap login first (?)
  - AppImage - not supported for all apps like vscode
Find a way to disable sudo access in CI to test no admin access (apt will fail as code is assumed to be present at vscode-extensions script (install via snap?))
Find out whether update-desktop-database ~/.local/share/applications is needed once .desktop files are added?
Borgmatic?
Hetzner

wjam / dotfiles