Personal dotfiles + UI setup for my Surface Laptop 4 (AMD) running Hyprland. Also, please check out my calendar app: Evercal

• Dependencies
• Hyprland
• Shaders
• Quickshell Bar
• Quickshell Hub (snes-hub)
• Power menu
• Wifi menu
• Pixel sddm theme
• Firefox custom new-tab
• Surface-only features
• Credits & acknowledgements
• Media sources

SDDM: Lock Screen & Login Screen (hyprlock also looks just like this + with media information if playing when locked)

Dark Mode & Light Mode (Hub + Rofi)

Reading mode & Various other apps

Main config is for Hyprland v0.53: ~/.config/hypr/hyprland.conf Old Config at ~/.config/hypr/hyprland_OLD.conf

All shaders located at ~/.config/hypr/shaders/ and use hyprshade

activate with: hyprshade on <shader_name.glsl> deactivate with: hyprshade off

A shader-based reading mode to mimic an e-ink reader.

• Toggle with SUPER + D or ~/.config/hypr/shaders/reading_mode.sh
• Automatically disables animations, shadows, and blur
• Custom GLSL shader with e-ink-like color reproduction
• Warm cream paper tone and soft charcoal blacks for reduced contrast
• Fine paper grain -like texture

Ranked from Useful to completely Useless:

1. main.glsl – my main shader to improve my display (I run it at startup)
2. night.glsl – my main night-light mode shader (script coming soon)
3. outdoor.gls – for maximum outdoor useability
4. cinema.glsl – for media consumption
5. soft.glsl – soft, muted textures
6. matte.glsl – anti-glare, matte
7. IMB5151.glsl – simulates vintage IBM 3278 / 5151 monitors
8. fuji_acros.glsl – simulates fujifilm acros
9. crt_mode.glsl – simulates a crt monitor/retro nostalgia
10. vhs.glsl – simulates vhs
11. gameboy.glsl – simulates a gameboy screen
12. clarity_inefficient.glsl – an early version of my main shader
13. focus.glsl – party trick
14. night_vision.glsl – simulates night_vision

The bar uses an Arch glyph icon (top left) as the launcher button:

• Left click: launches rofi, choosing a different launcher script depending on the current theme mode.
• Right click: toggles the bar’s isDarkMode and calls a theme script:

bash ~/config/quickshell/snes-hub/bar/theme-mode.sh dark|light

if [ -e /var/lib/pacman/db.lck ]; then
  cat /tmp/qs_updates_count 2>/dev/null || echo 0
else
  checkupdates 2>/dev/null | wc -l | tee /tmp/qs_updates_count
fi

kitty -e bash -lc "sudo pacman -Syu"

• Toggled by clicking the date/clock module in the bar or SUPER+SPACE keybinding through hyprland
• The hub window is an overlay (wlr-layershell) and is designed to get out of your way quickly:
• Organized into reusable components, making it straightforward to add/remove cards or re-skin pieces without rewriting the whole hub.
• If you want a lightweight fallback, use the early AGS version in .config/ags/ (works, but fewer features).

Components (click to expand)

Header

• Profile icon,username + RAM/CPU usage chips.
• Screenshot button (runs the capture script and then closes the hub).
• Power button

Power options

• Compact power grid that expands (click the power button or press p key) inside the header (no extra window):
• Keyboard navigation: Arrow keys / Tab to move, Enter to trigger, Esc to close.

Buttons and Sliders

• Wi‑Fi toggle + SSID readout (right‑click opens wifi module).
• Bluetooth toggle + connected device status.
• Performance profile button (cycle modes via auto-cpufreq, right click toggles battery health card).
• DND toggle (dunst).
• Volume + brightness sliders (pactl + brightnessctl).

Battery health

• Polls: upower -i /org/freedesktop/UPower/devices/battery_BAT1
• Shows: Health (capacity %) + current charge %, Charge cycles, Energy (full / design), Time remaining (to full/empty when available), State (charging/discharging/fully-charged)

[!NOTE] If your battery isn’t battery_BAT1, swap the device path in BatteryHealthCard.qml to match your system.s

Media card (MPRIS)

• The hub includes an MPRIS-powered media card:
• Clicking the media card launches the external now-playing widget and then toggles the hub off.
• It tracks metadata changes and resets its internal timing state when tracks change. It's still finicky with some browser contents like youtube videos
• Only appears when something is playing

Now Playing (Flutter)

• This is a separate Flutter desktop widget (class rules are handled in Hyprland).
• Resizable is disabled (setResizable(false) is used)
• Esc closes the widget
• Generates theme colors from album art using palette_generator

Calendar, Weather and Events

A simple calendar with weather (json based script and events from my google calendar using khal+ vdirsyncer.

Google Calendar sync (vdirsyncer + khal)

Recommended approach (avoids system Python packaging issues):

sudo pacman -S --needed python-pipx

pipx install "vdirsyncer[google]"

• If you have both a system and pipx vdirsyncer, remove the system one and make sure PATH prefers ~/.local/bin.

Config

Create folders:

mkdir -p ~/.config/vdirsyncer/status ~/.config/vdirsyncer/tokens
mkdir -p ~/.local/share/vdirsyncer/calendars

Example vdirsyncer config uses: token_file = "~/.config/vdirsyncer/tokens/google_calendar" type = "google_calendar" client_id / client_secret from Google Cloud OAuth ~/.local/share/vdirsyncer/calendars/* - Khal reads .ics files from here

Note:

• You must enable CalDAV API in Google Cloud (not only the “Google Calendar API”).
• If OAuth consent is in Testing mode, add yourself as a “Test user”.
• If you get “token obtained but Not Found”, enable calendars at: https://calendar.google.com/calendar/syncselect

Run + test

vdirsyncer discover
vdirsyncer sync
khal list now 7d

Notifications

• Clicking dismisses.
• Uses dunst (dunstctl) as the notification backend.
• Contracted by default when the media player card is active, but can be expanded via the expand button.

OSDs

• custom OSDs for brightness and volume controls
• custom OSD for various modes (Dark/Light/Reading Mode etc.)

[!NOTE] You may need to update the scripts in .config/hypr/scripts. Please review the contents of audiocontrol.sh and brightnesscontrol.sh. Newer versions of these scripts write cache for osd qmls to read

wlr-layershell power menu overlay (separate from the hub header menu). Toggled with ALT+F4 Run

quickshell -p ~/.config/quickshell/snes-hub/bar/PowerMenu.qml

Standalone network manager applet located at lib/WifiMenu.qml. With both (light/dark) theme.

• Trigger: Right-click the Wi-Fi button in the Hub.
• or run: quickshell -p ~/.config/quickshell/snes-hub/lib/Wifimenu.qml

[Note: I am using qt5, please install qt5 dependencies]

sudo pacman -S qt6-5compat qt6-svg qqc2-desktop-style inter-font ttf-nerd-fonts-symbols

if you don't want windows hello like animation please use main.qml from the old directory

• To install:

  • move the contents of sddm/theme folder to /usr/share/sddm/themes/ (create the dir if it doesn't exist yet)
  • Set "pixel" as the current theme by creating a config file in /etc/sddm.conf.d/:
  • make sure the directory exists:

  sudo mkdir -p /etc/sddm.conf.d

  • then create the config file:

  echo -e "[Theme]\nCurrent=pixel" | sudo tee /etc/sddm.conf.d/theme.conf

• Custom Firefox start page: https://github.com/snes19xx/custom-firefox-start
• usercss (Also in this repo): https://github.com/snes19xx/firefox-customizations

Firefox doesn't really want you to use local html as a new tab page so

• Move autoconfig.js to Firefox defaults/pref/ (e.g. /usr/lib/firefox/defaults/pref/)
• Edit mozilla.cfg (repo path: .config/firefox/mozilla.cfg) and set your file path
• Move mozilla.cfg to the Firefox install directory root (e.g. /usr/lib/firefox/)

• Everforest-GTK-Theme by Fausto-Korpsvart
• Rofi themes loosely based on @adi1090x's type 7
• Pixeldots.qml in sddm theme based on @mahaveergurjar's Pixeldots
• Colors: Modified from https://github.com/sainnhe/everforest
• SVG icons: https://www.svgrepo.com/
• linux-surface project: https://github.com/linux-surface/linux-surface
• Thorium: https://thorium.rocks/ for the background visualizations in firefox custom new tab

1. Photo by fffunction studio on Unsplash
2. Photo by Brian McGowan on Unsplash
3. Photo by Mimicry Hu on Unsplash
4. Photo by Bailey Zindel on Unsplash
5. Photo by on Jay Yu on Unsplash
6. Photo by Ben Dutton on Unsplash
7. Photo by Richard Rhee on Flickr
8. Photo by Cedric Chambaz on Flickr

[OC]

• Lucina wallpaper from Fire Emblem Awekening Artbook

• Final Fantasy X logo: by Yoshitaka Amano

• Most Monogatari wallpapers are edited from the scans of Monogatari Series 10th Anniversary Illustration Works Art Book

• crab2,hanekawa3 and crab2.png are form AhogeDesu

• All Rofi pictures were pulled from Pinterest; I don’t know the original owners.

Feel free to copy/steal whatever you want as long as you cite me and more importantly the listed media sources in the credits/references where applicable.