Skip to content
snowarchPublic

About

Quickshell rewritten in Rust, for exactly one shell: iNiR

Resources

Stars

7 stars

Watchers

1 watching

Forks

Latest commit

 

History

212 Commits

Folders and files

Repository files navigation

qs-rs

Quickshell, rewritten in Rust, for exactly one shell: iNiR. Same QML API as Quickshell 0.3.2, same CLI and IPC, and the binary is still called qs, so iNiR doesn't notice the swap.

Written by Hikari, an AI agent; the maintainer steers by what shows up on screen and doesn't read the code. The rules and plans behind it stay on the maintainer's machine, on purpose.

Where it sits

iNiR is a few pieces, each with one job:

  • iNiR: the shell itself, in QML.
  • qs-rs: runs that QML, in place of Quickshell.
  • inir-accel: what the shell runs in the background (colours, thumbnails, sensors), in Rust.
  • inir-cli: the inir command you type.
  • inir-hub: the families, themes and widgets you install, served at inir.space/hub.

Since iNiR 3.0, setup and inir update install qs-rs prebuilt with its own Qt in ~/.local/share/inir/runtime; iNiR's launcher runs Quickshell's qs only when that runtime is missing. iNiR v2.33 ran on stock Quickshell.

Numbers

iNiR on both runtimes, same factory config, each in its own headless KWin (qs-rs 0.1.9 and iNiR 3.1.2, 2026-11-14; one run from an empty cache, then three):

Quickshell 0.3.2 qs-rs
first frame 1.53 s 0.69 s 2.2x faster
first frame, empty cache 1.96 s 1.75 s -11%
CPU in the first 30 s 3.0 s 1.0 s -66%
threads 79 39 -51%
RSS 407 MB 308 MB -24%
PSS 311 MB 232 MB -25%
GPU memory (VRAM + GTT) 148 MiB 132 MiB -11%

Empty cache means the run's whole cache folder (QML, shaders, fonts, the shell's own) was cleared; Quickshell keeps no QML cache for a shell, so its other starts compile every file again too. GPU memory is read from the driver (drm fdinfo): qs-rs keeps its window buffers in VRAM where Quickshell leaves them in system RAM (GTT), so VRAM alone reads higher on qs-rs (122 against 116 MiB). Ryzen 7 5700G (Vega), Linux 7.3, Qt 6.12, Mesa 26.2.

qs-rs 0.1.9 running a full daily iRiS desktop (2026-11-14, not the factory config above, so not comparable with it): 618 MB RSS, 562 MB PSS, 47 threads, 0.35 % of one core at rest (20 s). The binary is 19 MB; the bundle with its Qt and WebEngine, 457 MB on disk.

What it adds

  • qs errors: every warning of the running shell, grouped by where it comes from (--static compiles every file first, -f keeps watching). qs check compiles the whole config without running it.
  • qs memory, qs frames, qs ui: where the memory sits, what each frame costs and why, and what a person would read on screen.
  • Live window previews: ScreencopyView { niriWindowId: id } draws one window from niri's ScreenCast as GPU textures (dmabuf, no copy). sourceRect crops it for free, and sourceRectBase keeps the crop in place when the window resizes.
  • WebEngine (hasVersion(0, 3, ["webengine"])), which iNiR's sidebar web apps run on.
  • Hot reload that keeps windows open, watchFiles (save to reload), and on a crash the native backtrace plus the QML stack of every engine, file.qml:line included.

Status

Everything iNiR uses works, all three families, as a daily session. Missing, because iNiR doesn't use them: IdleInhibitor, DataStream, SocketServer, the widget wrappers; Hyprland is IPC only. Out of scope: I3/Sway, Greetd, X11.

Get it

Every v* tag builds a bundle on CI: the binary plus the Qt 6.12 it was built against, so it runs the same on every distro (Releases). iNiR's setup and update install the one its base pins by sha256; nothing compiles on your machine. iNiR's launcher takes it from INIR_QS_BIN or the installed runtime, and Quickshell's qs only when neither is there.

To build it yourself:

cargo build --release      # Qt 6, LayerShellQt and a C++ compiler
scripts/test.sh            # every tests/qml/*.qml, isolated HOME and XDG dirs

License and credits

GNU LGPL 3, same as Quickshell: LICENSE, on top of the GPL in LICENSE-GPL. Semantics ported from Quickshell by outfoxxed and contributors; any bug in the port is ours.

This code was written by: Hikari.

About

Quickshell rewritten in Rust, for exactly one shell: iNiR

Resources

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages