version 0.25.0
© David Thomas, 2020-2026
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.
wuss/wuss.h— minimal window manager {docs}wuss/window.h— window creation, positioning, sizing and client delegationwuss/task.h— tasks: the clients of windowswuss/message.h— inter-task messagingwuss/icon.h— work-area iconswuss/icon-spec.h— fill helpers for common icon shapeswuss/iconbar.h— RISC OS-style icon barwuss/menu.h— pop-up menuswuss/menu-desc.h— build a menu tree from a descriptor stringwuss/gadget/colourset.h— titled colour well with a colour menuwuss/gadget/gridview.h— glyph and label gridwuss/gadget/stringset.h— field with a pop-up menu of fixed stringswuss/component/dialogue.h— interactive dialogue base classwuss/component/saveas.h— RISC OS-style drag-and-drop Save As dialoguewuss/component/info.h— label and value grid dialoguewuss/component/proginfo.h— shared program information dialoguewuss/component/colourmenu.h— menu of the system palette colourswuss/component/fontmenu.h— menu of the available bitmap fonts
The interactive wuss demo (apps/wuss/) hosts several example tasks, including Painting. More notes are in docs/windowing/.
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 binaryBUILD_APPS— the interactivewussdemoUSE_ASAN— AddressSanitizer and UBSanWUSS_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.
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.