Skip to content

Releases

Koma v0.0.1 (development prerelease)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 11:28

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, the koma compositor
    binary, komactl, koma-mcp and koma-overview.
  • Lua configuration through the Phodopus sandbox with configurable defaults:
    • Dwindle is the default workspace layout; koma.layout(...),
      koma.workspace({...}), koma.dwindle({...}) and koma.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 and koma.unbind(chord) removes specific defaults.
    • Typed appearance settings for borders, focus ring, shadow, dim, blur and
      animations.
  • komactl gen-types emits LuaLS definitions for the configuration API;
    komactl validate checks a configuration offline.
  • Compatibility & input protocols:
    • wp_single_pixel_buffer_v1 and wp_presentation feedback alongside
      wl_shm Abgr8888/Xbgr8888 pixel formats for waybar, ironbar,
      quickshell, and Android/Waydroid surfaces.
    • Full wlr_layer_shell get_popup, xdg_popup unconstraining and
      pointer/keyboard grabs, plus zwlr_virtual_pointer_manager_v1 and
      zwp_keyboard_shortcuts_inhibit_manager_v1 (with Mod + G / VT switch
      kept un-inhibitable) for RustDesk and remote desktop tools.
    • 2D damped Hooke's law semi-implicit Euler spring kinematics (pointer.spring /
      pointer.curve) for smooth macro & cursor motion, plus smart Waydroid
      no_blur, clip_to_geometry gating, and empty input_region click-through.
  • Session resources (desktop entry, systemd units, portals configuration,
    greetd example) and example configuration under examples/.
  • 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 and SHA256SUMS.

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-file manifest field; crates declare
    license = "GPL-3.0-or-later" with the single root LICENSE.

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 the 0.0.x line.
  • Only x86_64-unknown-linux-gnu archives are produced; BSD and other
    architectures remain planned.

Verify the download

sha256sum -c SHA256SUMS