dotfiles

kwm on river | river-classic | dwl | sway

My Arch Installation Guide is moved to codeberg/github

Usage

# Clone this repository on codeberg
git clone https://codeberg.org/unixchad/dotfiles
# Or on github
git clone https://github.com/gnuunixchad/dotfiles

# Create directories if needed to avoid dumping everything in dotfiles directory
mkdir -p ${HOME}/.local/{share,state}
mkdir -p ${HOME}/.{cache,config/"Code -OSS"}

# Create symlinks with GNU Stow
cd dotfiles
stow -t ~ . --adopt

# Optionally, run my post-install scripts AT YOUR OWN RISK
sudo ./install-root.sh
./install-user.sh

Note

A few software need manually setup:

• Software's config named to *.example for privacy reasons
• Software's config listed in ./.stow-local-ignore
• Software complied from source, e.g. my build of
  • kwm(codeberg/github)
  • river-classic(codeberg/github)
  • dam(codeberg/github)
  • dwl(codeberg/github).
  • dvtm(codeberg/github)

Software I Use

I prefer software that are free as in freedom, keyboard centric, terminal based, vim like, do one thing and do it well. And try to avoid proprietary garbage and spyware when I can.

scripting shell	dash
login shell	zsh
terminal multiplexer	abduco dvtm
terminal emulator	foot
audio server	pipewire
wayland compositor	river river-classic dwl sway
river window manager	kwm
river-classic bar	dam
status generator	damblocks(codeberg/github)
output management	wlr-randr kanshi
application launcher	wmenu
fuzzy finder	fzf
notification daemon	dunst
editor	neovim vim
email	neomutt isync
file manager	lf
music player	mpd ncmpcpp
video player	mpv
image viewer	swayimg
ebook reader	zathura
rss feeder	newsboat
calender & todo	calcurse taskwarrior
virtualization	qemu libvirt virtmanager
security	cryptsetup sbctl gpg firejail
browser	w3m qutebrowser
download	curl wget transmission-cli yt-dlp httrack
file sharing	rsync samba android-file-transfer qrtool
dotfiles manager	git stow
idle manager	swayidle
session lock	swaylock
clipboard	wl-clipboard cliphist
input method	fcitx5

My Personal Scripts

status bar	damblocks
weather report	wttr
screenshot	shoot
screen capture	capture
webcam	camera
voice recorder	record
brightness	bright
audio volume	audio
audio sink	speaker
bookmark	address
file previewer	rifle gpg-rifle url-rifle
file opener	scope
mounting	saddle phone
gpg	seal
mutt_oauth2	muttauth
shortcuts generator	teleport-genesis
qutebrowser	userscripts
xwayland-satellite	xwl
reload other scripts	reload

Chinese Video Channel

I have dedicated videos for almost every software I use:

unixchad at bilibili

Software I use to create videos:

screen capture	wf-recorder slurp
voice recording	pw-record noise-suppression-for-voice
video editing	ffmpeg mpv-cut kdenlive
screenshots	grim slurp
thumbnails	imagemagick gimp

All emails from me will be signed by the same GPG key that I sign commits with:

• Import my key: gpg --recv-keys 117094DA1AEA0835E4ED0770F7476912AA224CAC
• Download or copy at here
• Always encrypt your emails with my public key if you know how to.

License

I am the author of every file with the following disclaimer:

# @author nate zhou

I license them under the GNU GPL-3.0. There is no warranty, to the extend permitted by applicable law.

A few scripts or config files come from others, and a credit to the respective authors should be spotted.