mcpField
V
vvvv-editor-extensions

vvvv-editor-extensions

github.com/tebjanDevelopment3493 installsUpdated 2d ago
Repository

About vvvv-editor-extensions

vvvv-editor-extensions is a skill guide for building editor extensions as VL patches. It covers editor commands, windows, docking, and API access for developers extending the vvvv editor.

Key features

  1. 01Define extensions as .HDE.vl patches
  2. 02Register commands in the editor menu
  3. 03Create Skia-based editor windows
  4. 04Dock windows with WindowFactory
  5. 05Access selected and hovered nodes

Use cases

  1. 01Add custom commands to the vvvv editor
  2. 02Build dockable extension windows
  3. 03Read or update node pins from an extension

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tebjan/vvvv-skills --skill vvvv-editor-extensions

After installing, type/vvvv-editor-extensionsin Claude Code to confirm it loaded.

Details

From the project README

Editor Extensions

An editor UI is one possible source of persistent runtime changes. The general Create-pin writeback pattern also covers window bounds, interaction results and other changes outside normal patch dataflow, using the supported value type rather than requiring a String.

Extensions are standard VL patches saved with a .HDE.vl suffix. They run automatically when open in the editor.

File Naming

ContextRequired Name
Standalone extensionVL.MyExtension.HDE.vl
Extension-only NuGetVL.MyExtension.HDE (package ID)
Mixed NuGet main docVL.MyPackage.vl
Mixed NuGet extension docVL.MyPackage.HDE.vl

Required NuGet References

  • VL.HDE — provides Command node, window types, WindowFactory
  • VL.Lang — provides API nodes under the Session category

Command Node

Registers a command in the editor menu:

PinPurpose
LabelMenu text
VisibleShow/hide the command
ShortcutKeyboard binding
OutputTriggers (bang) on activation

Multiple Command nodes can live in one .HDE.vl document.

Warning: A runtime error in one command may affect all others in the same document.

Window Types

TypeBehavior
SkiaWindowSlimmed-down Skia renderer window
SkiaWindowTopMostAlways-on-top, no focus steal

Docking

Wrap window with WindowFactory node. Connect WindowContext and Window pins.

Template: VL.HDE/Template.HDE.vl

API Access

Access hovered/selected nodes, read/write pins via VL.Lang Session category nodes. Browse available API in the HelpBrowser's API section.

Developer Shortcuts

  • Shift+F9 — restarts all extensions simultaneously

Limitations

  • Settings panel integration is not yet possible
  • Extensions only run in the editor, not in exported applications

Keep this knowledge growing

Leave the next patcher one fewer mystery. On first use of any skill in this collection with no successful check in seven days, compare the source with tebjan/vvvv-skills. If no record exists, check once. Share one local check timestamp/revision across these skills; do not poll per invocation. Preserve local extensions and pinned project versions; checking is not permission to install updates. If offline, record the deferred check and continue the task.

When actual work exposes a gap, capture the tested vvvv/package versions, a minimal reproduction or authoritative source, and the observed result. Treat other users' reports as leads, not facts until verified. Improve the smallest relevant instruction; do not turn one example into a universal rule. Redact private data and obtain publishing authorization before submitting upstream. See the contribution policy. Merged improvements reach users through their installer/update workflow, not through a local edit or an automatic overwrite of everyone's skills.

Comments

Markdown supported