- Shell 42.7%
- QML 40.8%
- Lua 6.4%
- CSS 5.9%
- Python 4.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| alacritty | ||
| dolphin | ||
| fingerprint | ||
| hypr | ||
| rofi | ||
| sddm-theme | ||
| waybar | ||
| .luarc.json | ||
| install.sh | ||
| README.md | ||
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+Bto toggle Waybar visibility hypr/audio.shdrives 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 — viapactlwhen PulseAudio is running, orwpctlunder PipeWirehypr/key-probe.shshows what a keyboard's extra keys / volume dial send (keysyms viawev, raw scancodes with--rawviaevtest), so new media keys can be added tohyprland.lua- Press
Super+Wto 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 viawallfliper --restore. Wallfliper itself is cloned to~/Code/wallfliperwith a launcher at/usr/local/bin/wallfliper, and themed to the Tokyo Night palette of Waybar and Hyprland viahypr/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; setSKIP_WALLPAPERS=1to 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=1to 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:
- install
python-validity(plusopen-fprintdand the fprintd clients) from the AUR, buildingyayfirst if no AUR helper is present - enable
python3-validity.service(and the suspend/hibernate hotfix) and mask the stockfprintd.service, which would otherwise fight over the USB device - clean the sensor's own fingerprint database — see below
- enrol a finger
- add
pam_fprintd.soto/etc/pam.d/sudo, the display manager and console login, keeping the original files as<name>.bak-fprint - 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_REPOenv var if you want to override. SKIP_WALLPAPERS=1 bash install.shskips 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.