init

cheatsheets/hyprland/hyprland.binds.cheatsheet.md

@@ -0,0 +1,91 @@
+# Hyprland Keybindings — ddubsOS
+
+## 🗝️ Conventions
+- SUPERKEY = Mod key (Hyprland `$modifier`)
+- SHIFT, CTRL, ALT used as shown
+- Arrows and hjkl are both supported for movement
+
+---
+
+## 🚀 Applications
+- SUPERKEY+Return — Launch default terminal (${terminal})
+- SUPERKEY+SHIFT+Return — Launch foot (floating)
+- SUPERKEY+ALT+Return — Launch WezTerm
+- SUPERKEY+CTRL+Return — Launch Ghostty
+- SUPERKEY+W — Launch browser (${browser})
+- SUPERKEY+Y — Kitty running Yazi (file manager)
+- SUPERKEY+T — Thunar (also another mapping present: "exec, exec, thunar")
+- SUPERKEY+M — Pavucontrol (audio)
+- SUPERKEY+G — VS Code
+- SUPERKEY+O — OBS Studio
+- SUPERKEY+E — Emoji picker (emopicker9000)
+- SUPERKEY+V — Clipboard menu (cliphist via rofi)
+- SUPERKEY+D — Rofi menu
+- SUPERKEY+SHIFT+D — Dock
+- SUPERKEY+CTRL+D — Sherlock (alt menu)
+- SUPERKEY+SHIFT+W — Web search
+- SUPERKEY+ALT+W — Warp terminal (commented alternative: wallsetter)
+- SUPERKEY+CTRL+W — Waypaper
+- SUPERKEY+N — Note from clipboard
+- SUPERKEY+SHIFT+N — SwayNC reset
+- SUPERKEY+ALT+D — Discord Canary
+- SUPERKEY+C — Hyprpicker (color picker)
+- SHIFT+ALT+S — Hyprshot region (non-SUPER shortcut)
+
+## 🧭 Hyprland UI/Plugins
+- SUPERKEY+TAB — Hyprspace Overview toggle (all)
+- SUPERKEY+SHIFT+TAB — Hyprspace Overview close (all)
+- ALT+Space — Hyprexpo toggle
+- SUPERKEY+A — AGS Overview toggle
+
+## 📸 Screenshots
+- SUPERKEY+S — screenshootin
+- SUPERKEY+SHIFT+S — screenshootin-satty
+- SUPERKEY+ALT+S — hyprpanel toggleWindow settings-dialog
+
+## 🪟 Window Management
+- SUPERKEY+Q — Kill active window
+- SUPERKEY+P — Pseudo tile
+- SUPERKEY+SHIFT+I — Toggle split
+- SUPERKEY+F — Fullscreen
+- SUPERKEY+SHIFT+F — Toggle floating
+- SUPERKEY+ALT+F — Workspace option: allfloat
+- SUPERKEY+SHIFT+C — Exit Hyprland
+- SUPERKEY+SPACE — Toggle floating
+- SUPERKEY+SHIFT+SPACE — Workspace option: allfloat
+- SUPERKEY+SHIFT+M — swap_layout
+
+### Move Window
+- SUPERKEY+SHIFT+Left/Right/Up/Down — Move window L/R/U/D
+- SUPERKEY+SHIFT+H/J/K/L — Move window L/D/U/R
+
+### Swap Window
+- SUPERKEY+ALT+Left/Right/Up/Down — Swap window L/R/U/D
+- SUPERKEY+ALT+[, . , - , ,] — Swap window L/R/U/D (keycodes 43,46,45,44)
+
+### Focus Movement
+- SUPERKEY+Left/Right/Up/Down — Focus L/R/U/D
+- SUPERKEY+H/J/K/L — Focus L/D/U/R
+
+### Workspace Navigation
+- SUPERKEY+1..9,0 — Go to workspace 1..10
+- SUPERKEY+SHIFT+1..9,0 — Move window to workspace 1..10
+- SUPERKEY+CTRL+Right/Left — Next/Previous workspace (relative)
+- SUPERKEY+Mouse Wheel Down/Up — Workspace e+1 / e-1
+
+### Alt-Tab
+- ALT+Tab — Cycle next
+- ALT+Tab — Bring active to top (runs twice to ensure raise)
+
+## 🔊 Media & Brightness
+- XF86AudioRaiseVolume — wpctl set-volume +5%
+- XF86AudioLowerVolume — wpctl set-volume -5%
+- XF86AudioMute — toggle sink mute
+- XF86AudioPlay/Pause — playerctl play-pause
+- XF86AudioNext/Prev — playerctl next/previous
+- XF86MonBrightnessDown/Up — brightnessctl -5% / +5%
+
+## 🖱️ Mouse Bindings
+- SUPERKEY + Left Mouse — Move window
+- SUPERKEY + Right Mouse — Resize window
+

cheatsheets/hyprland/hyprland.windowrules.cheatsheet.md

@@ -0,0 +1,59 @@
+# Hyprland Window Rules — ddubsOS
+
+## 🧩 Tags and Classification
+- file-manager — Thunar, Nautilus, PCManFM-Qt
+- terminal — Ghostty, WezTerm, Alacritty, Kitty, kitty-dropterm
+- browser — Brave, Firefox, Chrome, Thorium/Cachy
+- video — VLC, mpv, Clapper
+- projects — VSCodium/VSCode
+- im — Discord, WebCord, Vesktop, Ferdium, WhatsApp, Telegram, Teams
+- obs — OBS Studio
+- games — gamescope, steam_app_*
+- gamestore — Steam, Lutris, Heroic
+- settings — various settings apps (nm-applet, pavucontrol, file-roller, rofi, etc.)
+
+## 🪟 Floating, Size, and Position
+- foot-floating — float, size 60% x 60%, center
+- Picture-in-Picture — float, 95%/75% opacity, pinned, keep aspect ratio, position at ~72%/7%
+- Authentication Required dialogs — float, center
+- Settings-tagged windows — float, size 70% x 70%
+- Ferdium — float, center, size 60% x 70%
+- Clapper — float
+- VSCodium setup dialogs — float (title negative rules)
+- Steam/Heroic non-main dialogs — float (title negative rules)
+- File chooser dialogs — float; size 70% x 60% (Open Files); float on save prompts
+
+## 🎨 Visual Effects
+- noblur — games
+- content none — mpv (prevent black screen on maximize)
+- Opacity by tag:
+  - browser: 1.0 / 1.0
+  - video: 1.0 / 1.0
+  - projects: 0.9 / 0.8
+  - im: 0.94 / 0.86
+  - file-manager: 0.9 / 0.8
+  - terminal: 1.0 / 0.8
+  - settings: 0.8 / 0.7
+- Extra opacity tweaks:
+  - gedit/GNOME Text Editor/mousepad: 0.8 / 0.7
+  - seahorse: 0.9 / 0.8
+
+## 🧭 Workspace Assignment
+- im* — workspace 3
+- browser* — workspace 2
+- obs* — workspace 10
+
+## 🧪 XWayland and Special Cases
+- Example targeted xwayland rule: noblur for class “resolve” on xwayland:1
+
+## 🌱 Environment (set via Hyprland)
+- NIXOS_OZONE_WL=1, NIXPKGS_ALLOW_UNFREE=1
+- XDG_CURRENT_DESKTOP=Hyprland, XDG_SESSION_TYPE=wayland, XDG_SESSION_DESKTOP=Hyprland
+- GDK_BACKEND=wayland,x11, CLUTTER_BACKEND=wayland
+- QT_QPA_PLATFORM=wayland;xcb, QT_WAYLAND_DISABLE_WINDOWDECORATION=1, QT_AUTO_SCREEN_SCALE_FACTOR=1
+- SDL_VIDEODRIVER=x11 (explicit)
+- MOZ_ENABLE_WAYLAND=1
+- AQ_DRM_DEVICES=/dev/dri/card0:/dev/dri/card1
+- GDK_SCALE=1, QT_SCALE_FACTOR=1
+- EDITOR=nvim
+