Introducing vpm: A vvvv package manager

May 27, 2016 posted by: microdee Guest Post

Hello vvvvellas! Remember the magnificent Packs folder where you can shove stuff in, downloaded from the contributions or from github and awesomeness will happen in vvvv? Only problem with it if a pack requires another you have to dig that up from contribs as well (in case the pack developer didn’t include a link already) (most common examples are packs depending on DX11). Or worse if a pack gets breaking update and packs depending on it doesn’t get updated with it you might download a wrong version. And to make things worse what if a pack is depending on not 1, not 2, but 5 or more other packs? Good luck hunting them all from contribs/github.

In VVVV community most of the time if a contribution used some parts from an other pack the developer would just include that part in their own contribution. However this leads to node duplicates if someone actually using that another pack too or in case of .NET libraries it can cause “Assembly is already loaded from another location” exceptions.

In other regular software/environment this situation is solved by a package manager like npm for node.js, NuGet for .NET development or apt-get for Ubuntu. And now vvvv can go into this list too. Ladies and Gentlemen behold: VPM and its incredibly boring name.

So what we’ve just seen there? One of my packs called mp.dx (wrapping some rendering related utility nodes) depends on the DX11 pack and mp.essentials which also depends on vvvv-Messages + vvvv-Patchbox. vpm reads the mp.dx.vpack (an XML formatted pack configuration file) which contains path to its content and its dependencies, also the installation script. vpm fetches all sources recursively and then execute the installation scripts for all collected packs. An exmple .vpack file looks like this (for mp.dx):

        <aliases>dx11, vvvv-dx11</aliases>
        VVVV.Dir + "\\packs\\" + Pack.Name,
        ignore: new string[]() {"src", ".git*"}

The installation script’s language is the C# scripting dialect (dubbed Roslyn or CSX) and vpm already provides some common helper functions and environment variables to ease writing these scripts. Like Copy, Download, Extract, GitClone and BuildSolution. Notice DX11, Messages and Patchbox doesn’t have a vpack specification but vpm is still able to fetch and compile/extract them. The reason for this is if a dependency doesn’t have a vpack specification the developer can still write a little .csx script file for it stored in an online location. Like the vpdb folder in vpm’s github repo. An example script looks like this (for Messages):

GitClone("", Pack.TempDir);

BuildSolution(2013, Pack.TempDir + "\src\vvvv-Message.sln", "Release|" + VVVV.Architecture, true);

CopyDir( Pack.TempDir + "\build\" + VVVV.Architecture + "\Release", VVVV.Dir + "\packs\vvvv-Message" ); CopyDir( Pack.TempDir + "\build\AnyCPU\Release", VVVV.Dir + "\packs\vvvv-Message" );

Note the “true” at the end of BuildSolution indicates automatic restoring of nuget packages.

Also note that I ditched mcropack for a while now and turned it into this weird network of smaller packs which are more fitted to a package manager like this. The entire thing is called md.ecosystem now which also includes VObjects, Leappack and will include Emeshe if I make it work again. Every pack in md.ecosystem (except Emeshe) is suited with a .vpack and for testing I’ll also include them here. For any brave pack developers out there come and work together on improving this concept and finally put an end to the manual contribution system. Contact me without hesitation if you have any questions.

Without further ado here’s the github repository for vpm:

Download it here: (read installation notes)

and here are some packs to test it with right away: (special links which should open vpm automatically) mp.essentials mp.dx mp.voocam mp.vaudio VObjects Leappack

Now time for some questions:

Why not nuget, chocolately or any other already existing package manager out there? Because non of them meets my requirement for a pack. A VVVV pack is a quite obscure thing. It can have any folder structure and any particular way of installing them. That’s also why I chose to use a powerful scripting language as a way to install the packs. Also some solutions like nuget require you to run a nuget server which I looked up and I came to the conclusion of no thanks. I rather like a decentralized solution.

How do I include a specific version of a dependency in my pack? You just point to a specific commit on github or a specific archive to download and extract in your script. See limitations about pack versions.

What are the current limitations? Currently versions of installed packs are not taken into account. vpm cannot be sure that the pack in your packs folder is the right version if it’s a dependency or is an older version if you install it from a .vpack file. Obviously it’s on the todo list but any ideas for implementing this is welcome. Also note vpm is a command line tool, there’s no fancy GUI for selecting from a pack repo and managing dependencies (I guess yet) but for a command line tool it’s pretty damn intuitive (thanks to PowerArgs library it’s awesome) vpm won’t take VVVV’s version into account because I found no way yet to determine version from the VVVV folder or executable, and presumes you have addonpack installed. Script files have to be online yet as I was lazy. Obviously this will be fixed shortly.

Future plans / Roadmap

  • Version aware management
  • If addonpack is not detected ask to download and install it automatically (would require some metadata from vvvv which would be its perfect complimentary addonpack and where would one get it from)
  • License agreement stuff. Will coming soon probably.
  • Separating the core into a vpm.core.dll so one can integrate it into their own software or plugin.
  • Actual documentation, which is coming very shortly


Comments are no longer accepted for this post.

28.05.2016 - 16:49
Awesome stuff microdee! Thanks a lot for the hard work, looking forward to using this!
28.05.2016 - 18:10

this is an amazing project… only thing i fear is that a commandline tool is a bit too linux 1998 style. in the age of apps its hard to promote text interfaces.

so how hard would it be to write a UI for packaging and browsing for it?

28.05.2016 - 18:37

not too hard there’s already a framework which wraps any command line tool into nice fancy responsive gui with switches sliders and dropboxes usign nw.js

browsing is a different problem. first idea I had in mind is using special git repositories which only contain vpack files and csx install scripts. A WPF app or a vvvv plugin/module can easily list and update that like NuGet in VS. That’s actually quite good idea ;)

31.05.2016 - 08:52
this is just great. thanks for your efforts!



vvvv - Dießl & Gregor GbR
Oranienstrasse 10
10997 Berlin/Germany
VAT: DE275566955


Follow us

Sign up for our Newsletter

Your subscription could not be saved. Please try again.
Your subscription has been successful.