TymekDev's dotfiles

Hey 👋 This repo holds config files for the tools that I use. The list of tools can be found in Brewfile.

Explore, get inspired, and beware, because here be dragons! If you have any questions feel free to reach out to me at [email protected], enjoy!

Setup

Caution

I haven't tried the MacOS setup on a clean OS yet.

MacOS

1. Run:

   xcode-select --install

2. Install brew:

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

3. Clone the repo:

   git clone https://github.com/TymekDev/dotfiles ~/personal/dotfiles
   git -C ~/personal/dotfiles remote set-url origin [email protected]:TymekDev/dotfiles

4. Symlink config files:

   make --directory ~/personal/dotfiles setup-os-macos

   • ⚠️ Make sure that ~/.config/karabiner is a symlink (details)
5. Install by hand:
   • Tailscale: https://pkgs.tailscale.com/stable/#macos
   • Google Chrome
6. Disable Firefox title bar
7. Add the following snippet at the very bottom of ~/.ssh/config:

   Host *
     IdentityAgent "SSH_AUTH_SOCK"
   

8. Install Neovim spell files
   • Note: Enable NetRW and disable oil.nvim to download spell files (see stevearc/oil.nvim#163)

NixOS

Note: This uses the sffpc host. Adjust the host, paths, and URIs accordingly if needed.

1. Download the minimal NixOS ISO image and create a bootable USB
2. Run the live version from the USB
3. Use disko with nix/disko/sffpc.nix to partition the disk:
   1. Make sure that the device value in nix/disko/sffpc.nix is up to date
   2. Run:

      curl -o /tmp/disko.nix https://raw.githubusercontent.com/TymekDev/dotfiles/main/nix/disko/sffpc.nix
      sudo nix --experimental-features "nix-command flakes" run github:nix-community/disko/latest -- --mode destroy,format,mount /tmp/disko.nix

   3. Verify that mount | grep /mnt shows new entries for /mnt and /mnt/boot
4. (Only if setting up a new machine) Retrieve hardware-configuration.nix:
   1. Run:

      sudo nixos-generate-config --no-filesystems --root /mnt

   2. Add /mnt/etc/nixos/hardware-configuration.nix to this repository
   3. Update flake.nix to include the added file
   4. Push the updated version
5. Install the system:

   sudo nixos-install --root /mnt --flake github:TymekDev/dotfiles#sffpc --no-write-lock-file

6. Set a password for users defined in the configuration:

   sudo nixos-enter --root /mnt -c "passwd tymek"

Extending

To rebuild the system after making changes run:

nixos-rebuild switch --use-remote-sudo --flake .

Note: If you see an error that a file is missing, then make sure it is tracked by git. Flakes are git-aware and the error doesn't suggest that this might be the issue.

WSL

1. Install WezTerm (on Windows)
2. Install WSL
   1. Open PowerShell
   2. Run wsl --list --online for the list of available distros
   3. Install the distro wsl --install -d <distro>, e.g. wsl --install -d Ubuntu-24.04
   4. Restart Windows
3. After Windows boots up:
   1. Set a UNIX username and password up
   2. Run: sudo apt-get update
   3. Run: sudo apt-get upgrade
4. If necessary, carry certificates over from Windows (see Fixing WSL Certificates)
5. Install brew:

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

6. Clone the repo:

   git clone https://github.com/TymekDev/dotfiles ~/personal/dotfiles
   git -C ~/personal/dotfiles remote set-url origin [email protected]:TymekDev/dotfiles

7. Symlink config files:

   make --directory ~/personal/dotfiles restow

8. Install programs:

   /home/linuxbrew/.linuxbrew/bin/brew bundle --file ~/personal/dotfiles/Brewfile install
   /home/linuxbrew/.linuxbrew/bin/bob use stable # installs Neovim

9. Configure fish:

   echo "/home/linuxbrew/.linuxbrew/bin/fish" | sudo tee -a /etc/shells
   chsh -s /home/linuxbrew/.linuxbrew/bin/fish

10. Install WezTerm terminfo:

    tempfile=$(mktemp) \
      && curl -o $tempfile https://raw.githubusercontent.com/wez/wezterm/master/termwiz/data/wezterm.terminfo \
      && tic -x -o ~/.terminfo $tempfile \
      && rm $tempfile

11. rsync the WezTerm config to the Windows host:

    rsync --delete-after --mkpath --recursive --verbose \
      config/wezterm/ \
      $(wslpath $(cmd.exe /C "echo %USERPROFILE%" 2>/dev/null | tr -d "\r"))/.config/wezterm

12. Open WezTerm—it should start fish inside WSL and have $PATH properly set up
13. Start Neovim and install its plugins via :Lazy

GitHub Codespace

1. Make sure the devcontainer has SSH enabled and homebrew installed. For example:

   {
     "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
     "features": {
       "ghcr.io/devcontainers/features/sshd:1": {},
       "ghcr.io/meaningful-ooo/devcontainer-features/homebrew:2": {}
     }
   }

2. Create the codespace:

   gh codespace create --location 'WestEurope' --repo '...'

3. SSH into the codespace:

   gh codespace ssh -- -o IdentitiesOnly=yes

4. Clone the repo:

   git clone https://github.com/TymekDev/dotfiles ~/personal/dotfiles

5. Run:

   make --directory ~/personal/dotfiles setup-os-codespace

6. Start Neovim and install its plugins via :Lazy

Notable Commits in History

Starting with the oldest:

• Commit deleting unused configs: (b9d3554) chore: remove unused configs
• Commit removing home-manager: (2d5d745) refactor: purge home-manager and Nix
• Commit adding setup automation using make: (7ac8ddf) Merge branch 'make-magic'
• Commit switching from packer.nvim to lazy.nvim: (1ad9d73) Merge pull request #8 from TymekDev/lazy.nvim
• Commit replacing the make-based setup with a Brewfile: (fa64d51) refactor: use Brewfile
• Commit adding the NixOS configuration: (c844f53) Merge branch 'nixos'

Known Issues

• Karabiner does not really work for porting. Another Mac's keyboard has a different identifier?

License

Disclaimer: I am not an author of the image at local/share/wallpaper.webp and I do not claim any rights to it.

MIT License