feat: refine Hyprland autostart and helper scripts

- feat: add per-workspace show-desktop minimize/restore script.
- feat: add Waybar toggle script with hidden config support and optional LM Studio refresh.
- feat: improve hyprpaper wallpaper IPC with a fallback target and more robust success detection.
- change: simplify example Hyprland configs by removing app-specific binds/rules and grouping optional extras.
- feat: enable optional Hyprland autostart extras during setup when dependencies are available.

Author: Firstp1ck

dotfiles/.config/hypr/scripts/Startup_check.sh

@@ -60,7 +60,6 @@ processes=(
     "Telegram"
     "wasistlos"
     "hyprsunset"
-    "gpu-screen-recorder"
     "conky"
     "fcitx5"
     "bluetoothd"

dotfiles/.config/hypr/scripts/change_wallpaper.sh

@@ -127,6 +127,11 @@ fi
 pkill -f "hyprctl.*hyprpaper" 2>/dev/null
 sleep 0.1
 
+# Set fallback wallpaper target first (empty monitor selector).
+# This follows current hyprpaper IPC docs and avoids "no target" on
+# dynamic outputs until monitor-specific assignments are applied.
+hyprctl hyprpaper wallpaper ", $WALLPAPER, cover" >/dev/null 2>&1 || true
+
 # Set wallpaper on each monitor with retry logic
 # New hyprpaper 0.8.0 IPC format: 'monitor, path, fit_mode'
 # fit_mode is optional and defaults to 'cover' if omitted
@@ -137,7 +142,10 @@ for monitor in "${MONITORS[@]}"; do
 
   while [ $retry_count -lt $max_retries ] && [ "$success" = false ]; do
     # New format requires spaces: monitor, path, fit_mode
-    if hyprctl hyprpaper wallpaper "$monitor, $WALLPAPER, cover" &>/dev/null; then
+    wallpaper_out="$(hyprctl hyprpaper wallpaper "$monitor, $WALLPAPER, cover" 2>&1 || true)"
+    if [ -z "$wallpaper_out" ]; then
+      success=true
+    elif echo "$wallpaper_out" | grep -qiE "ok|applied|success"; then
       success=true
     else
       retry_count=$((retry_count + 1))
@@ -149,6 +157,7 @@ for monitor in "${MONITORS[@]}"; do
 
   if [ "$success" = false ]; then
     echo "Error: Failed to set wallpaper on $monitor after $max_retries attempts" >&2
+    [ -n "${wallpaper_out:-}" ] && echo "hyprpaper output: $wallpaper_out" >&2
   fi
 done
 

dotfiles/.config/hypr/scripts/minimize_per_workspace.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+
+TMP_FILE="$XDG_RUNTIME_DIR/hyprland-show-desktop"
+
+CURRENT_WORKSPACE=$(hyprctl monitors -j | jq -r '.[] | .activeWorkspace | .name' | head -n1)
+
+if [ -s "$TMP_FILE-$CURRENT_WORKSPACE" ]; then
+  # Restore windows
+  CMDS=""
+  readarray -t ADDRESS_ARRAY < <(grep -v '^$' "$TMP_FILE-$CURRENT_WORKSPACE")
+
+  for address in "${ADDRESS_ARRAY[@]}"
+  do
+    address=$(echo "$address" | tr -d '[:space:]')
+    if [[ -n "$address" ]]; then
+      CMDS+="dispatch movetoworkspacesilent name:$CURRENT_WORKSPACE,address:$address;"
+    fi
+  done
+
+  if [[ -n "$CMDS" ]]; then
+    hyprctl --batch "$CMDS"
+  fi
+
+  rm "$TMP_FILE-$CURRENT_WORKSPACE"
+else
+  # Hide windows
+  CMDS=""
+  TMP_ADDRESS=""
+  
+  # Get windows from current workspace, excluding special workspaces
+  HIDDEN_WINDOWS=$(hyprctl clients -j | jq -r --arg CW "$CURRENT_WORKSPACE" '.[] | select(.workspace.name == $CW and (.workspace.name | startswith("special:") | not)) | .address')
+
+  if [[ -z "$HIDDEN_WINDOWS" ]]; then
+    exit 0
+  fi
+
+  while IFS= read -r address; do
+    address=$(echo "$address" | tr -d '[:space:]')
+    if [[ -n "$address" ]]; then
+      TMP_ADDRESS+="$address"$'\n'
+      CMDS+="dispatch movetoworkspacesilent special:desktop,address:$address;"
+    fi
+  done <<< "$HIDDEN_WINDOWS"
+
+  if [[ -n "$CMDS" ]]; then
+    hyprctl --batch "$CMDS"
+    echo -n "$TMP_ADDRESS" | sed -e '/^$/d' > "$TMP_FILE-$CURRENT_WORKSPACE"
+  fi
+fi

dotfiles/.config/hypr/sources_example/app_variables.conf

@@ -19,17 +19,12 @@ $editor = hyprctl dispatch exec "code --ozone-platform=wayland --enable-features
 # $editor = nvim
 # $editor = cursor --ozone-platform=wayland --enable-features=UseOzonePlatform
 
-# Voice/Communication app (example)
-# $voice = discord --enable-features=UseOzonePlatform --ozone-platform=wayland
-
 $screenshot = hyprshot --mode
 
 $cursor = rose-pine-hyprcursor
 
 $colorPicker = hyprpicker --autocopy --format hex
 
-$git = github-desktop
-
 $calc = qalculate-gtk
 
 # Default wallpaper (will be overridden by change_wallpaper.sh)

dotfiles/.config/hypr/sources_example/autostart.conf

@@ -3,61 +3,47 @@ exec-once = systemctl --user start hyprpolkitagent &
 exec-once = hyprctl keyword input:kb_numlock true && date "+%Y-%m-%d %H:%M:%S" > /tmp/numlock-set
 exec-once = /usr/lib/polkit-kde-authentication-agent-1 &
 
-# Start Notifications Daemon
-exec-once = swaync
-
-# Used for tray, network in the status bar (waybar)
-exec-once = nm-applet --indicator &
-
 # Static Wallpaper
 exec-once = hyprpaper &
 exec-once = $hyprscripts/change_wallpaper.sh &
 
-# Start Pyprland for Scratchpad-Terminal
-exec-once = pypr
-
 # Persistent Clipboard
 exec-once = wl-clip-persist --clipboard regular &
 exec-once = wl-clipboard-history -t &
 
 # Start Idle Manager
 exec-once = hypridle &
 
-exec-once = systemctl --user start app-org.kde.xwaylandvideobridge@autostart.service &
-
-# Fix Dolphin File Manager
-exec-once = $hyprscripts/fix-dolphin.sh &
-
-# If you use a mouse with additional buttons: Chack name with: `libinput list-devices | grep Device`
-exec-once = input-remapper-control --command autoload --device $mouse &
-
 # Cursor theme
 exec-once = hyprctl setcursor $cursor 24
 
+# Start Waybar
+exec-once = sleep 1; waybar -c "$HOME/.config/waybar/config.jsonc" &
+
+exec-once = sleep 1; $hyprscripts/Startup_check.sh &
+
 # Start Apps Workspace 1:
 exec-once = [workspace 1 silent] $editor
 
 # Start Apps Workspace 2:
 exec-once = [workspace 2 silent] $browser &
 
-# Start Apps Workspace 3:
+# Optional extras (commented in the example to avoid assuming package availability)
+# exec-once = swaync
+# exec-once = nm-applet --indicator &
+# exec-once = pypr
+# exec-once = systemctl --user start app-org.kde.xwaylandvideobridge@autostart.service &
+# exec-once = $hyprscripts/fix-dolphin.sh &
+# exec-once = input-remapper-control --command autoload --device $mouse &
+# exec-once = hyprsunset
+# exec-once = blueman-applet &
+# exec-once = blueman-tray &
+#
+# Example: autostart apps per workspace
+# (Workspace 1/2 defaults are enabled above; add more here as needed.)
+
+# Start Apps Workspace 3 (terminal examples)
+# These are only safe to enable if the terminal/layout referenced actually exists.
 # exec-once = [workspace 3 silent] kitty --session ~/.config/kitty/my_layout.conf
-# Example: Start terminal with zellij layout
 # exec-once = [workspace 3 silent] kitty -e zellij -l ~/.config/zellij/layouts/sysmon.kdl
-
-# Start Apps Workspace 4:
-# Example: Start voice/communication apps
-# exec-once = [workspace 4 silent] $voice &
-# exec-once = [workspace 4 silent] telegram-desktop &
-
-exec-once = hyprsunset
-
-# Used for tray, Bluetooth in the status bar (waybar)
-exec-once = blueman-applet &
-exec-once = blueman-tray &
-
-# Start Waybar
-exec-once = sleep 1; waybar -c "$HOME/.config/waybar/config.jsonc" &
-
-
-exec-once = sleep 1; $hyprscripts/Startup_check.sh &
+# exec-once = [workspace 3 silent] alacritty -e zellij -l ~/.config/zellij/layouts/sysmon.kdl

dotfiles/.config/hypr/sources_example/keybindings.conf

@@ -13,16 +13,12 @@ $LESS = code:94 # Less Key
 $DOUBLES = code:49 # "§" Key
 $HOME = code:110 # Home Key
 
-# Open Programms
+# Open programs (portable defaults)
 bindd = $mainMod, SPACE, Open Menu, exec, pkill wofi || $menu
 bindd = $mainMod1, Y, Open Preferred Terminal, exec, $terminal --command $multiplex
 bindd = $mainMod, E, Open Preferred File Manager, exec, $fileManager
 bindd = $mainMod, F, Open Preferred Browser, exec, $browser
 bindd = $mainMod, C, Open Preferred Editor, exec, $editor
-bindd = $mainMod, T, Open Telegram, exec, Telegram
-bindd = $mainMod, A, Open WhatsApp, exec, wasistlos
-bindd = $mainMod, D, Open Preferred Voice App, exec, $voice
-bindd = $mainMod, G, Open Github Desktop, exec, $git
 bindd = $mainMod, J, Open Preferred Color Picker, exec, $colorPicker
 bindd = $mainMod, K, Open Preferred Calendar, exec, $calendar
 bindd = $mainMod, $ENTER, Open Calculator, exec, $calc
@@ -61,12 +57,9 @@ bindd = , $HOME, Take Screenshot of Region, exec, $screenshot region --raw | sat
 bindd = $mainMod, H, Toggle Waybar, exec, $hyprscripts/toggle_waybar.sh
 bindd = $mainMod, V, Toggle Floating, exec, $hyprscripts/toggle_floating.sh
 bindd = $mainMod, W, Change Wallpaper, exec, $hyprscripts/change_wallpaper.sh
-# bindd = $mainMod $mainMod1, Y, Start WoW Dependencies, exec, $hyprscripts/start_wow_dependencies.sh
-bindd = $mainMod $mainMod2, S, Save Replay, exec, $hyprscripts/save_replay.sh
 bindd = $mainMod $mainMod1, S, Start Hyprsunset, exec, $hyprscripts/hyprsunset.sh
 bindd = $mainMod $mainMod1, M, Start Music Player, exec, hyprctl dispatch exec "[workspace 7 silent] $terminal -e $hyprscripts/play_music.sh"
 bindd = $mainMod, $DOUBLES, Open Notes, exec, $terminal -t Notes --command bash -lc "$hyprscripts/notes.sh"
-bindd = $mainMod $mainMod1, C, Launch Steam, exec, $hyprscripts/launch_steam_fix.sh
 bindd = $mainMod $mainMod2, B, Toggle Bluetooth ON or OFF, exec, $hyprscripts/toggle_bluetooth.sh
 bindd = $mainMod $mainMod1, SPACE, Wofi Menu for Github Repositories, exec, $hyprscripts/repos_wofi.sh
 

dotfiles/.config/hypr/sources_example/windows_and_workspaces.conf

@@ -4,21 +4,11 @@
 windowrule = float on, match:class alacritty.term-top
 windowrule = float on, match:class org.pulseaudio.pavucontrol
 
-# Workspace 1
-# windowrule = workspace 1 silent, match:class Code, match:title Visual Studio Code
-
-# Workspace 2
-windowrule = workspace 2 silent, match:class zen
-# Alternative browsers:
-# windowrule = workspace 2 silent, match:class vivaldi-stable
+# Workspace rules
+# Intentionally left empty in the example.
+# During setup, `setup.sh` may inject a browser workspace rule here based on your browser choice.
 
-# Workspace 4
-windowrule = workspace 4 silent, match:class discord
-windowrule = workspace 4 silent, match:class org.telegram.desktop
-windowrule = workspace 4 silent, match:class wasistlos
-
-# Workspace 5
-windowrule = workspace 5, match:class LM Studio
+# Workspace 1
 
 # Ignore maximize requests from apps. You'll probably like this.
 # Note: suppressevent may not be available in v0.53.0 - check documentation
@@ -75,9 +65,6 @@ windowrule = size 1330 800, match:class filezilla
 
 layerrule = dim_around on, match:namespace wofi
 
-windowrule = float on, match:class steam
-windowrule = workspace 6, match:class steam
-
 windowrule = float on, match:class qalculate-gtk
 
 windowrule = float on, match:class alacritty, match:title Notes
@@ -104,11 +91,3 @@ windowrule = stay_focused off, match:class ^(conky)$
 windowrule = pin on, match:class ^(conky)$
 windowrule = move 20 40, match:class ^(conky)$
 
-windowrule = float on, match:class externe_analytik
-windowrule = float on, match:class GitHub Desktop
-
-windowrule = float on, match:class Schulungen-Rust
-windowrule = float on, match:class Lagerverwaltung
-
-windowrule = workspace 5, match:class steam_app_275850
-

dotfiles/.config/waybar/scripts/toggle_waybar.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+STATE_FILE="/tmp/waybar_toggle_state"
+
+# Define the visible and hidden config paths.
+VISIBLE_CONFIG="$HOME/.config/waybar/config.jsonc"
+HIDDEN_CONFIG="$HOME/.config/waybar/hidden_config.jsonc"
+
+if [ -f "$STATE_FILE" ]; then
+    # Currently hidden, switch to visible
+    rm "$STATE_FILE"
+    pkill -f "waybar -c $HIDDEN_CONFIG"
+    # Refresh LM Studio menu before showing waybar (run synchronously to ensure config is updated)
+    if [ -f "$HOME/.config/waybar/scripts/lmstudio_refresh_menu.sh" ]; then
+        "$HOME/.config/waybar/scripts/lmstudio_refresh_menu.sh" > /dev/null 2>&1
+    fi
+    waybar -c "$VISIBLE_CONFIG" &
+else
+    # Currently visible, switch to hidden
+    touch "$STATE_FILE"
+    pkill -f "waybar -c $VISIBLE_CONFIG"
+    waybar -c "$HIDDEN_CONFIG" &
+fi