dots/README.md

dots

My dotfiles.

Installation

Clone with submodules (this is necessary for Neovim plugins):

git clone --recurse-submodules https://github.com/dogeystamp/dots.git
# alternatively, after cloning:
git submodule init
git submodule update

Symlink all the files in src/ to your home directory using the provided dotinstall.sh script, or manually. Otherwise, copy them manually to your home directory.

After, install some packages. A list is provided in the programs file. This list encompasses all packages needed for a full system, including utilities and games. Feel free to pick and choose which packages you want. A script is also provided with programs-python to install Python packages via pipx. Package availability and their names differ based on the distribution: these are for Arch Linux and its derivatives.

For a full desktop experience, you should also build the programs in suckless/ by running ./compile-suckless.sh as root. Alternatively, build the programs with the README instructions in the directory.

Some features are enabled or disabled based on a "system profile": once the dotfiles are installed, see ~/.config/dot_profile.example for more information.

Notes

• .local/bin/keyboard.sh provides changes I like, such as swapping escape and caps lock, which you should remove if you don't need.

• My qutebrowser configuration emphasizes privacy over usability, and you might need to edit it to suit your needs if you want to use it.

• Neovim plugins are installed via git submodule rather than through conventional means. This has less complexity than a plugin manager since I already manage all my dotfiles under Git. Plugins are declared in .gitmodules.

• Submodules may take a lot of space (as of writing 0.5GB), so you may want to git submodule deinit -f some of them, manually pick the plugins you want, or even forgo all submodules.

Desktop Preview