dots

March 17, 2026 · View on GitHub

Dotfiles managed by chezmoi, pass and reaver. Only works on some Linux distro including:

Archlinux
Debian, ... frozen from now, i don't recommend install my dotfiles on it, need motivation and time here...
Gentoo, tested with systemd, musl (openrc) and/or binaries.
Void Linux, tested on a clean install of the rootfs-glibc and rootfs-musl.

If you need more GNU/Linux distro, you can contribute by making PR on the master branch.

Why i use chezmoi?

Even with GNU/Stow, i have to modify a lot of files each time i install/reinstall a new system, i start hating this !
Template are great.
Possibility of encrypt files.
Install and updates are easy.

Screenshots

Valyria (SwayFX)	Focus (Awesome)

Cat	Name	Notes
Audio Driver	Alsa or Pulseaudio	Can be change in the config file
Window Manager	Swayfx or Awesome	Wayland or Xorg
Web browser	brave or librewolf
Image Viewer	imv or feh	Depend of Wayland or Xorg
Lock Screen	swaylock fancy or betterlockscreen
Music Daemon	Playerctl, MPD	Playerctl only on Sway
Video Player	mpv
Email reader	neomutt	with isync, customized from sheoak
Screen capture	grim or maim	Wayland or Xorg
Terminal multiplexer	tmux	with catppucin, mode indicator
File Manager	Yazi and Thunar
Code Editor	Neovim or Doom Emacs	Wayland or Xorg, doom don't work on wayland unless you install Xwayland
IRC client		Weechat will be dropped soon, Prefer Signal or better Session, not IRC
Terminal	Kitty or xSt	Wayland or Xorg again
PDF/Epub viewer	Zathura
Shell	ZSH	With ohmyzsh, starship, autosuggestion, and more...

If need a new user (new system), create one:

useradd -m -s /bin/bash custom-username
passwd custom-username

Next, you need to install and configure sudo or doas, we need permission to install packages:

# EDITOR=vi visudo
custom-username ALL=(ALL) ALL

You need to install chezmoi and git.

With Gentoo:

# emerge -av dev-vcs/git
$ curl -fsLS get.chezmoi.io | sh

With Arch:

# pacman -S chezmoi git vi

With Debian:

# apt-get install curl git
$ curl -fsLS get.chezmoi.io | sh

For Voidlinux:

# xbps-install -S chezmoi git

Only 4 little steps here

$ chezmoi init https://github.com/szorfein/dots.git

To test the ansible branch, (also look the branch for additionnal instructions)

$ chezmoi init https://github.com/szorfein/dots.git --branch=ansible

Edit the config file with your favorite text editor.

$ EDITOR=vim chezmoi edit-config

You can change for example in [data]:

[data]
  web = "brave"
  wm = "swayfx"

It will install Brave instead of Librewolf and SwayFX with the last theme instead of Awesome.

apply will install all the dependencies and add files to your $HOME.

$ chezmoi apply

If /tmp is protected with noexec, you need to tell chezmoi to use another dir #1929

$ mkdir $HOME/tmp
$ TMPDIR=$HOME/tmp chezmoi apply

From time to time, start the update simply with:

$ chezmoi diff
$ chezmoi update

After the first install, if you need-want to use doomemacs, you have to finish the installation with a single command:

$ doom sync

If you have not yet configure X, change the keyboard layout like this:

$ localectl list-x11-keymap-layouts | grep fr
$ sudo localectl set-x11-keymap fr