(LEGACY) Configuration files for the software I use.
Fix obsolete directory name
Bring documentation up to date
Remove defunct setup script


browse  log 



You can also use your local clone with git send-email.


Warning, this repository contains dotfiles that I used to use. I'm keeping it around in case people want to see how I configured software that I don't use anymore like bspwm or neomutt.

If you notice something extremely broken, please let me know by email. As I am no longer maintaining this repository, I don't care about slight mistakes; it is as it is.

#Personal Dotfiles

This is a repository of my personal dotfiles and system scripts.

In my .profile and .bashrc, you can see an effort to make as many programs respect the XDG base directory specification as possible. For some programs it is just impossible or impractical to get them to respect it (such as ssh and firefox despite my best efforts) but since most of these programs are older than the XDG base specification, and it is only a few programs, it isn't a big deal and I just accept it.

#Setting Up a System


sudo apt install alsa-utils apt-listbugs apt-listchanges arc-theme audacity \
biber breeze-cursor-theme bspwm build-essential cmake colortest compton curl \
dialog dunst earlyoom farbfeld feh ffmpeg firefox-esr fonts-font-awesome \
fonts-noto galculator gdb gimp git git-email gpg htop isync keepassxc latexmk \
libnotify-bin libreoffice-gtk3 lm-sensors lxappearance lxpolkit lynx mpc mpd \
mpv ncdu ncmpcpp needrestart neofetch neovim network-manager newsboat nftables \
nmap pandoc papirus-icon-theme pavucontrol plymouth plymouth-themes pulseaudio \
qt5-style-plugins rofi rsync scrot sent smartmontools suckless-tools sxiv \
tcpdump texlive texlive-bibtex-extra texlive-fonts-extra tmux udisks2 \
unattended-upgrades valgrind virt-manager weechat wireshark xautolock xorg \
sudo apt --purge autoremove nano vim.tiny

#Laptop only

sudo apt install acpi tlp xbacklight network-manager-gnome blueman powertop \
fprintd libpam-fprintd brightnessctl

Run powertop after installing.

#Compiled From Source

Clone the relevant repository from GitHub. Follow the instructions in the relevant project's README file/wiki. Preferably download a release version of the software or build against a release tag rather than master.

  • vis — Audio visualizer

    git clone https://github.com/dpayne/cli-visualizer
  • polybar — Status bar

    git clone https://github.com/polybar/polybar.git
  • betterlockscreen — A better-looking lock screen than plain i3lock

    Get and build i3lock-color first:

    git clone https://github.com/PandorasFox/i3lock-color

    Get the betterlockscreen script:

    git clone https://github.com/pavanjadhaw/betterlockscreen.git

    Copy the script contained in the repository to somewhere in $PATH and run betterlockscreen -u <img> to create the lock screen image.

  • aerc - Email client

    git clone https://git.sr.ht/~sircmpwn/aerc


#Basic System Setup

#Create the home directory structure

mkdir archive/ proj/ docs/ docs/saved-articles media/ media/pics \
media/pics/wallpapers media/videos media/audio scripts scripts/sh scripts/bash \
scripts/perl temp/ .local/bin .local/iso

#Basic tasks

Copy all configuration/dotfiles (nftables.conf, .config/*, .bashrc, .profile, etc) onto the new system.

Add auth sufficient pam_fprintd.so to /etc/pam.d/sudo.

Run sudo update-alternatives config --editor to change the default text editor.

Run xdg-settings set default-web-browser to change the default browser.

#Sudo permissions

Add the line:

<username> ALL=NOPASSWD: /sbin/poweroff, /sbin/reboot, /home/jbauer/scripts/sh/update-notify.sh

To allow powering off and rebooting from the button in polybar and to allow the package notification script to be run.

#Grub and Plymouth

Change /etc/initramfs-tools/modules and add:

<device> modeset=1

Where <device> is one of i915, nouveau, or radeon depending on if you are using Intel, nVidia, or ATI (AMD) graphics respectively.

Then edit /etc/default/grub and uncomment the line GRUB_GFXMODE=640x480 and change the resolution to the resolution of your monitor(s). Also change the value of the line GRUB_CMDLINE_LINUX_DEFAULT to include the word splash.

To set the Plymouth theme, first run the command sudo plymouth-set-default-theme -l to list the possible theme options. Then use the command sudo plymouth-set-default-theme -R <theme_name> to set the theme.

(Optionally add backgournd picture to grub)

Then run sudo update-grub.

#Finishing Up

(Optional) Install debfoster and run it to remove packages that were needed for building software and are no longer needed. Re-test that software to see if there was still a dependency and re-install dependencies as needed.


  • When adding windows to bspwmrc, use xprop WM_CLASS and look at the second string to get the class of the open window to add to the bspwmrc file.

  • Use lxappearance to theme GTK apps and set font/icon themes. This can be uninstalled after.