Skip to content

lumpButton/axonwm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AxonWM

Tiling Wayland compositor with horizontal scrolling and first-class workspace management.

What is AxonWM

AxonWM is a tiling Wayland compositor inspired by Hyprland and niri, combining the best of both:

  • From Hyprland — numbered and named workspaces, window rules, familiar tiling WM feel
  • From niri — horizontal scrolling layout where windows extend beyond the screen edge

Neither Hyprland nor niri does both. AxonWM does.

Core Concept

Windows are arranged in a horizontal row that extends beyond the visible screen area. You scroll left and right to navigate between windows. Multiple windows can share the screen simultaneously — you control their width. This is not traditional tiling where the screen is split; it is a scrollable infinite canvas per workspace.

Workspaces

  • Numbered workspaces — unlimited count, accessible directly by number. Switching to an empty workspace is allowed; it only consumes memory when a window is opened there.
  • Named workspaces — special workspaces that do not occupy numbered slots. Accessible by name via keybind or launcher. Example: messengers, monitoring.
  • Both types coexist independently.

Features

  • Horizontal scrolling layout with animations
  • Windows resize dynamically; two or more windows can share the visible area
  • Floating windows
  • Per-workspace scratchpad + global scratchpad (each workspace has its own hidden window pocket, plus a global one shared across all workspaces)
  • Window rules (assign applications to specific workspaces, set default sizes, etc.)
  • Touchpad gesture support (planned)
  • XWayland support for X11 applications (planned, integrated after minimal WM is working — early enough to avoid large rewrites, late enough to not block initial development)
  • Multi-monitor support (planned)

Configuration

AxonWM uses its own configuration language written as part of the project. All visual aspects are configurable:

  • Window borders (width, color for active/inactive)
  • Rounded corners radius
  • Shadows
  • Blur
  • Focus behavior on scroll
  • Animation style and speed

The language syntax is defined during development. During early development, settings are hardcoded.

IPC

AxonWM communicates with external programs (status bars, launchers, scripts) via a Unix socket. Protocol details are defined during development.

Renderer

AxonWM starts with the wlroots renderer and will replace it with a custom renderer to support blur, advanced animations, and other visual effects.

Status

Early development. Not usable yet.

License

Licensed under the GNU General Public License v3.0. See LICENSE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors