Lucas Oskorep c3d98b7b48
Build and Test / build (push) Failing after 12s
Build and Test / release (push) Skipped
deps: update all dependencies to latest compatible versions
2026-09-07 15:39:07 -04:00
2026-06-15 11:53:49 -04:00
2026-06-15 15:31:41 -04:00
2025-04-03 02:24:40 -04:00
2026-06-15 15:31:41 -04:00
2025-04-03 02:24:40 -04:00
2025-10-17 02:38:04 -04:00

Aerospike Gnome (Tiling Window Manager)

Aerospike is a simple and opinionated tiling window manager for gnome.

This project takes inspiration from previous gnome tiling window managers such as forge and cosmic-shell as well as MacOS tiling WMs, mainly Aerospace (not affiliated).

Current Features

  • Auto-tiling
  • Accordion layouts with variable sizes
  • Tabbed layouts
  • Tree-based (albeit set depth of 2 for now) container-window paired layout similar to Aerospace
  • Diagram for this is pending

Planned functionality

  • Full Keyboard control w/window movement
  • Sub-containers (more tree layers than the 1 supported for now)
  • Gap size customization

Not currently planned

  • Active window borders
    • See my other extension for a rainbow or static border - PrettyBorders
  • complicated window dragging features and uis
    • Aerospace supports control + drag to combine windows while moving with the mouse, and normal window dragging.

Installation

Aerospike isn't on the GNOME extension store yet, so install it from source. This builds the extension locally and drops it into your user's extension dir. Requires just as the command runner, plus the same build toolchain used for development (see Development): mise for managing tool versions (node and pnpm), and glib2 for glib-compile-schemas.

Arch Linux:

sudo pacman -S git just mise glib2  # mise needs its shell hook: https://mise.jdx.dev/getting-started.html#shells

Clone and install:

git clone https://github.com/lucasoskorep/aerospike-gnome
cd aerospike-gnome
mise install
just install

After installing from source, enable it (toggle in the Extensions app, or):

gnome-extensions enable aerospike@lucaso.io

Re-login or restart the shell (Alt+F2r on X11) to pick it up.

Development

Building and debugging locally needs a few extra tools:

  • just — the command runner
  • mise — runtime & tool manager (pins node and pnpm in .mise.toml)
  • glib2 — provides glib-compile-schemas for compiling the settings schema

Arch Linux:

sudo pacman -S just mise glib2

Install the pinned tools with mise (defined in .mise.toml):

mise install

Then:

just install      # install deps + build + drop into the extension dir
just lint         # lint
just test         # run the test suite
just test-watch   # run tests in watch mode
just live-debug   # tail gnome-shell logs while you poke at it
S
Description
Tiling Window Manager for Gnome
Readme
2 MiB
2026-06-15 15:40:08 -04:00
Languages
TypeScript 96.4%
JavaScript 1.5%
Just 1.4%
CSS 0.7%