~/.dotfiles

This is my personal collection of configuration files. The setup section will guide you through the installation process.

Built With

Thanks for dropping by

Here are some details about my setup:

• Operating System: Debian 12 ("bookworm")
• Display Server: Xorg
• Notification Server dunst
• Window Manager: dwm
• Status Bar: slstatus
• Program Launcher: rofi
• Terminal: st
• File Manager: Thunar
• Shell: zsh
• Editor: Neovim
• Browser: Vivaldi
• Color Scheme: gruvbox
• Font: FiraCode Nerd Font (cheatsheet)

Getting Started

Prerequisites

Before attempting to build this project, make sure you have git installed on your machine. Additionally, you need to have NixOS booted up (either live or installed) or Nix and Home Manager installed on your existing distro (even on Darwin).

Installation

Warning

You can clone my dotfiles wherever you want, but some configurations expect it to be in ~/Documents/GitHub/dotfiles. Change at your own risk.

To get a local copy of my dotfiles up and running on your machine, follow these simple steps:

1. Opt into the experimental flakes and nix-command features

   nix --version # should be Nix 2.4 or higher
   export NIX_CONFIG="experimental-features = nix-command flakes"

2. Initialize the flake

   nix flake init -t github:kaweees/dotfiles ~/Documents/GitHub/dotfiles
   cd ~/Documents/GitHub/dotfiles

3. Generate your own hardware-configuration.nix file and apply them to the configuration.

   nixos-generate-config --root /mnt/nixos
   cp /mnt/nixos/etc/nixos/hardware-configuration.nix ./nixos/hardware-configuration.nix

4. Update the flake inputs

   nix flake update

5. Apply the system configurations

   • If you are on an installed system

     sudo nixos-rebuild switch --flake --no-root-passwd .#default

   • If you are on a live installation medium

     nixos-install --flake --no-root-passwd .#default  && reboot

6. Change the password for the user

   passwd <username>

Project Structure

. dotfiles/
├── .config -> ~/.config           - configuration files for various services
├── .local -> ~/.local             - local data files for various services
├── .scripts -> ~/.scripts         - scripts available to the user at runtime
└── README.md                      - you are here

License

The source code for my dotfiles is distributed under the terms of the GNU General Public License v3.0, as I firmly believe that collaborating on free and open-source software fosters innovations that mutually and equitably beneficial to both collaborators and users alike. See LICENSE for details and more information.