Official plugins

These ship from the default official source (github.com/noctalia-dev/official-plugins). Each is installed and enabled like any other plugin — see Using Plugins. Once enabled, an entry can be driven over IPC:

noctalia msg plugin <author/plugin:entry> <target> <event> [payload]

<target> selects which live instances receive the event:

focused — the entry on the focused output (bar widgets)
<connector> or <connector>:<bar-name> — a specific output / bar
all — every instance; also how you address a [[service]], since a service is a singleton with no output

Example

noctalia/example

A reference plugin that exercises every entry kind: a bar widget, a headless service (ticks once a second and publishes to the plugin’s state channel), and a control-center shortcut. Good starting point for reading real code.

Command	Effect
`plugin noctalia/example:hello focused set "New label"`	set the widget’s text
`plugin noctalia/example:hello focused fetch "https://example.com"`	async HTTP GET; notifies with the status + body size

Screen Recorder

noctalia/screen_recorder

Screen recording and a replay buffer via gpu-screen-recorder (must be installed, natively or as the Flatpak). The recording logic lives in a headless service that runs for the whole session, so it works with no bar widget placed — the widget and control-center shortcut are thin clients. Options (codec, quality, output folder, replay buffer, …) are plugin-level settings, edited under Settings → Plugins.

The service is a singleton, so address it with all:

Command	Effect
`plugin noctalia/screen_recorder:service all start`	start recording
`plugin noctalia/screen_recorder:service all stop`	stop recording
`plugin noctalia/screen_recorder:service all toggle`	start/stop recording
`plugin noctalia/screen_recorder:service all replay-start`	start the replay buffer
`plugin noctalia/screen_recorder:service all replay-stop`	stop the replay buffer
`plugin noctalia/screen_recorder:service all replay-toggle`	start/stop the replay buffer
`plugin noctalia/screen_recorder:service all replay-save`	save the last buffered seconds

Translator

noctalia/translator

Translate text straight from the launcher via Google Translate. A launcher provider behind the /tr prefix — type /tr <lang> <text> (e.g. /tr es hello world) and press Enter on a result to copy the translation. If the first word isn’t a language, the whole query is translated to the default target language (a plugin setting, default en). Language can be a code (fr) or a name (french, français).

Timer

noctalia/timer

A countdown timer desktop widget with start/pause and reset buttons and a progress bar. Add it from the desktop-widgets editor (it appears in the type picker once the plugin is enabled). Also the reference implementation for the declarative ui.* desktop-widget API — see Plugin Development.

Settings: countdown duration, accent color, and progress-bar visibility.

Bongo Cat

noctalia/bongocat

A bar cat that taps along to your keystrokes (via evtest) or to the audio spectrum. Single bar widget.

Command	Effect
`plugin noctalia/bongocat:cat focused pause`	freeze the cat
`plugin noctalia/bongocat:cat focused resume`	resume tapping
`plugin noctalia/bongocat:cat focused toggle`	pause/resume