Omahub
← All plugins
D

herdy

by Daniel Helm

Quiet MIDI-active indicator and configuration hub for the herdy control surface.

GitHub Homepage

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
153759e
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
153759e
Reviewed
1 month ago

This plugin is a QML bar widget that launches two bundled, stdlib-only Python helpers to communicate with the local herdy Unix socket. No installer, network access, shell execution, obfuscation, credential access, or privileged operations were found, and the code is defensive and well-scoped. The deterministic scan's 'none' rating matches this independent review.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/dghelm/omarchy-herdy --enable
Hardware #bar #quickshell

herdy for Omarchy

A quiet Omarchy Shell bar widget and configuration panel for herdy, a MIDI controller interface for herdr agent workspaces.

herdy controller concept with the live Omarchy configuration hub

The bar uses a DIN-plug mark for MIDI health. Open it to configure Feel, Phrases, Bindings, Pad theme, and Devices through herdy's local control socket. The panel also supports MIDI Learn, keyboard phrase picking, and live pitch-wheel and sustain-pedal telemetry when the daemon advertises those capabilities.

Screenshots

Configuration hub Feel editor
herdy configuration hub Pitch-wheel and pedal Feel editor

The reference hardware used for development is an Arturia KeyLab 61 mk3:

herdy running on an Arturia KeyLab 61 mk3

Requirements

  • Omarchy with third-party shell plugin support
  • herdy running locally
  • Python 3 (used by the two bundled Unix-socket helpers)

The plugin remains usable as a status/error surface when the daemon or MIDI controller is unavailable. Older herdy daemons degrade by hiding controls for capabilities they do not advertise.

Install

omarchy plugin add https://github.com/dghelm/omarchy-herdy.git --enable

Plugins execute as unsandboxed user code inside Omarchy Shell. Review the source before enabling any third-party plugin.

Remove

omarchy plugin remove dghelm.herdy

Removing the plugin does not remove herdy or its configuration.

Use

Click the DIN-plug bar widget to open the panel. If hideWhenHealthy is enabled and the widget is collapsed, summon it directly:

omarchy-shell shell summon dghelm.herdy '{}'

Inline settings:

Setting Meaning
hideWhenHealthy Collapse the bar mark while MIDI is healthy
pollIntervalMs Status polling interval, from 500 to 30000 ms
socketPath Optional herdy socket override; empty uses HERDY_SOCKET or ~/.config/herdy/herdy.sock

Configuration writes are serialized and reconciled against confirmed daemon snapshots. Topology changes are labeled restart-required; the panel never restarts the daemon itself.

Related work

  • herdy is the daemon and hardware control surface configured by this plugin.
  • Chordarchy maps chords played on a physical MIDI keyboard to Omarchy shortcuts and commands—a complementary approach for people interested in broader MIDI-driven desktop control. See its Omarchy Plugins listing.

Security and data access

The QML plugin launches only its bundled Python helpers. They exchange bounded JSON lines with the local herdy Unix socket; requests are not placed on the process command line. The plugin has no installer, does not request elevated privileges, and performs no network requests. herdy itself is a separate application with its own documented desktop and MIDI integrations.

Development

The canonical source lives in the omarchy/dghelm.herdy directory of the herdy repository. This standalone repository is its installable distribution mirror.

Validate and run the hardware-free checks from a herdy checkout:

omarchy plugin validate omarchy/dghelm.herdy
uv run python test_panel.py
node omarchy/dghelm.herdy/test_model.js

Automated Quickshell runners are not used because the host-injected quickshell-coreplugin is unavailable to qmltestrunner; the plugin has also been exercised in a live Omarchy Shell with physical pointer and MIDI input.

License

MIT © Daniel Helm. See LICENSE.