ldraney/hyprland-config
1
0
Fork 0
Code Issues 2 Pull requests 2 Projects Releases Packages Wiki Activity Actions
Hyprland window manager configuration for archbox (GTX 1070, 4K)
8 commits 3 branches 0 tags 57 KiB
  • Lua 100%
Find a file
Exact
Lucas Draney efe352ac90 Add PipeWire audio stack, volume keybinds, and monitor config (#2)
2026-06-06 12:40:22 +00:00
docs Add PipeWire audio stack, volume keybinds, and monitor config (#2) 2026-06-06 12:40:22 +00:00
.claude-no-enforce Initial Hyprland config for archbox 2026-05-15 05:52:47 -06:00
.gitignore Migrate to Lua config (Hyprland 0.55) and add native Steam gaming 2026-05-18 04:44:06 -06:00
hyprland.lua Add PipeWire audio stack, volume keybinds, and monitor config (#2) 2026-06-06 12:40:22 +00:00
README.md Add clipboard history, architecture docs, and updated README 2026-05-19 05:52:59 -06:00

README.md

Hyprland Config — archbox

https://forgejo.tail5b443a.ts.net/ldraney/hyprland-config

Minimal tiling Wayland setup on Arch Linux with NVIDIA GTX 1070 (4K, 2x scale). Uses Hyprland 0.55+ Lua config format (hyprland.lua).

Docs

  • Architecture — component stack, GPU pipeline, clipboard flow, workspace layout
  • User Story — who, what, daily workflow, key decisions
  • GPU Sharing / GOW — Games on Whales history and revival instructions

Setup

Packages installed:

sudo pacman -S hyprland uwsm xdg-desktop-portal-hyprland kitty waybar wofi mako \
  ttf-nerd-fonts-symbols noto-fonts qt5-wayland qt6-wayland polkit-gnome brightnessctl \
  gamemode lib32-gamemode mangohud lib32-mangohud steam \
  wl-clipboard cliphist vivaldi vivaldi-ffmpeg-codecs
paru -S nvidia-580xx-dkms nvidia-580xx-utils

Launch from TTY:

uwsm start hyprland-uwsm.desktop

Hardware

  • GPU: NVIDIA GTX 1070 (Pascal) — requires nvidia-580xx-dkms (proprietary). The open driver (nvidia-open) does not support Pascal GPUs.
  • Monitor: 4K at 2x scale

Gaming

Steam runs natively on Hyprland (workspace 9). Games go fullscreen with immediate (VRR tearing passthrough).

  • gamemode: CPU governor/scheduler optimization, auto-detected by Steam
  • mangohud: FPS/temp overlay — add mangohud %command% to Steam launch options

Previously used Games on Whales (GOW) containers for remote streaming via Moonlight, but that required stopping Hyprland due to DRM master GPU conflict. See docs/gpu-sharing-gow.md for history and revival instructions.

Hotkeys

SUPER is the mod key.

Core

Keys Action
SUPER + Enter Open terminal (kitty)
SUPER + D App launcher (wofi)
SUPER + Q Close focused window
SUPER + SHIFT + E Exit Hyprland (uwsm stop)

Focus (vim-style)

Keys Action
SUPER + H Focus left
SUPER + J Focus down
SUPER + K Focus up
SUPER + L Focus right

Move Windows

Keys Action
SUPER + SHIFT + H Move window left
SUPER + SHIFT + J Move window down
SUPER + SHIFT + K Move window up
SUPER + SHIFT + L Move window right

Resize Windows

Keys Action
SUPER + CTRL + H Shrink width
SUPER + CTRL + J Grow height
SUPER + CTRL + K Shrink height
SUPER + CTRL + L Grow width

Layout

Keys Action
SUPER + V Toggle floating
SUPER + F Toggle fullscreen

Workspaces

Keys Action
SUPER + 1-9 Switch to workspace 1-9
SUPER + SHIFT + 1-9 Move window to workspace 1-9

Gaming

Keys Action
SUPER + G Launch/focus Steam (workspace 9)
SUPER + SHIFT + G Jump to workspace 9

Mouse

Keys Action
SUPER + Left Click Drag Move window
SUPER + Right Click Drag Resize window

Clipboard

Keys Action
SUPER + SHIFT + V Clipboard history picker (wofi)

Screenshot

Keys Action
Print Screen Screenshot region (requires grim + slurp)

Files

  • hyprland.lua — Main config (Lua format, Hyprland 0.55+)
  • docs/architecture.md — System architecture and component stack
  • docs/user-story.md — Workflow and design decisions
  • docs/gpu-sharing-gow.md — GPU sharing history and GOW revival instructions