Repository navigation
Releases
Releases · komawm/koma
Koma v0.0.1 (development prerelease)
Development prerelease on the 0.0.x incubation line. It is not the accepted v0.1.0 product release and makes no hardware, DRM/KMS, security or desktop-support claims.
Initial development prerelease of the imported incubation baseline.
Added
- Nine-crate Rust 2024 workspace targeting Rust
1.100.0:koma-proto,
koma-model,koma-lua,koma-render,koma-seat, thekomacompositor
binary,komactl,koma-mcpandkoma-overview. - Lua configuration through the Phodopus sandbox with configurable defaults:
Dwindleis the default workspace layout;koma.layout(...),
koma.workspace({...}),koma.dwindle({...})andkoma.scrolling({...})
select and tune layouts globally or per workspace.- Hyprland-compatible default keybinds loaded when
inherit_default_binds = true;koma.bind(...)overrides individual
chords in place andkoma.unbind(chord)removes specific defaults. - Typed appearance settings for borders, focus ring, shadow, dim, blur and
animations.
komactl gen-typesemits LuaLS definitions for the configuration API;
komactl validatechecks a configuration offline.- Compatibility & input protocols:
wp_single_pixel_buffer_v1andwp_presentationfeedback alongside
wl_shmAbgr8888/Xbgr8888pixel formats forwaybar,ironbar,
quickshell, and Android/Waydroidsurfaces.- Full
wlr_layer_shellget_popup,xdg_popupunconstraining and
pointer/keyboard grabs, pluszwlr_virtual_pointer_manager_v1and
zwp_keyboard_shortcuts_inhibit_manager_v1(withMod + G/ VT switch
kept un-inhibitable) forRustDeskand remote desktop tools. - 2D damped Hooke's law semi-implicit Euler spring kinematics (
pointer.spring/
pointer.curve) for smooth macro & cursor motion, plus smartWaydroid
no_blur,clip_to_geometrygating, and emptyinput_regionclick-through.
- Session resources (desktop entry, systemd units, portals configuration,
greetd example) and example configuration underexamples/. - Shared local/CI quality gates (
just check: descriptor validation,
shellcheck, actionlint, rustfmt, cargo check, clippy with-D warnings,
tests), GitHub Actions CI and CodeQL workflows pinned by commit SHA. - Release tooling:
scripts/package-release.sh,just package-release, and a
tag-triggered workflow that publishes development prereleases with a
release manifest andSHA256SUMS.
Changed
- Reconciled core geometry/window identifiers, the Phodopus bridge, protocol
exports and Tier 2/3 geometry/lease APIs so the full workspace builds and
passes clippy and tests. - Dropped the redundant
license-filemanifest field; crates declare
license = "GPL-3.0-or-later"with the single rootLICENSE.
Known limitations
- No hardware, DRM/KMS, physical input or GPU acceptance has been performed.
- Nested Wayland and isolated VM validation are still pending; passing CI
covers builds, lints and unit/state-machine tests only. - Koma is not yet a supported daily-driver desktop. Interfaces, configuration
and IPC may change without notice on the0.0.xline. - Only
x86_64-unknown-linux-gnuarchives are produced; BSD and other
architectures remain planned.
Verify the download
sha256sum -c SHA256SUMS