Skip to content

Add Nix Status plugin - #684

Open
mindnbytes wants to merge 1 commit into
noctalia-dev:mainfrom
mindnbytes:add-nix-status
Open

Add Nix Status plugin#684
mindnbytes wants to merge 1 commit into
noctalia-dev:mainfrom
mindnbytes:add-nix-status

Conversation

@mindnbytes

@mindnbytes mindnbytes commented Sep 9, 2026

Copy link
Copy Markdown

Plugin

  • Id: mindnbytes/nix-status
  • New plugin
  • Update to an existing plugin (version bumped in plugin.toml)

What it does

Adds a bar widget and panel for monitoring NixOS generations, comparing system closures, detecting switch availability, and updating configured flake inputs.

It is designed primarily for flake-based NixOS configurations. Generation and closure monitoring work without a flake, while switch detection and input updates require one.

External dependencies

  • readlink resolves /run/booted-system and /run/current-system.
  • nix compares closures, evaluates the configured system, and updates flake inputs when explicitly requested.

Automatic evaluation uses --no-update-lock-file, but Nix may access configured flake sources or substituters. The user-triggered update may access the network and modifies the configured flake's flake.lock. Optional logo templates are installed and applied manually by the user.

Testing

Tested the widget, panel, settings, manual refreshes, closure comparison, switch detection, and flake input updates. The community validator passed and all 78 plugin tests passed.

  • Tested on Niri
  • Tested on Hyprland
  • Tested on Sway
  • Tested on another compositor:
  • Noctalia version tested against: v5.0.1
  • Plugin API level: 30

Screenshots / Videos

Closure changes and reboot status

Switch availability and flake input updates

Checklist

  • The directory name matches the part of id after the / in plugin.toml exactly.
  • It ships plugin.toml, README.md, thumbnail.webp, and translations/en.json.
  • README.md follows the README template, documents every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
  • thumbnail.webp is present and relevant; for a new plugin I created it with the thumbnail generator, and for an update I regenerated it with the generator if the visual identity or user-facing appearance changed.
  • version follows semver and is bumped in this PR; plugin_api is the oldest API level this plugin requires.
  • Every non-English translation in this PR uses a locale supported by Noctalia core, and I can read, write, and understand that language well enough to review and maintain it (no unreviewed machine/LLM translations).
  • I did not edit catalog.toml; CI generates it.
  • This PR touches exactly one plugin directory.

Code review attestation

Plugins run as trusted, unsandboxed Luau in the user's session. Confirm:

  • The code is readable and not obfuscated, minified, or generated.
  • It does not download and execute remote code.
  • Every network call, filesystem write, and spawned process is something the description above accounts for.
  • I have the right to publish this code under the license declared in plugin.toml.

@Noctalia-CI
Noctalia-CI marked this pull request as draft September 9, 2026 15:30
@Noctalia-CI

Noctalia-CI commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

The description now contains the required template structure.

@mindnbytes
mindnbytes marked this pull request as ready for review September 9, 2026 15:51
@Ly-sec

Ly-sec commented Sep 9, 2026

Copy link
Copy Markdown
Member

Hey @mindnbytes , we already have the Nix Monitor plugin, maybe you and @avivbintangaringga could work together on a unified plugin? If not that's totally fine, was just an idea to not have multiple different plugins for NixOS.

Overall it looks good to me so I'd merge it, just waiting for responses :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants