~ 🍭 ~

For setting up development environment on any Unix machine (Darwin/Linux). The config officially supports macOS & NixOS & managed by nix

What's in it?

These are the main configs:

• nix to manage installing most of the dependencies, for GUI apps on macsOS I'm still using Homebrew cask through the homebrew module in nix-darwin
• neomutt for reading emails
• tmux 2.3 or later
• Neovim or [Vim][vim] 8.0 or later
• Zsh
• Git
• Kitty as my terminal
• newsboat for RSS
• weechat IRC client
• hammerspoon macOS automation, using it for window management & other stuff

Officially supported OSs

• macOS (tested on BigSur)
• NixOS (tested on 20.09)

Installation

1. Install Command line tools.

$ xcode-select --install

2. Run the following command

$ bash -c "$(curl -fsSL https://raw.github.com/ahmedelgabri/dotfiles/master/install)"

Notes

• zsh: add these to ~/.zshrc.local

export HOMEBREW_GITHUB_API_TOKEN =
export GITHUB_TOKEN =
export WEECHAT_PASSPHRASE =

• For git add your GPG key info in ~/.gitconfig.local

[user]
  signingkey =

Don't forget to upload your public key to GitHub!

Note: There needs to be a three-way match on your email for GitHub to show the commit as 'verified': The commit email, github email, & the email associated with the public key

Learn about creating a GPG key and signing your commits here

Email

My email messages are synchronised between the remote server and my computer with isync, I read them with neomutt and search index is built by notmuch.

After linking the dotfiles, there are only a few more things that need to be done.

Authentication

Each account must authenticate with an IMAP server and an SMTP server. The passwords, need be stored in the OS X keychain.

For Fastmail (or Gmail accounts with two-factor authentication enabled), use an application-specific password.

In order for all this to work, a few items have to be stored in the macOS keychain:

Create a "generic"(A.K.A. "application") keychain item (that is, without protocols, only hostnames):

For sending mail:

• An item with:
  • "Keychain Item Name": fastmail.com
  • "Account Name": [email protected]

Repeat this for each account you want to add.

Synchronizing periodically

Incoming messages are fetched from the remote server when mbsync runs (the executable name for isync).

On macs I use launchd, on NixOS using systemd. You can check mail.nix.

Authors

Ahmed El Gabri