Installing the Module Designer

Theory of Operation Configuring the Module Designer Creating a Module Module Functions and Variables Module Programming Example Module Examples Included In Developer Kit

Module Controls

Knobs Digital Counters Switches Canvases Images Animations Text Labels Editable Text Labels Sliders Buttons Toggle Buttons Audio Input and Output Jacks VU Meters LEDs MIDI Input and Output Jacks

Module Designer Features

Using the Debugger The Module Background Dialog The Skin Editor Shortcuts and Hotkeys

Installing the Module Designer

Installing the Module Designer tool requires three main steps:

Install Voltage Modular
Run the Voltage Module Designer Installer
Install the Java Development Kit

NOTE: Voltage Modular and Module Designer use shared components. If you are updating Module Designer from a previous version, you must first install and open the latest version of Voltage Modular, and allow it to completely update its components and modules. Once that is completed, you may then install the updated version of Module Designer. The two applications will always share the same version number.

Voltage Module Designer requires the Java Development Kit (JDK) version 8 or above. Voltage Modular currently supports the Java 11 instruction set, but don't worry: newer versions of the Java Development Kit will compile code that's compatible with Java 11 when used with Voltage Module Designer.

There are two popular versions of the JDK available, the Oracle JDK and the OpenJDK. The Oracle JDK is free for personal use, but requires a commercial license for commercial use. The open-source OpenJDK is free for both personal and commercial use. As a result, we recommend installing the free OpenJDK. The current general release version of the OpenJDK is JDK 22. You can download the OpenJDK 22 Development Kit here:

OpenJDK 22 Release

Be sure to download and install the correct JDK version for your computer. “macOS” and “Windows x64” will be the most common downloads.

Windows Installation

The OpenJDK downloads as a zip file. Inside the zip file is a folder with a name similar to "jdk-15.0.1". You will want to copy this folder in its entirety to the folder %ProgramFiles%\Java\. For most users, this will be C:\Program Files\Java.

You will need to modify your Path to point to the Java JDK’s bin folder. Please see Oracle's Documentation for instructions. You’ll want to add something like C:\Program Files\Java\jdk-15.0.1\bin to your Path environment variable.

In addition, the Java Development Kit on Windows typically requires you to set the JAVA_HOME environment variable. Right click My Computer and select Properties. On the Advanced tab, select Environment Variables, and then edit JAVA_HOME to point to where the JDK software is located, for example, C:\Program Files\Java\jdk-15.0.1.

macOS Installation

The OpenJDK downloads as a tar.gz file. Inside the tar.gz file is a folder with a name similar to jdk-15.0.1.jdk. You will want to move this folder in its entirety to the folder /Library/Java/JavaVirtualMachines. (Note: moving the folder to this location will require that you to enter an administrator password.)

Verifying the Installation

Once you’ve run the JDK installer, open a Command Prompt in Windows or a Terminal on OSX, and type in the following command:

javac -version

You should see something like this in response:

javac 15.0.1

Be sure the version shown is the version that you installed. If the java or javac commands cannot be found, there may be an issue with your installation. If you’re using Windows, you probably forget to add the Java folder to your system path. See Oracle's Documentation for instructions.

Please Note: If you have JDK version 12 or newer installed, be careful not to use any JDK12+ commands in your Java module, because they won’t compile or work in Voltage Modular''s Java 11 virtual machine.

If your Java version is correct, and you’ve installed the Voltage Module Designer, then you’re done! Let’s start building modules!