tebjan/vvvv-startup
skills/vvvv-startup/SKILL.md
Covers launching vvvv gamma from the command line or programmatically -- normal startup, opening specific .vl patches, command-line arguments, package repositories, and key filesystem paths (install directory, user data, sketches, exports, packages). Use when starting vvvv, configuring launch arguments, setting up package repositories, or finding vvvv's data directories.
$ install --global
skillsauthnpx skillsauth add tebjan/vvvv-skills vvvv-startupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 3:18 AM8.9s2 files scanned
SKILL.md
- name:
- vvvv-startup
- description:
- Covers launching vvvv gamma from the command line or programmatically -- normal startup, opening specific .vl patches, command-line arguments, package repositories, and key filesystem paths (install directory, user data, sketches, exports, packages). Use when starting vvvv, configuring launch arguments, setting up package repositories, or finding vvvv's data directories.
- license:
- CC-BY-SA-4.0
- compatibility:
- Designed for coding AI agents assisting with vvvv gamma development
- author:
- Tebjan Halm
- version:
- 1.0
Launching vvvv gamma
Filesystem Paths
| Location | Path |
|----------|------|
| Install directory | C:\Program Files\vvvv\vvvv_gamma_X.Y-win-x64\ |
| User data (AppData) | %LOCALAPPDATA%\vvvv\gamma\ |
| Documents root | %USERPROFILE%\Documents\vvvv\gamma\ |
| Sketches | %USERPROFILE%\Documents\vvvv\gamma\Sketches |
| Exports | %USERPROFILE%\Documents\vvvv\gamma\Exports |
| User packages | %LOCALAPPDATA%\vvvv\gamma\nugets |
| Log file (when enabled) | %USERPROFILE%\Documents\vvvv\gamma\vvvv.log |
Preview builds use gamma-preview instead of gamma in the above paths.
Normal Launch
# Launch vvvv (opens with default empty patch)
"C:\Program Files\vvvv\vvvv_gamma_7.0-win-x64\vvvv.exe"
# Open a specific patch
vvvv.exe MyProject.vl
# Open multiple files
vvvv.exe --open "FileA.vl;FileB.vl"
Package Repositories and Editable Packages
These two arguments work together and are the most important for development:
--package-repositoriestells vvvv where to look for packages. Provide the parent folder of each package (the folder containing the package directory, not the package directory itself).--editable-packagestells vvvv which packages from those repositories to load from source instead of pre-compiled cache (read-only). Glob patterns are supported.
You must use both together when working on a package from source:
# Given this folder structure:
# D:\Projects\
# VL.MyLib\ <-- the package
# VL.MyLib.vl
# VL.MyOtherLib\ <-- another package
# VL.MyOtherLib.vl
# The parent folder "D:\Projects" is the package repository
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" --debug
# Multiple repositories (semi-colon separated)
vvvv.exe --package-repositories "D:\Projects;D:\SharedLibs" --editable-packages "VL.MyLib*;VL.SharedUtils" --debug
# Open a specific help patch for testing
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" -o "D:\Projects\VL.MyLib\help\HowTo Use Feature.vl" --debug
Without --package-repositories, vvvv won't find your local package sources, and --editable-packages will have no effect.
Common Argument Combinations
# Development: debug symbols + allow multiple instances
vvvv.exe MyProject.vl --debug --allowmultiple
# Troubleshooting: skip cache, enable logging
vvvv.exe MyProject.vl --nocache --log
# Minimal startup: no extensions, no backend (fast launch for patch editing)
vvvv.exe --noextensions --disable-backend
# Paused on startup (runtime won't start until you press play)
vvvv.exe MyProject.vl --stoppedonstartup
# Skip splash screen
vvvv.exe --no-splash
For the complete argument reference, see cli-reference.md.
Detecting vvvv Installations
To find vvvv programmatically:
- Windows Registry: Enumerate
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstallfor subkeys starting withvvvv_gamma_. Read theInstallLocationvalue. - Default path: Scan
C:\Program Files\vvvv\for directories matchingvvvv_gamma_*. - Version parsing: Extract version from directory name format
vvvv_gamma_MAJOR.MINOR[-PREVIEW-HASH-PLATFORM]. - Filtering: Exclude
-beta,-alpha,-rc,-test,-dev, etc. variants if not explicitly requested. - Selection: Sort by major DESC, minor DESC, preview number DESC. Pick the latest and ask the user if that or another one should be used.
The executable is at <install-dir>\vvvv.exe.
Related Skills
tebjan/vvvv-troubleshooting
data-ai
VerifiedTrustedCommunity
Diagnoses and fixes common vvvv gamma errors in C# nodes, SDSL shaders, and runtime behavior. Use when encountering errors, exceptions, crashes, red nodes, shader compilation failures, missing nodes in the browser, performance issues, or unexpected behavior.
23SKILL.mdUpdated Apr 15, 2026
tebjan/vvvv-testing
development
VerifiedTrustedCommunity
Set up and run automated tests for vvvv gamma packages and C# nodes -- VL.TestFramework with NUnit for library/package authors (CI-ready), test .vl patches with assertion nodes, and lightweight agent-driven test workflows. Use when writing tests for vvvv packages, setting up test infrastructure, creating test patches, running automated compilation checks, or integrating vvvv tests into CI/CD.
23SKILL.mdUpdated Apr 15, 2026
tebjan/vvvv-spreads
development
VerifiedTrustedCommunity
Helps write code using vvvv gamma's Spread<T> immutable collection type and SpreadBuilder<T>. Use when working with Spreads, SpreadBuilder, collections, arrays, iteration, mapping, filtering, zipping, accumulating, or converting between Span and Spread. Trigger whenever the user writes collection-processing C# code in vvvv — even if they say 'list', 'array', or 'IEnumerable' instead of Spread, this skill likely applies.
23SKILL.mdUpdated Apr 15, 2026
tebjan/vvvv-shaders
development
VerifiedTrustedCommunity
Helps write SDSL shaders for Stride and vvvv gamma — TextureFX, shader mixins, compute shaders, and ShaderFX composition. SDSL is a superset of HLSL, so use this skill when writing or debugging .sdsl shader files, GPU shaders, visual effects, HLSL code for vvvv, working with the Stride rendering pipeline, composing shader mixins, or any GPU/compute work. Trigger even if the user says 'HLSL', 'shader', 'GPU effect', 'render pass', or 'compute' in a vvvv context.
23SKILL.mdUpdated Apr 15, 2026