Skip to content

Latest commit

 

History

History

defaff-compositor

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
build.zig
build.zig
 
 

README.md

SEE design.md at top of repo.

Overview

A Wayland Compositor that is simple, fast, focussed, and enabling extreme productivity.

Design

  • A stack of windows per stack.
  • 10 workspaces per stack.
  • Windows sit on one workspace at a time (except for the pinned window) and can be moved across them within the same stack.
  • 3 separate stack.
  • No border on windows but area around selected window is highlighted, potentially offscreen, and underneath the pinned window.
  • Window layering is in stack order within:
    • Pinned
    • Hub (when in Hub mode)
    • Selected
    • Hub (when not in Hub mode)
    • Floating (default state)
    • Tiled (and not fullscreen)
    • Fullscreen
  • Pinning clears tiled and fullscreen states and vice versa. Pinning also shows on all workstations within stack. Only one pinned window per stack.
  • Displays attach to workspaces and can be moved across them but only one display can be assigned to each workspace.
  • Screens can be arranged around the primary display as if in a 3x3 grid.
  • Windows smaller than the minimum window size are scaled.
  • Hub that sits on each display in the bottom left position.
  • Shortcut keys are configurable (for keyboard alternatives).
  • Windows always stay within screen boundaries, even when moving. Moving windows may resize them to fit but will only permanently resize them at the end of the move operation.
  • Launching always opens a new process with windows on the current stack and workspace.
  • Restarting or loging out does not restore windows.
  • Hub contents:
    • Launcher: >
    • Status Bar (User + Systems)
    • Stack and Workspace indicator: 1:[1]234567890
  • Tech stack:
    • Linux
    • Zig
    • Wayland

Controls

  • Click: Select (and Raise if Floating).
  • MovePointer: Focus follows mouse.
  • Activate Hub: [Meta (while held, or after double-press and until next press)]
  • Hub:
    • Switch window through layers: [j/k], [Vertical scroll (or swipe 2 up/down)]
    • Switch workspace: [h/l], [1234567890], [Shift + Vertical scroll (or swipe 2 up/down)]
    • Move window to workspace: [Shift + 12345678909]
    • Switch workspace with Selected window: [Shift + j/k]
    • Swap (reordering) workspace: [Shift + h/l]
    • Move / Resize window (selects window, also can reorder in tile mode): [Drag top-left/bottom-right section]
    • Raise window or next window (to top of stack): [Tab]
    • Fullscreen window: [Enter]
    • Tile window: [;]
    • Pin window: [p]
    • Close window: [q]
    • Lock screen: [Escape]
    • Switch stack: [./,]
    • Open Launcher: [Space], [Click on Launcher or Status Bar]
    • Open cheatsheet: [Click on Hub Stack and Workspace indicator]
    • Copy / Paste: [c/v]

Configs

hub.toml

[Launcher]
# Curved monitor offset
button="     >"

Status Bar

  • Taken as a list of executables from inside: ~/.config/defaff/desktop/statusbar/ and /etc/config/defaff/desktop/statusbar/
  • They are sorted by name, and then each is launched, and each time a new line is output, it is updated in the status bar.
  • Each one is separated by a blank space.

Launcher