A new perspective on window management -- literally. A Hyprland plugin that turns your workspace into a walkable 3D space
Experimental, pinned to Hyprland 0.56.2.
# Install latest
hyprpm add https://github.com/samine825/Hypr3D
hyprpm enable Hypr3D
# Update
hyprpm update# Build
cmake -S . -B build -DHYPRLAND_HEADERS=/var/cache/hyprpm/$USER/headersRoot
cmake --build build -j$(nproc)
# Load
hyprctl plugin load "$PWD/build/hypr3d.so"To enable 3D:
hyprctl eval 'hl.plugin.hypr3d.toggle()'Or bind in lua config:
hl.bind("SUPER + F12", hl.plugin.hypr3d.toggle)| Input | Action |
|---|---|
| Mouse move | Look around |
| WASD | Move |
| Space | Move up (flying) / Jump |
| Shift | Move down (flying) |
| Ctrl | Sprint |
| Super + Left click | Drag window |
| Super + Right click | Resize window |
| Super + Mouse wheel click | rotate window |
| Super + Mouse wheel scrolling | Zoom window |
| Super + Left Alt | Toggle keyboard mode (movement / window input) |
| F3 | Toggle debug HUD |
if hl.plugin.hypr3d then
-- binds
hl.bind("SUPER + F12", hl.plugin.hypr3d.toggle)
-- parameters
hl.plugin.hypr3d.config({
-- every key is optional
world = {
panorama = "~/Pictures/room.png", -- 360° room background (equirectangular)
grid = true, -- base 40x40 grid platform
},
windows = {
window_scale = 0.5, -- window size multiplier (real px at 100 px/m)
spawn_distance = 5, -- distance from the camera new windows spawn at
},
player = {
look_sensitivity = 0.0025, -- mouse look, radians per pointer count
look_inertia = 0.03, -- look glide after the mouse stops, sec
move_inertia = 0.05, -- walk glide after keys release, sec
move_speed = 4.0, -- walking speed, m/s
spawn = { x = 0, y = 0, z = 0 }, -- player position
flying = true, -- on alse: gravity, Space jumps off the ground, Shift does nothing
},
map = {
path = "~/map.gltf", -- glTF 2.0 map (.glb/.gltf)
transform = {
position = { x = 0, y = 0, z = 0 },
rotation = { x = 0, y = 0, z = 0 },
scale = { x = 1, y = 1, z = 1 },
},
emissive_scale = 1.0, -- emission multiplier
flat = true, -- textures carry all lighting
collision = true, -- collide with the map
},
})
-- That's all for now :p
end