Skip to content
dptPublic

About

Minimal portable C99 window manager inspired by RISC OS

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Wuss

version 0.25.0

Build status

© David Thomas, 2020-2026

Overview

Wuss is a minimal window manager written in portable C99. It handles window creation, z-ordering, mouse routing, dirty-region redraw and client-delegated content. On top of that core sit optional layers: window furniture, icons, menus, gadgets and shared components.

Wuss was split out of DPTLib, which it uses for bitmaps, fonts, geometry and the other basics. CMake fetches DPTLib automatically.

Modules

The interactive wuss demo (apps/wuss/) hosts several example tasks, including Painting. More notes are in docs/windowing/.

Building

Use CMake with Ninja or Make, e.g.:

cmake -B build -G Ninja -DBUILD_TESTS=YES
cmake --build build --target WussTest

Requires libpng and libjpeg. The demo also needs SDL3. Useful options:

  • BUILD_TESTS — the test binary
  • BUILD_APPS — the interactive wuss demo
  • USE_ASAN — AddressSanitizer and UBSan
  • WUSS_FURNITURE, WUSS_ICONBAR, WUSS_ICONS, WUSS_MENUS, WUSS_GADGETS, WUSS_COMPONENTS — subsystems (all default ON)

To build against a local DPTLib checkout instead of the pinned commit, add -DFETCHCONTENT_SOURCE_DIR_DPTLIB=../DPTLib.

The bitmap fonts come from DPTLib: configuring links resources/bmfonts to DPTLib's copy.

RISC OS is built with a GCCSDK toolchain file. WebAssembly builds of the demo use emcmake; see AGENTS.md.

Testing

Run from the repository root:

./build/WussTest -resources .

(Debug builds name the binary WussTest-debug.) Name tests to run a subset, e.g. wuss wuss-menu. If successful you'll see:

++ Tests completed in 0.9909s: N of N tests passed.

About

Minimal portable C99 window manager inspired by RISC OS

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages