My personal configuration files and helper scripts.
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.
Tim Weber a847d72738
Use mako for notifications in Sway
1 week ago
.composer Composer stuff (mostly ignoring things) 3 years ago
.config Use mako for notifications in Sway 1 week ago
.gnupg Start out with a rather basic GnuPG config 12 months ago
.local Remove fish config 1 year ago
.ssh SSH: known_hosts & host configs no longer public 5 months ago
.termux Termux: More virtual keys, in two columns now 1 year ago
.tmux tmux: Tidy up leftover sessions in the group 4 months ago
.vim Vim: Get rid of | characters in vertical separator 5 months ago
.weechat WeeChat: Remove freenode 1 week ago
bin Add `parsec` launch script 2 weeks ago
proj Update autoborg submodule 6 months ago
.CFUserTextEncoding Configure macOS to prefer English 3 years ago
.bash_logout Add Debian's default clear-screen .bash_logout 10 months ago
.bash_profile .bash_profile: Remove/fix some outdated comments 1 year ago
.bash_sessions_disable Disable El Capitan bash session restoration 3 years ago
.bashrc Define GPG_EXTRA_SOCKET environment variable 1 week ago
.gitconfig Git: New aliases rb, rbc, rbi 6 months ago
.gitignore Ignore .terraform.d/ 1 week ago
.gitmodules Vim: Add my relatifile plugin as a pack 5 months ago
.nanorc nano: don't hard-wrap my files 3 years ago
.profile Add a .profile stub 10 months ago
.tmux.conf tmux: Tidy up leftover sessions in the group 4 months ago
.tmux.nested.conf tmux: `set -g` in nested config 1 week ago Use mako for notifications in Sway 1 week ago
package-lock.json Install Bitwarden CLI 1 week ago
package.json Install Bitwarden CLI 1 week ago


Good Unix tools are configured by files written by the user, so-called dotfiles. Bad tools are configured by databases and GUIs. This repository tries to apply my preferred settings to both of them.

What's configured


This is currently replacing dotscy in order to have a fresh start. The old repo contained a lot of configs for tools that I no longer use, even fonts and binaries that I don't want anymore, but still had in the history.

These settings have been in use on macOS and Debian/Ubuntu (in WSL and standalone); they should run on other Unixes as well.

Setting up

Instead of symlinking lots of files into your home directory, this repository is supposed to be your home directory. This has the added benefit of you being aware (via git status) of new config files that some tool might generate.

The setup procedure will clone the repo into a subdir of your home, then moving everything in it (including .git) directly into your home dir. Files/directories that would be overwritten will be backed up to ~/.orig_home.


Install required (and my favorite) packages and setup storage access.

pkg install curl git neovim perl rsync termux-api &&

Then, continue as described below in the "Unix" section.

Ubuntu / Debian

Install required packages.

sudo apt update            &&
sudo apt install git rsync

These might also make sense:

sudo apt install scdaemon vim

On headless machines that are supposed to be used via SSH, it makes sense to forward the gpg-agent socket. However, a remote gpg-agent can interfere with that. If possible, allow SSH to overwrite Unix sockets specified in RemoteForward directives by adding the following line to the SSH server config:

StreamLocalBindUnlink yes

Alternatively, you can try to disable the remote gpg-agent by issuing (as the normal user):

systemctl --user mask --now gpg-agent.service gpg-agent{,-ssh,-extra,-browser}.socket

When I might be working on the machine primarily via the text-only console (e.g. on Raspberry Pis), styling that console might be a good thing, too. I prefer these settings in /etc/default/console-setup:


Also, to get my Sihaya color scheme in the console, I add these values to the kernel command line (/boot/cmdline.txt on a Pi):

vt.default_red=36,207,74,195,0,145,0,205,83,255,112,255,0,197,0,255 vt.default_grn=35,0,166,127,112,0,147,198,81,0,249,166,140,0,220,247 vt.default_blu=32,0,9,0,203,188,165,178,76,0,13,0,255,255,247,226

Then, continue as described below in the "Unix" section.


I'm currently using Fedora on my Linux laptop. Since I've started out with a minimal netinstall, I needed to install quite a few packages manually. Not all of them are strictly required for these dotfiles (you can probably get by with just git rsync), but for what it's worth, this is what I installed:

sudo dnf install acpi bemenu brightnessctl firefox gammastep git iw iwl7260-firmware NetworkManager-wifi net-tools pcsc-lite pinentry-qt rsync sway syncthing vim wpa_supplicant

Then, continue below at "Unix".


Install Git for Windows. Then, in a command prompt at your home directory, run

git clone --recurse-submodules

Afterwards, symlink VS Code's settings.json as described in it.


Make sure you have

options = fmask=0007,dmask=0007

in your /etc/wsl.conf. If you allow read/write for “others”, SSH will refuse to accept configs living on the Windows drive (which they do on my machine, because I’m syncing them on the host side). If you disallow execute, you won’t be able to call Windows commands from WSL.


which rsync > /dev/null                                              &&
umask 0022 && cd                                                     &&
test ! -e .orig_home                                                 &&
git clone --recurse-submodules &&
rsync -avb --backup-dir=.orig_home dotfiles/ .                       &&
rm -rf dotfiles

Hint: If you'd like to run these commands on a machine you can't copy/paste to, you can extract and run that section of the readme using this piece of sed magic:

curl -sL | sed -n '/^### Unix$/,/^```$/ { /```/d; p }' | sh

If you have installed a Syncthing package and would like to enable Syncthing for the scy user on boot, you might want to do something like:

sudo systemctl enable --now syncthing@scy

Manual configuration

Although I'm aiming to automate as much as possible with this repo, for some things it's currently too complicated, at least at the moment. Maybe I'll add automation scripts in the future, but right now it's not worth the effort.

On machines without HTTPS push to GitHub

On some machines, especially those without full disk encryption, I don’t want to store GitHub credentials directly on disk. Instead, I configure them to clone (anonymously) via HTTPS, but push via SSH:

git config -f ~/.gitconfig-local url.ssh://

On a Mac

  • Install Karabiner-Elements.
  • Change the keyboard layout to US English. Not US International, because this results in dead keys which massively disturb my programming flow.
  • In
    • on startup, new window with Pro
    • change default profile to Pro
    • in the Window tab of the profile, change the default size to 160x40
    • in the Shell tab of the profile, change the setting to close the window when the shell exits without error

On Windows

  • The default Windows console doesn't provide a visual bell, but the audible one is annoying. Therefore, mash Backspace in a bash for a few times to produce an audible bell. Then, right-click on the volume symbol in the task bar, choose "Open Volume Mixer" and mute "Console Window Host".
  • See settings.json for instructions on how to symlink the VS Code settings from this repo into %APPDATA%.
  • If you dual-boot with Linux, you may wish to ask Windows to set the system's real-time clock to UTC (instead of local time). To do that, run the following command in an admin shell: reg add "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation" /v RealTimeIsUniversal /d 1 /t REG_QWORD /f