Awesome Open Source
Awesome Open Source


My personal dotfiles, managed with GNU stow and used in Archlinux

Sway screenshot

To install

I have concocted 2 scripts to ease the installation of arch, to help me reinstall if I ever need to, with my personal preferences

A (Non comprehensive) list of them are:

  • EFI
  • ucode
  • systemd-boot (option to install grub)
  • GPT
  • btrfs (option to format as ext4)
  • systemd-networkd
  • reflector (with weekly timer)
  • iwd (if wireless)
  • pipewire
  • doas (instead of sudo)
  • sway (option for i3)
  • neovim

To install just boot into a clean arch iso, install git and

git clone

cd dotfiles/installation ; zsh archbase.zsh

follow the prompts and then after chroot

cd ~/dotfiles/installation ; zsh archroot.zsh

up to these point you will have a running arch install with everything I use, to automatically spread dotfiles, configure git, nvim, zsh and install user systemd services, a python virtualenv for running some commands, the gtk theme and fonts do

su <username>

cd ~/.dotfiles/installation/ ; zsh archuser.zsh

Notes and comments

The archroot.zsh installation script will append ~/.local/bin to your PATH

Rather than an installer this is a helper to avoid all the repetitive commands that have to be run and boilerplating that has to be done for LANG, hosts, useradd, etc. and to avoid forgetting any important step.

I know of archinstall and maybe someday I'll redo my script with it's library but doing it this way was more fun.

Fonts and theme

To download fonts run the following command and stow local

git submodule init

To download and set the gtk theme

zsh .gtk/install.zsh



Run this command to use my git hooks

git config --local core.hooksPath git/githooks


Btrfs is my preferred filesystem for / , /home and /shared* because of the snapshot capabilities and it's capabilities for SSD. As I have a way to easilly and quickly reinstall my base system I only backup my /home to /shared daily when system is idle.

If you wanna use this modify system/backup/ and change $BCKPFOLDER to your backup directory, copy the same file to /usr/bin, copy system/backup/btrfs-backup.service and system/backup/btrfs-backup.timer to /etc/systemd/system and then run:

# systemctl enable --now btrfs-backup.timer
* /shared usually is an HDD mounted to store big files, share with other SO if I'm dual booting and to store backups.


I usually use 60% programmable mechanical keyboards as my daily drivers, so I'm used to key combinations and layers, but this is not always possible, specially when on the go with a laptop, so I use keyd to address this, I found it to be a simple yet powerful tool to be able to change how a non-programmable keybord works under linux. My config is located in system/keyd/AT Translated Set 2 keyboard.cfg but the name of your keyboard may vary. I set the following changes to my keyboard:

  • CAPS on hold is CTRL and on tap is ESC
  • L_Alt key maps to L_Super
  • L_Super key maps to L_ALT
  • R_Alt on hold is second layer and on tap it is Menu (because thinkpad)

Second layer:

key mapping key mapping
h left z kp1
j down x kp2
k up c kp3
l right a kp4
esc numlock s kp5
leftmeta kpdot d kp6
space kpenter q kp7
1 kpplus w kp8
2 kpminus e kp9
3 kpasterisk leftalt kp0
4 kpequal

After installing keyd (manually compiled or from the AUR) and copying the config file to the proper directory just enable keyd.service

# systemctl enable --now keyd.service


Sway version packages

Can be found at:


AUR and non-repo software

  • nq
  • wob
  • cava
  • mpv-mpris
  • kmscon-patched-git, libtsm-patched-git
  • keyd
  • xxd-standalone
  • ripmime
  • imapfilter
  • mail-query


  • Configure keybindings for better notifications control (dunst and mako)

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (229,298
Config (24,030
Dotfiles (6,732
Neovim (2,587
Tmux (1,620
I3 (681
Polybar (432
Rofi (402
Sway (211
Related Projects