No description
  • Shell 42.7%
  • QML 40.8%
  • Lua 6.4%
  • CSS 5.9%
  • Python 4.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-22 18:18:45 -04:00
alacritty Updated and Fixed 2026-10-21 03:49:39 +00:00
dolphin Updated Dolphin theme. 2026-10-22 18:18:45 -04:00
fingerprint fingerprint: add python-validity installer and PAM setup 2026-10-18 01:50:06 +00:00
hypr Updated Dolphin theme. 2026-10-22 18:18:45 -04:00
rofi Update Rofi config 2026-10-22 20:30:19 +00:00
sddm-theme Updat 2026-10-22 15:59:44 +00:00
waybar 12Hour format for clock 2026-10-22 17:59:39 -04:00
.luarc.json added SDDm theme 2026-10-21 07:49:42 +00:00
install.sh Updated Dolphin theme. 2026-10-22 18:18:45 -04:00
README.md Update 2026-10-22 15:59:50 +00:00

dotfiles

Config files for alacritty, hyprland, rofi, and waybar.

Quick install (one line)

curl -fsSL https://forgejo.hexium.cc/WilliamTheFatMan/dotfiles/raw/branch/main/install.sh | bash

Or clone and run:

git clone https://forgejo.hexium.cc/WilliamTheFatMan/dotfiles.git ~/Code/dotfiles
bash ~/Code/dotfiles/install.sh

What gets installed

  • Symlinks configs to ~/.config/alacritty/, ~/.config/hypr/, ~/.config/rofi/, ~/.config/waybar/
  • Makes all Waybar scripts executable
  • Installs common dependencies via pacman (Arch-based distros): alacritty, waybar, hyprland, rofi (launcher and session menu), ffmpeg, dunst, pavucontrol, blueman, btop, htop, pacman-contrib, jq, playerctl, brightnessctl, networkmanager, network-manager-applet, iw, iwd, plus wallfliper's stack — awww (wallpaper daemon), pyside6 and layer-shell-qt (the picker UI) and mpvpaper from the AUR (video wallpapers)
  • Enables and starts NetworkManager.service; Waybar's network indicator opens the connection editor, and the NetworkManager tray applet (under Waybar's tray expander) provides a menu for choosing available Wi-Fi networks
  • Press Super+B to toggle Waybar visibility
  • hypr/audio.sh drives volume / mic mute for the media keys, the ROG Azoth three-way control knob (rotate down, rotate up, press) and Waybar's click/scroll handlers — via pactl when PulseAudio is running, or wpctl under PipeWire
  • hypr/key-probe.sh shows what a keyboard's extra keys / volume dial send (keysyms via wev, raw scancodes with --raw via evtest), so new media keys can be added to hyprland.lua
  • Press Super+W to open Wallfliper, a minimalist keyboard-first wallpaper picker with live image and video previews; wallpapers are painted by awww (or mpvpaper for video) and the last selection is restored on the next Hyprland startup via wallfliper --restore. Wallfliper itself is cloned to ~/Code/wallfliper with a launcher at /usr/local/bin/wallfliper, and themed to the Tokyo Night palette of Waybar and Hyprland via hypr/wallfliper/Theme.qml (re-applied over the clone on every install)
  • Downloads the Wallpaper-Bank images (~900 MB) into ~/Pictures/wallpapers/ for the picker, printing progress as it goes; set SKIP_WALLPAPERS=1 to skip this download
  • Installs the Tokyo Night Custom SDDM login theme and keeps its background in sync with the desktop wallpaper — see below
  • Optionally sets up the fingerprint reader — see below; run with INSTALL_FINGERPRINT=1 to include it

Installer improvements

The installer now provides enhanced progress feedback:

  • ETA display - Shows estimated time remaining for each step
  • Timer spinners - Displays elapsed time while long commands run
  • Command durations - Shows how long each command took to complete
  • Download progress - Large file downloads show percentage and elapsed time
  • Enhanced summary - Final report includes step completion count

Fingerprint reader

ThinkPad swipe sensors (Validity/Synaptics 138a:0097 on the X1 Carbon 5th gen, 138a:0090, and friends) are not supported by stock libfprint. python-validity drives them instead: it speaks the reader's own protocol and the fingerprint matching happens on the chip.

The main installer skips this by default (it builds AUR packages and then asks you to swipe a finger), so run it on its own:

bash ~/Code/dotfiles/fingerprint/install.sh
# or, as part of the main install:
INSTALL_FINGERPRINT=1 bash ~/Code/dotfiles/install.sh

It will:

  1. install python-validity (plus open-fprintd and the fprintd clients) from the AUR, building yay first if no AUR helper is present
  2. enable python3-validity.service (and the suspend/hibernate hotfix) and mask the stock fprintd.service, which would otherwise fight over the USB device
  3. clean the sensor's own fingerprint database — see below
  4. enrol a finger
  5. add pam_fprintd.so to /etc/pam.d/sudo, the display manager and console login, keeping the original files as <name>.bak-fprint
  6. verify a scan

Tunable with environment variables: FINGER (default right-index-finger), SKIP_ENROLL=1, SKIP_PAM=1, CLEAN_WINDOWS=1|0|prompt, NO_COLOR=1.

"Enrolment works but every scan says no-match"

These sensors keep their template database on the device, keyed by Windows SIDs. On a machine that once ran Windows (or was resold), that old enrolment is still in the chip. python-validity maps Linux users to a synthetic SID, so when you swipe the chip can match the old record — the daemon compares it with your Linux record, they differ, and the scan is reported as verify-no-match even though enrolment succeeded.

fingerprint/clean-sensor-db.py lists what the sensor holds and removes non-Linux records:

python3 ~/Code/dotfiles/fingerprint/clean-sensor-db.py
python3 ~/Code/dotfiles/fingerprint/clean-sensor-db.py --delete-windows

The installer runs this automatically (asking first).

Rolling back

Restore the PAM files from their backups, e.g. sudo cp /etc/pam.d/sudo.bak-fprint /etc/pam.d/sudo, then remove the driver: sudo pacman -Rns python-validity open-fprintd fprintd-clients-git.

Theming rofi

rofi is the launcher (Super+D), the window switcher and the session menu behind Waybar's battery icon (and on Super+M).

rofi/config.rasi holds the whole theme — colours, the search box, row selection, borders — in one file. It is symlinked to the path rofi reads by default (~/.config/rofi/config.rasi), so edits take effect the next time the launcher opens; no reload step needed.

The palette is Tokyo Night, shared with Waybar and Hyprland:

token hex used for
base #1a1b26 window background
recessed #16161e search box
selected #292e42 highlighted row
text #c0caf5 labels
highlight #7dcfff selected label
accent #7aa2f7 window border, prompt
dim #565f89 placeholders, counters

rofi 2.0 themes are flat — every widget the default theme paints is overridden explicitly, including the nine element <mode>.<state> combinations (normal/selected/active/urgent × normal/alternate rows). Anything left alone keeps rofi's stock solarised palette, so the theme is deliberately exhaustive.

To retheme, edit the tokyo-* variables in the * block at the top; every widget refers to them by var(name).

SDDM login theme

The Tokyo Night Custom SDDM theme lives in sddm-theme/ and is installed to /usr/share/sddm/themes/tokyo-night-custom — the only place SDDM reads themes from, so a copy under ~/.local/share is ignored by the greeter.

bash ~/Code/dotfiles/sddm-theme/install.sh
# or, as part of the main install:
bash ~/Code/dotfiles/install.sh

It writes a drop-in to /etc/sddm.conf.d/ (leaving /etc/sddm.conf alone), keeps the login background in step with the desktop wallpaper, and declares QtVersion=5 because SDDM 0.21+ would otherwise launch the Qt6 greeter, which cannot load this theme's Qt5 QML. See sddm-theme/README.md for the details.

Notes

  • The installer sets DOTFILES_REPO env var if you want to override.
  • SKIP_WALLPAPERS=1 bash install.sh skips the ~900 MB Wallpaper-Bank download (the picker still works with your own images in ~/Pictures/wallpapers/).
  • On non-Arch distros, you'll need to install packages manually; symlinking still works.