Dotfiles equivalent
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nero a0fafe53dd install: rework, use relative paths for symlink targets 22 hours ago
bin view: POSIX doesnt allow == 1 month ago
env.d get back to split profile and env, shared has too many edge cases 3 months ago
feh feh: set output-dir to $HOME 10 months ago
git choice: Fix options being printed to stdout instead of tty 2 months ago
i3 i3: increase contrast of selected window button 3 months ago
mpv mpv: maximum of 480p during streaming, my eyes arent that good anyways 22 hours ago
nano nano: syntax hilighting for env file 3 months ago
screen add screenrc 1 year ago
terminfo Format human-readable 2 years ago
tmux tmux: show client TERM and size in bar 2 months ago
.gitignore Track customized htop config 2 years ago Replace both profile and shellrc with an generalized envfile 3 months ago
Xresources Revert mistakenly commited font size back to 12 4 months ago
env get back to split profile and env, shared has too many edge cases 3 months ago
install install: rework, use relative paths for symlink targets 22 hours ago
nobackup.txt Add new rule to except histories from backup 8 months ago
profile profile: fix outdated comment 1 month ago
xinitrc Condense xinitrc back into one file 4 months ago

Personal dotconfig

This repository is for synchronizing my shell and i3 settings across machines. The checkout location is $XDG_CONFIG_HOME, which is usually equal to $HOME/.config. The env file is used both as .profile and rc file for interactive shells.

For xinit, a ~/.xinitrc symlink needs to be created to point to xinitrc. For tmux, the same needs to be done with tmux.conf. There is an install script in the root of this project to set up these symlinks automatically.


  • Quick setup on new machines
  • Portable across bourne-like shells
  • Portable between terminal emulators
  • Consistent DE behavior across machines
  • Informative, but short prompt

Environment variable made available

  • USER
  • HOME
  • XDG_CONFIG_HOME: Points to the checkout location of this repository. The profile detects this by following the ~/.profile symlink if not present.
  • XDG_RUNTIME_DIR: Location for sockets, fifo's and pid files.
  • ENV: Location of the rc file for interactive POSIX shells.

Per-machine overrides

Machine-specific fixes are placed in env.d/.

Use in shell scripts

Shell scripts started from background daemons like cron or init won't have the environment variables resulting from the login process and profile. Appending -l to the end of their shebang line will cause the executing shell to undergo this process and, in turn, also load the settings from env.

Xorg sessions

Depending on the setup, i either create .xinitrc as a symlink to .config/xinitrc, or create a custom .xsession file. xsession implements whatever is necessary to load my environment and chains to xinitrc.

xinitrc does alot of things:

  • apply monitor configuration as saved by arandr
  • load xresources from the repo
  • set keyboard layout + xmodmap fixes
  • fill background with a pixel lattice
  • start i3 or fall back to xfce or plain terminal emulator

The i3 setup shows o spaces and no window decorations. All windows are maximized, a single row on top of the screen displays the window titles in a browser-like tabbed fashion.

Most of my activity happens in xterm, but depending on the setup, i might use other emulators as well.


I use mosh or plain ssh to connect to the machine which is hosting irssi in a tmux session. Notifications happen via the terminal bell, which propagates from irssi up to my window manager and causes the terminal title to turn to a bright color.

I select links with the mouse curser and use a keyboard shortcut to feed them into xdg-open. xdg-open is a script from the repo. The name was intentionally chosen to override the systems default handler with the same name.

xdg-open runs the view script in a new terminal window / tmux pane. view itself contains complex logic to display the contents of the url to me, usually via feh, mpv or by chaining to firefox. This includes displaying files of unknown type via hexdump, or showing text files via less. It also degrades nicely in functionality when there is no Xorg available.

Saving memes

There is the save command, which is a wrapper around wget. Its job is to generate a useful filename and extension for the download. The downloaded files end up directly in my home directory, where they are later archived from.


My homedir and Downloads folder has a constant influx of memes, datasheet PDFs and compressed archives. To avoid them piling up, i occasionally run the archive script to move them into ~/archive/$YEAR/$MONTH. This cleans all non-hidden files that are directly in ~/$HOME. For directories, i need to explicitly call archive on them.


There is a do-backup script which does a rsync of $HOME to a storage machine. It uses a long ignore list from .config/nobackup.txt to avoid caches, sensitive data and trash. The destination directory is host specific with delete propagation. This means when i delete a file locally, it is also deleted from the backup on the next do-backup run.

The archive directory special: it is backupped to a directory shared for all machines, files from there are never deleted. This is my "data dump" that i go digging in when im looking for things from earlier times.