» Debugging
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.


Italian | Mandarin | French

Patching pages

Error Console

In vvvv errors typically don't break the system. To see if your program experiences any troubles open a TTY Renderer which acts as vvvv's error console.

In fact it is a good idea to always have a Renderer (TTY) open to be aware of possible problems. Even if you don't understand what a particular error might suggest it may help people on the forum to understand your problem if you post the error there.

Finding erroneous nodes

When the TTY Renderer spits out an error similar to this:

00:00:28 ERR : Exception caused by node during update :/73/245/178/56/101/84

you can find the exact node causing this problem by using the Finder as follows:

The sequence "/73/245/178/56/101/84" in the error message above is a path of node IDs from the root to the actual node causing the problem. In order to find the node you start in the root and type "# 73" into the finder. This will show you the subpatch to open. In this subpatch again you use the finder now to find the second ID from the sequence by typing "# 245" in this example. Continue doing so until you reach the last ID which will point to the erroneous node.

Red nodes

A red node has either of 4 problems:

  • it has an input of type Enumeration that is not available on your PC.
  • it is missing
  • it is the wrong CPU architecture
  • it has a runtime error
Missing Enumeration

In the latter case you'll find the pin colored in red as well and can go there to choose a different value if available. Otherwise you may need to install a driver for the device you're trying to control.

Missing Node

If a node is missing, hovering it with the mouse will bring up a tooltip with the path to the file in which vvvv is expecting the node. You can now look for that file on your system and either:

  • dragdrop it onto any open patch which will cause vvvv to add the path of this file to its searchpaths for this session and the red node will magically be replaced. When now saving the patch this directory will be referenced for the formerly red node.
  • add a new searchpath manually in the Root patch
Wrong CPU architecture

Understand that vvvv and all addons come in two flavours: x86 (=32bit) and x64 (=64bit) and you cannot mix them! On modern PCs you'd typically use the x64 build. Only note that some nodes are missing in 64bit builds which would be a reason to still use the x86 builds.

Runtime Error

A node may be perfectly running for some time and only experience an occasional runtime error, in which case it turns red to indicate its problem and lead you to it. You have different options to deal with such red nodes:

  • ignore them if they don't do your program any harm. vvvv may still be running fine and only hint to you that this could be a problem under certain circumstances
  • sometimes it may help to re-initialize a node using ALT+rightclick on the node. But beware that even though this may help temporarily the problem may return at some later point
  • open Renderer (TTY) and see if there is an error message which you could post on the forum to ask for help
A classic example of a node turning red at runtime is the / (Value) when it computes a division by zero.

A division by zero won't break your program and you can simply ignore it. On the other hand it may give you an interesting hint about another problem in your patch upstream of the node.

Note that some nodes also have a (hidden) Error Handling Style which allows you to choose between coloring the node in red or simply ignoring such situations. Also a (hidden) Success gives you the option to handle an unsuccessful operation in a custom way.

Debug Timing


User either of

to keep an eye on your framerate.

Timing of the nodes

toggles debug-mode on/off globally.
toggles debug-mode on/off affecting only the currently selected nodes.

  • red: slice count changed
  • green: pin changed
  • blue: pin validated
  • white: changed but not validated

Values are expressed in micro seconds. So a value of 130 means 130µs or 0,13ms (milli seconds).

Round Brackets

A value in round brackets on a subpatch means that inside this patch not all nodes are being measured, ie. some have been selectively removed using SHIFT+CTRL+F9.

Consult the Performance page if you're looking for gerneral advice to optimize the performance of your patches.

Debug Spreads

toggles spreadcounts debug-mode on/off globally.

A link can have any of 4 styles:

  • dotted: when carrying ø
  • normal: when carrying 1 slice
  • thin: when carrying a slicecount less than half of the patch's maximum spreadcount
  • thick: when carrying a slicecount greater then half of the patch's maximum spreadcount
  • fat: when carrying the patch's maximum spreadcount

We hope this to be specifically useful when teaching beginners about spreads or hunting for large spreads or ø.

anonymous user login


~10h ago

bjoern: Yo peeps! I am looking for a job/project starting July. For contact info check: vvvv specialists available for hire

~29d ago

joreg: Summer Season 23 vvvv workshops are now ready for sign-up: https://thenodeinstitute.org/vvvv-intermediates-summer-2023/

~1mth ago

schlonzo: yeah! shader input pins now also visible, while the variable it not used!

~1mth ago

benju: Job opportunity, teaching Sounddesign for New Media purposes in Berlin (6hrs/week): https://www.letteverein.berlin/wp-content/uploads/2023/03/Ausschreibung_MIA_LK_6_UStd._Sounddesign_NEU.pdf

~1mth ago

joreg: vvvv gamma 5.0 is out! Please read all about it in the release notes: https://visualprogramming.net/blog/2023/vvvv-gamma-5.0-release

~2mth ago

domj: Coming to LPM next weekend? Learn more about one of the first full vvvv gamma apps, Schéma! https://liveperformersmeeting.net/editions/2023-muenster/program/detail/schema-talk/

~2mth ago

joreg: Want to get started with #vvvv? Check this 12 session beginner online course starting May 8th: https://thenodeinstitute.org/courses/vvvv-beginner-class-summer-2023/

~3mth ago

mediadog: @ggml Yup, lots. Only used in 4.x, haven't tried in 5.x yet: https://www.unrealengine.com/marketplace/en-US/product/simple-udp-tcp-socket-client