Skip to content

Changelogs

Donald Williams edited this page Jun 7, 2026 · 362 revisions

Linux Beginning Hyprland Dotfiles CHANGES

📅 Updated: Jun 7th, 2026

v2.3.24

Fixed:

  • awww default didn't work for wide screen monitors
    • Default is to resize --crop
    • Made wallpaper scripts monitor determinsitic
      • Just overriding default won't work for non ultrawide screens
      • Also add UserConfig override variabe to force default if needed
    • Thanks to CateDesu for finding issue & correct parameters
    • Found some corner cases and fixed them
  • After LUA migration
    • Logout issues:
      • logout stopped working
      • Long delay 20s+ for logout when using SDDM
    • Duplicate keybinds
    • layout persistance code failed
  • cava colors reloaded dynamically with wallpaper change
  • Updated initial-boot.sh to set prefer-dark
    • This will set flatpak apps to dark
    • PortalHyprland now also has the ubuntu portal code
  • Added script scripts/DisableWaybarService.sh
    • Some OS's / distros add a waybar.service to manage waybar
    • This breaks theming and waybar restarts
  • scripts/lib_copy.sh wasn't preserving UserConfigs dir
  • Bad import path in .config/waybar/style/ML4W/glass.css file
  • Migration script didn't properly create the system_settings.lua file
  • Logout is NixOS.
    • Added fallback if hyprshutdown not installed or fails
    • Fixed pathing issues where not all logout options usedLogout.sh
  • Removed sleep statments from startup to trim login time
  • Network icon on waybar invisible
    • Changed the CSS files it's better but should revisit it
  • NixOS waybar issues:
    • User waybar service enabled
      • install.sh checks for and disables on install
      • Refresh.sh now supports systemctl service as well
        • On NixOS waybar startup is wrapped Refresh.sh handles that also
  • Parser for UserConfigs mistook border size 1 as as true/false value
  • UserConfigs/user_decorations.lua was not being imported correctly
  • My custom keybinds were included in defaults by mistake
    • Removed from both .lua and .conf files
  • Theme by wallpaper and global theme
    • Neither were updating waybar nor border colors
    • Adjusted colors on style sheet Wallust-Chrome-Fustion.css
      • Current workspace showed as single color blob
  • Migrate-hypr-to-lua to lua script
  • Wasn't properly handling variables list $scriptDir
  • Sourcing of UserConfig/user_keybinds.lua
  • Duplicate import of keybinds
    • was reading lua/keybinds.lua and UserConfigs/configs
    • Udpated Kool_Quick_Settings.sh
      • Only reads configs and UserConfigs dirs
  • MonitorProfile for eDP-1-disable.lua incorrect
    • Changed to disable = true
  • copy.sh
    • Didn't handle hyprland.lua properly
    • Re-copied *.conf files when LUA enabled
    • monitors.lua not copied to UserConfigs dir
    • MonitorProfiles.sh wasn't set up for LUA configuration
  • scrpts/migrate-hypr-to-lua.sh
    • It didn't convert monitors.conf nor workspaces.conf
    • Impropved summary to show converted and what's left native
      • I.e. hyprlock.conf and hypridle.conf still use .conf
  • DropDownterminal
    • Created silent-mode for startup
      • It now goes directly to specialworkspace
    • Adding lua support broke legacy hyprlang
    • Part Dos: Fixed the fix to work in lua workflow
    • Part Tres: DropDownterminal.sh exited on hide not persisted
  • logout keybinding and logout from menu not working in LUA config
  • logic issue in migration script
  • Updated description for logout/exit keybinding
    • It only said exit if you search for logout nothing is returned
  • Improved migration process to properly backup and move the .lua files
    • /.config/hypr/lua are the pristine source files
    • Migration script will convert the .conf files to .lua
      • Them move the system configs to .config/hypr/configs
      • Then move thhe user configs to .config/hypr/UserConfigs
      • Preserving user changes on subsquent updates
  • JavaManger.sh field width cut off JDK version
  • Tak0-Autodispatch.sh
    • Reworked code to support LUA config
  • Tak0-Per-Window-Switch.sh
    • Had syntax error
    • Added support for both Hyprlang and LUA configs
  • Incorrect XDGDATA dirs for flatpak
  • Gamemode.sh
    • It supports both HYPRLANG and LUA configs
  • Float-all-windows.sh
    • It works with HYPRLANG and LUA
  • MonitorProfiles.sh script to work with LUA or HYPRLANG
    • Added additional profiles also
      • Virtual-1 1920x1080
    • Virtual-1 2560x1080
    • HDMI-A-1 High Refresh Rate
    • eDP-1 disable
  • Legacy import of UserKeybinds.conf
  • Toggle-Active-Windown-Audio script to work with LUA workflow
  • layerrules made menus look terrible
  • OverviewToggle.sh handling of quickshell vs. ags

Updated:

  • OpenSuse is not longer supported
  • Updated lua defaults to disable hyprland wallpaper at start
  • ENVariables.conf and env.lua
  • migration script to make/keep proper Window Rule names
  • LUA function to handle lid switch to enable/disable laptop display
  • Thank you @star on TheBlackDons Discord Server
  • keybind description for hyprsunset to include hyprsunset
    • Makes it easier to find in keybind search tool
  • ExternalBrightness.sh
    • Taken from code modified by @RAH-iĐ905
    • Discovers montiors, and LUA compatible

Added:

  • yazi config to copy.sh
  • Waybar widget for layouts
    • Shows current layout
      • D for dwindle
      • S for scrolling
      • M for Monocole (Capital M)
      • m for master (lowercase m in a circle)
    • Click on icon brings up menu to select layout
  • Created helper lua modules for UserConfigs lua files
    • user_keybinds_helper.lua
    • user_startup_helper.lua
    • user_window_rules.lua
    • user_layer_rules.lua
    • user_decorations.lua
      • The removes the basic setup user lua files
      • The generated user_keybinds.lua now only has the bindings config
      • Removing all the setup code, functions, makes editing easier
      • Also any updates to the user keybind code is done outside of UserConfigs
        • UserConfigs dir is preserved on updates
  • SUPERCTRL + G for ghostty theme selector
  • Kitty theme selector to Kool_Quick_Settings to match entry for ghostty
  • .luarc.jsonc and hl.meta.lua (Thank you @Tony,btw) for the latter
  • This will get rid of function not defined errors in Editor LSP's that support LUA
  • And provide fuction info as well with properly configured editors
  • support for $VISUAL editor
  • Setting the env variable to your GUI editor will override $EDITOR
  • You can use neovide, code/codium. geany, emacs etc
  • Providing a richer environment, and faster.
  • Created a keybind_helpers.lua file
    • Moved all the helper functions which should need to be edited
    • This cleans up the keybinds.lua file to be more user friendly, easier editing
  • Edited keybinds.lua to make it easier to understand and edit
    • Added a clear “User-editable bindings” header block.
    • Grouped bindings with section labels:
    • Application launchers and utility scripts
    • Window/session controls
    • Layout and tiling controls
    • Audio/media/hardware keys
    • Screenshot bindings
    • Window resize/move/swap/grouping
    • Workspace navigation/assignment
    • Mouse drag/resize bindings
  • Javamanger.sh
    • Manage Java runtime instances
    • 1st pass, only tested for Arch
    • Added code for other distros, needs testing
  • helper script logout.sh to call hyprshutdown
    • Added pkill waybar, awww-daemon, and swww-daemon before hyprshutdown
  • menu option for LayerRules in Quick settings menu

Removed:

  • "-config-v3.conf" files for
    • WindowRules.conf/lua
    • LayerRules.conf/lua
      • They are no longer needed
  • Hard-coded rofi terminal overrides in theme configs
    • themes/KooL_dwm.rasi
    • dwm-config-horiz.rasi
    • dwm-config-vert.rasi
  • Thanks to @TeaJhay for finding this

Misc:

  • Started planning changes to Wallust code to support v4.0
  • wallust v4.0.0 isn't backward compatible
  • There seem to be more options but the color palletes are worse IMO
  • Suggest current users ping wallust to v3.5.2

Lua migration related:

  • Improved move/resize and window swapping using native calls
  • Moved layer rules to own file LayerRules.conf
    • Added additional rules from TheAhumMaitra
    • Updated LUA config accordingly
  • Began Migration process to LUA
    • Created scripts/migrate-hypr-to-lua.sh
    • Script converts configs and UserConfigs to LUA
    • Backs them up in local directories
    • Allows a revert option to restore hyprlang config files
  • Making Kool_Quick_Settings.sh script LUA/HYPRLANG aware
  • Broke out the hypr/configs and hypr/UserConfig LUA files
  • Added project header to all .LUA files
  • Migration script will add that to the converted .conf files as well
  • Updated keybinds parser to support LUA
  • Fixed resize by keybind, SUPERSHIFT= + Arrow keys
  • Then modified that script to support mouse resize
    • SUPER + Left Mouse to move
    • SUPER + Right Mouse to resize

v2.3.23

  • Changed whiptail GUI to dark colors
    • Some terminals rendered incorrectly made menu unreadable
  • Added more icons to ModulesWorkpaces
  • Removed the following from hyprland settings:
    • vfr -- Been enabled by default
    • psuedotile -- In dwindle layout
    • As of Hyprland v0.55 they will generate confiuration errors
  • OverviewToggle.sh wasn't checking properly for quickshell service
    • Found by @TeaJhay
    • Changed script to look for qs not quickshell
  • Minimum Hyprland version is now v0.54.x
    • The addtion of scrolling and monocle require 0.54 or greater
    • Updated warning banner when you run copy.sh
  • Added check for kde-polkit
    • With KDE installed users reported escalation fails
    • kde-polkit is crashing preventng privledge escalation
  • Added .config/hyprland/scripts/Polkit-Diag.sh
    • This runs a series of Read Only commands to triage polkit issues
  • Fixed syntax errors in a few waybar CSS files
    • What should have been <TAB> color
    • Was \tcode Caused by bad search and replace
    • It caused waybar to crash
  • Updated Keyhints.sh
    • Was missing scrolling and monocle layouts
  • Fixed display order for layout change binding
    • It showed master after dwindle
    • Correct order is dwindle, scrolling. monocle, master
  • Added doc on how get ventoy GUI to run properly
    • Seems to be a known bug
    • https://github.com/ventoy/Ventoy/issues/3570
  • Fixed issue with long pause starting lockscreen
    • In ~/.config/hypr/UserScripts/WeatherWrap.sh
      • I put the weather cache check in the background
      • Shortened network timeouts for ping and curl
  • Changed ERROR to NOTE when first installing dotfiles
    • The backup directory isn't there but reports as error
    • Thank you @moukhtar22 for finding and reporting this
  • Removed grace timeout from hyprlock*.conf files
    • It's now only supported on the command line
    • Also updated out the #image and #label
      • They require a space after the #
  • Fixed: Setting wallpaper per monitor on restore both has same wallpaper
    • WallpaperDaemon only tracked one wallpaper
    • Added per monitor current wallpaper
  • Added: Support for transistion effects with awww
  • Added: rofi-ssh-menu SUPER + S
    • Reads hosts from $HOME/.ssh/config
    • You can also add in SSH keys to that file
    • Including for just local hosts and another for your repositories for example
  • Removed: Some leftover Jakoolit references
  • Added: WindowRule and icon for shelly unified app installer for arch
  • Added: WindowRule for hyprwcenter Audio control app
  • Updated: Waybar CSS files to use font-size 14px
    • Waybar, v15.x doesn't support font-size 99%
  • Added: Script to disable Intel CPU Turbo feature
    • $HOME/.config/hypr/scripts/disable.cpu.turbo.sh
    • CPU turbo will often spin up the fan to max, then slowly drop back down
    • Very noisy, happens randomly. 11th/12th gen notorious for this issue
    • Should be added to User Startup as needed
  • Fixed: Duplicate keybinds
  • Fixed: rofi beats keybind not working

📅 Updated: March 30th, 2026

Major Hightlights

  • Added support for scrolling, monocle layouts along with normal dwindle and master

  • Fixed Dropterminal, it stopped working after v0.54.0

  • Massive improvement the response time updating waybar, etc

    • Now updates only takes a few seconds!
    • Wallust was running several times
      • Addtionally there were programmed pauses each time it runs
    • Made updating ghostty and kitty more asynchronous
    • Fixed delay in ScreenCapture.sh
    • Fixed dealy in Sounds.sh
  • Added more icons in ModulesWorkspaces

  • WindowRules file had odd special character in it, causing issues,

  • Fixed issues in ChangeLayout that broke SUPER J/K with the new layouts from when you change wallpapers

  • Optional fastfetch configs with logos.

    • Currently that will be a manual copy but updated in a future release
  • Fixed issues with awww and setting correct colors

    • Thank you @Phantom for pointing out the issue with the --format flag with awww
    • The wallpaper selector looks for awww if not there falls back to swww
    • When awww first starts, it will clear the cache to prevent incorrect inactive / active pane colors
    • When your distro prompts you to install awww over swww say yes
  • Enabled touch on tablet in hypr/configs/SystemSettings.conf

  • Updated copy.sh to support ghostty

  • The ghostty config directory is now backed up

    • An option to restore the backup config was added
  • Improved the layout changer, and now there are bindings to select specific layouts.

    • SUPERALT + L -- Toggle through the layouts.
    • SUPERALT + 1 -- Dwindle Layout
    • SUPERALT + 2 -- Master Layout
    • SUPERALT + 3 -- Scrolling Layout
    • SUPERALT + 4 -- Monocle Layout
  • Partial list of other fixes e480e4f7 Added script to disable cpu turbo and set power settings ec2c6cd0 Fixed duplicate keybind 832d7f3b Added rofi-ssh-menu SUPER+S to pull .ssh/config entries dd53042c Updated CHANGELOG, kitty font fix ea7b042d fix kitty font style mix-up of bold and regular (#38) de41d900 Fixing calculator window rule 62a7c7fc Added Window Rule for kwallet manager 7384fdc3 xfce4-polkit not in debian repo adding mate-polkit as alternative eb71fbdf Updated Window Rules for xfce polkit diaglog window 0e38225c Added hyprpolkitagent override to arch linux installer 59ef5004 resolving Polkit startup caused issue with arch 3485888a Fixing polkit startup for NixOS 2fc46377 Crtical fix to restore polkit function 664b5e54 Add ghostty/wezterm to terminal window WindowRules 6938f643 build-awww wasn't added a6beeea6 WallpaperCmd.sh wasn't executable c58c13ef Moved build-awww.sh to b1b0a29a Fixed distro detection bug 76dd5138 Fixed build-awww script b0844c85 Fixed swww vs awww handling made WallpaperDaemon executable c933c8f1 Fixed syntax errors 1cba8a5e Added a check if awww cache has been cleared already 35db8edd Merged in converion to awww code bede9e64 updated ModulesWorkspaces with boxxy-terminal icon 106511ef Trying a different fix for WP restore 65841b73 Fixing wallpaper restore issue d753fc58 Fix: restore wallpaper failed, garbage character filename 223106b9 Added gitnuro icon to ModulesWorkspaces 50278494 Updated CHANGELOG on enabling cursor on tablet 1c41d7ac fix: change cursor config on tablets 2af79387 Preliminary review of tasks for HL LUA conversion 934ea732 docs: update readme (#30) 8a88c6e8 Updated CHANGELOG 728b7092 Added ghostty config to the backup / restore process 0d1d9d03 Building fastfetch wrapper to call distro logo 4f9218e3 Changed Arch to alternate fastfetch logo 15540e66 Added fastfetches w/logos need one for OpenSuse 7a29e271 Fixing wallpaper select b882bdbd WallpaperSelect upd shows names for current/random wallpapers 4dd2641d Added copy.sh vs. TUI first pass analysis 1363ddaa Added new fastfetches for Arch, fedora, ubuntu, Gentoo bf983704 Added icon for mainline kernel mgr and Window rule for it 8ccf889f waybar: fix gemini waybar 8c1de5e1 waybar: change thunderbird and gemini icons 353d7fda Tuned ddubs simple waybar config cdb8fe89 Added icon for NVIDIA settings app and Centered/floating rule ae2a6027 SWWW archived, using AWWW updated scripts to prefer AWWW if installed a8054d9b Added WallpaperDaemon to use awww if available fallback swww 55920ba3 Updated CHANGELOG 3b3c76d7 FIXED long delay updating theme colors when changing wallpaper f1d6ba4a Updated CHANGELOG 4eb0be4c Updated Sounds.sh to play sound directly 2184393b Added icon for nautilus and terminal with RED X for apps w/o icons bf17f0d0 Fixed screenshot delay issues added icon for nautilus 64789020 Added icon for emacs for waybar 126b065a Added keybind search script and rofi menu for emacs 09399455 Added Antigravity icon to waybar 052c7f77 WindowRules had CTRL-B character at end 19141236 Removed hyprland if statement is loads wrong file on v0.54.1 f309269e Once more try to get dwindle/scrolling binds working 042a5755 moved to lower case to resolve SUPER J/K 0af8be55 Still fixing J/K for all modes and super ARROW also 5f7e547f Fixing script had extra unbind for SUPER J/K d3268ef5 Added fixes for layout cycling with SUPER J/K and SUPER ARROWS 63ec80b5 Fixing layout for SUPER J/K and SUPER arrow keys 616cc940 Improved layout toggleing and added Keybinds to set mode individually a9e5e232 Synced WindowRules-config-v3 to WindowRules.conf layyerrules 4902de1b Dynamic Handling of WindowRules.conf (#24) b9c200da Renamed ghostty config to proper cfgname 941861f7 Updated CHANGELOG on Dropdown terminal fix 942c5dea Adding a state file to resolve not dropping down on first activation 1444ab15 Fixed issue where first toggle didn't drop down terminal 5162d3d0 Fixed syntax error on local outside of the function 21d3b7e0 Using special workspace isn't working 57870978 Visibility check was a bust f516bcb6 Hopefully this fixes the hide issue af5f11a1 Added kitty-dropdown class and improved handling 2e0ee73c Fixed flashing but now doesn't hide completely 26805311 Changing sequence move to special workspace b4 pinning 469b7e9f Adding more debug info 4ad4acbf Adding monitor info to better handle dropdown and other hardening 8513918b Adding logging to Dropterminal e657a02e Trying to fix dropdown terminal dropping down again on hide 15db8236 Made Float-all-Windows script executable a1cda706 Moved Float-all-Windows command string to script acf106df Trying different ghostty fonts c3f5da6a Updated CHANGELOG 8c11f7d7 Updted all float toggle with script to replace depreciated cmd 4bae202a fix: hypr windowrules for qalculate gtk afd84a99 Created dedicated rofi theme for ghostty added license/URL info 93c22eb6 Added script to set ghostty theme to Quick settings f707181b Update gestures on hyprland dec3a0ac Added check for waybar-weather installed local binary or AUR 3c97c7c0 Updated CHANGELOG 361ca9af Fixed package name for waybar-weather b624dfd9 Making sure UserConfigs dir entries not deleted from 2.3.19+ 24900893 Updated CHANGELOG fixed monocle settings 6265eec1 Fixing Monocle settings x2 c469885a Fixing Monocle settings f8dae3a4 Added monocle layout e60a9f7a Fixed duplicate gesture for up motion 9fc53086 Updated gestures - corrected layout and added new gestures 1bd8b2b6 Adding addtional layerrules to test b80cdc05 Trying new settings for cursor and master / dwindle layouts ef7abba9 Updated layerrule for rofi to turn off blur d05341e1 Fixed scrolling keybinds b1874c37 Added more scrolling bindings 2c06a718 Updated CHANGELOG with scrolling keybinds e530f5db Added scrolling options and scrolling keybinds e5807d8d Updted Changelog 86546f57 FIXED: style sheet no more pink on pink widgets b7ac5ab3 Fixing style sheet #2 6fbba196 Fixing styling issues in waybar f43e85be Fixing inconsistent colors in Wallust-Bordered-Chroma-Simple file f8d0290b Trying to fix rofi/waybar colors contrast to fix dark on dark colors c7772095 Fixing wallust to be more consistent and faster 512fab00 Fixing terminal not found and remove kitty URL handler entry 879940d9 Creating script to set the default terminal to kitty for thunar 2900bbce Updated CHANGELOG dcbd8e84 Fixed type, added two bindings for scrolling 20a671c8 Adding scrolling to ChangeLayout script 17b1fc16 Fixed Hyprshotsh output directory ad7651c3 Update Ukrainian README translation (#22) d32e9b75 Togglesplit being replaced by layoutmsg Togglesplit 1e28fb6f Updated ubuntu portal check for all ubuntu versions, common variants 6f9ef204 Fix: Syntax error in copy.sh b08da4cc Fix: UserConfig updates were being removed on updates a5120569 Changed proj name in CHANGELOG 6a40c033 Adding fixes applied to the other wallust style sheets to these 25e7a6ee Fixing opactity and color issues in Dark-Latte-Wallust-combined* dd4b6dce Fixed colors to use different wallust colors 6c7a9697 Switching wallust color references to avoid washed out colors 1f0bdac7 Updating ExternalBrightness script to hopefully better detect monitors 4b1e961a Added custom module for External Brightness control 2859bf9f Added "No color" theme to Kitty, changed default to 01-Wallust.conf d7b0f2be Updated config files and scripts to new Project name and URL b8382bdf Updated headers with new Project name and add GPLv3 license 94eb60c2 Had both QT5CT and QT6CT variables 7bc8b3a3 Added DWM dmenu inspired app menus horiz & vertical b329f012 Fixed new rofi themes cc8073f4 Added two new rofi themes 8023b521 Changed dotfiles name to KoolDots in fastfetch 7bc990fe Updated version to 2.3.22 on development branch

📅 Updated: February 23rd, 2026

v2.3.21

  • Added script from @ivy and @sl1ng to Toggle audio on active Wundow
    • $HOME/.config/hypr/scripts/Toggle-Active-Window-Audio.sh
    • Keybind is SUPER + SHIFT + H (hush)
    • Added check for pactl otherwise keybind fails silently
  • Added check for ubunutu v26.04 in startup
    • For as of yet unknown reason waybar won't startup without this
    exec-once = /usr/libexec/xdg-desktop-portal-hyprland &
    exec-once = /usr/libexec/xdg-desktop-portal &
    exec-once = waybar
    
  • Updated waybar-weather
    • Created default files in .config/waybar-weather
      • You can manually override settings or providers
      • The defaults should work for most users
    • Added question during install to set metric or imperial Temp units
    • Added Menu item is Quick Settings to toggle units
      • Note: After changing units click on the weather widget to update units
  • Updated look of fastfetch compact config file
  • Fixed no tooltips when waybar cava running
    • Thank you Max Gangel for the fix!
  • Added check for rsync in copy.sh
  • Fixed two more style sheets with hardcoded colors that broke with global theme
  • Fixed Window Rules for zapzap
  • Added French Translations
    • Moved docs to proper i18n locations
    • Thank you @Loris383v
  • Fixed waybar-cava starting many new processes
    • When you switched waybarconfigs, old processes remained
    • This is especially bad with mulitple monitors
    • New code kills the waybar-cava processes on refresh
  • Fixed setting SDDM/Wallpaper/Waybar defaults on update/installs
  • Added WindowRule for proton-laucher games
  • Added WindowRule for CachyOS Kernel Manager
  • Added WindowRule for CachyOS Hello app
  • Added WindowRule for CachyOS Package Installer app
  • Added Hyprshot screenshot tool set to region capture
    • ALT + S Saves to clipboard and ~/Pictures/Screenshots/
    • Not all keyboards have PrtScr button
    • hyprshot.sh is fast, simple, no system bell sound
  • Fixed start CLI apps from rofi like htop, btop being started with xterm
    • This made the apps run in light mode with tiny fonts
    • Now they are started with kitty
  • Added alternative RainbowBorders-low-cpu.sh
    • Based on code from DemiGoD
    • I added variables for finer control
    • Some tweaks to lower CPU further
    • Added -h/--help
    • Added --run-once to set RainbowBorders but no animation
  • Added 'TOP-ddubs-simple-bar'
  • Fixed CSS formatting in ML4W-Glass.css
  • Added keybind for "Static Rainbow border"
    • Run RainbowBorders-low-cpu --exec-once to set the rainbow border w/o animation
    • Updated Picture-in-Picture rule
      • Works properly with Brave and other chromium browsers
        • Thanks to Goodborn for the fix

Clone this wiki locally