This collection contains community Noctalia plugin forks and custom Albedo and Surge monitors.

Plugins #

Plugin	ID	Origin
Albedo Monitor	adam0/albedo-monitor	Custom plugin, inspired by Bloom
Forges	adam0/forges	Tangled/GitHub redesign of GitHub Kanban
Keybind Cheatsheet	kenn/keybind-cheatsheet	Community plugin
Nix Monitor	avivbintangaringga/nix-monitor	community plugin
NoctaProton VPN	adam0/noctaproton-vpn	Community plugin
Surge	adam0/surge	Custom plugin for Surge downloads
Udiskie Manager	adam0/udiskie	Community plugin
World Clock	noctalia/world_clock	Official plugin

Forks retain upstream author identities. Udiskie Manager uses adam0/udiskie to distinguish it from the community copy. Albedo Monitor uses its own ID and reads Albedo directly rather than Claude Code hooks.

Usage #

Nix flake #

Add the repository as a flake input:

{
  inputs.noctalia-plugins.url = "path:/absolute/path/to/noctalia-plugins";
}

Use inputs.noctalia-plugins.lib.source wherever the configuration expects the plugin source path.

Noctalia path source #

Clone the repository, then add its root directly as a local Noctalia path source:

noctalia msg plugins source add local path /absolute/path/to/noctalia-plugins

The plugins can then be enabled and configured through Noctalia's plugin settings.

Surge hides only its download count and meter when idle; its launcher stays visible. See its setup instructions for the server address and widget ID.

Dependencies #

Noctalia resolves each plugin's declared command dependencies. The main external tools are:

Plugin	Commands
Albedo Monitor	albedo-monitor from albedo-suite, timeout
Forges	tg, gh, xdg-open
Keybind Cheatsheet	hyprctl
Nix Monitor	nix, nix-store, nixos-rebuild, plus standard shell utilities
Surge	surge v0.12.2 or later, timeout
Udiskie Manager	udiskie, udisks2, xdg-open

Development #

From the repository root:

# Format every supported file
nix fmt

# Run flake and formatter checks
nix flake check