Controls

Hold the ⊞ key (WIN/CMD) for shortcuts:

⊞ +
⎵	▶ launch space for HUD and apps
⇥	⧉ tab swap windows
◅◊▻	⎘ nav across windows (or ⦺⇕)
⦺⊹	⤡ drag/resize/tab on left/right/top
;	◫ tile or float the window
:	⌸ stack, chain or span tiled window
'	⚲ pin window above everything
⏎	⛶ enter or leave fullscreen
⌫	☒ backspace close the window
,.	￭▣ desk jump (or ⇧+⦺⇕ 1-9 [])
<>	▯⇋ yank window across desks
{}	￭⇋ lift desk to new position
~	⤹⩈ switch sessions
cvx	✄ copy and paste
esc	⏻ escape to lock the screen or exit

Hint: ⊞ + ⎵▶ ☩⇥⦺⇕⎘ ;:◫ '⚲ <>()⇧⦺⇕￭▣ ⏎⛶ ⌫⛝ ~⤹⩈ esc⏻

Details:

• When the HUD is open, all shortcuts are active as if the ⊞ key is held.
• The HUD can be closed with ⊞+⎵ or ⏎ or esc.
• The HUD can also be opened by pushing the mouse pointer into the bottom left.
• CapsLock⇪ key rebound to main mouse click.
• CapsLock can be toggled with ⊞ +⇧+⇪ or an alternate configured key.
• Exiting will first lock the screen.
• Focus follows mouse, and clicking raises the window.

WIP

• HUD.

  • Shows stuff - time, status indicators, workspaces (top), launcher, help, window layout, and all other contols.
  • Activating a shortcut or clicking on the section expands the relevant section.
  • Alphabet keys search for applications to launch.

• There are two sessions that can be switched between.

• There are nine desktops in each session to use as different workspaces.

• Raising floating windows lift them to the top.

• Consecutive navigation does not change last window used for swapping.

Overview

• Stack of windows distributed across 10 desktops and organised in layers.
• Window layering order:
  • Pinned
  • Hub (when active)
  • Selected
  • Hub
  • Floating (default state)
  • Tiled (and not fullscreen)
  • Fullscreen
• Navigating through windows will respect the layering of the stack.
• Navigating horizontally will jump through tabs, and then the columns of tiled mode.
• One pixel borders except when fullscreen (secondary color, or primary if selected).
• Pinning clears tiled and fullscreen states and vice versa.
• Displays attach to desktops and can be moved across them.
• Desktops adjust their resolution to the smallest attached display, and scales for larger displays.
• Displays are arranged and rotated as if in a 3x3 grid.
• Fullscreen windows that are also pinned are drawn across all displays.
• Layout constrints:
  • Windows smaller than their hinted minimum window size are scaled.
  • There is a minimum windows size across all windows.
  • Windows always stay within display boundaries (with configurable padding for curved edges and notches), even when moving.
  • Moving windows may resize them to fit but will only permanently resize them at the end of the move operation.
  • Windows may have their true position and size outside the display area, if the desktop size decreases, but those windows will still display within the desktop dimensions.
  • Windows will be moved to other desktop when dragging, if the mouse travels to a new desktop.
• Launching always opens a new process with windows on the current session and desktop.
• Restarting or loging out does not restore windows.
• Hub sits on each display in the bottom left position.
• Hub contents:
  • Launcher: >
  • Indicator: 1:[1]234567890 (clicking opens help)
  • Status Bar (User + Systems)
  • Pressing any of the Desktop switching shortcuts will expand the hub to display thumbnails of the desktops with the selected desktop highlighted.
  • Pressing any of the Window switching shortcuts will display wireframes of all windows in the stack.
• Tech stach:
  • Zig
  • Linux: Wayland
• Tiling:
  • Windows stack vertically into columns.
  • Windows can split the layout in span or column modes.
  • Span makes windows extend to the right, shortening all subsequent columns.
  • Column make windows act as column headers for new columns.
  • Windows can be moved and resized, with tiling sizes adjusting to window sizes.
  • Arranging:
    • Move by dragging left side of windows when Hub activated.
    • Resize by dragging right side of windows when Hub activated.
    • Window auto arranges to new size but doesn't rearrange other windows until release.
    • Resizing to the very right activates spanning.
    • Moving to the very top activates column header.
    • Moving column header to the very bottom collapses the column.
• Tabs:
  • Tab by dragging to the top (100th of screen height) of another window.
  • Untab by dragging from the tab line.
• 3 sessions, each with their own independent stack of windows and desktops.
• Capslock is remapped to Click.
• Default colors:
  • Primary: #defaff
  • Secondary: #210a500
• Focus follows mouse mode:
  • Can be activated in the configs.
  • Mouse position decides which window recieves input events, which may not be the selected window.

Configs

hub.toml

[Launcher]
# Curved monitor offset
button="     >"
[Controls]
hub_keys="Ctrl+Alt"
launch="f"

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

• Respects keyword search flavor of: https://specifications.freedesktop.org/menu-spec/menu-spec-latest.html (see: https://wiki.archlinux.org/title/Desktop_entries).

• Search based (all case insensitive, keywords include command etc):

  • Start typing keywords or the command.
  • Matches shown above in order:
    • Name that matches last word exactly.
    • Weightings of:
      • Name that begins with the last word +10.
      • Keyword matches +10.
      • Keyword beginning with word +1.
      • Fuzzy word association +1 (may not be implemented).

• Options are shown with - (Categories).

• First match is selected by default.

• [Up/down arrows] change selection, and typing resets.

• [Enter] launches selection.

• Integrate file browser for docs??? hmn :/

Lock Screen

• The lock screen displays controls to:
• Log back in.
• Select a different Session (still requires unlocking).
• Shut Down.
• Disconnect.
• Restart.

Shutting Down MAY give applications a short chance to cache unsaved data, but MUST NOT abort the shut down process with requests for focus or user input.