v2.0.3-beta

Rack SDK v2.3.0
ansible v1.5.1 6eef788
earthsea v1.9.4 4b88b2e
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Installation instructions

NOTE: There are two macOS releases, for x64 (Intel Macs) and arm64 (M1/M2 Macs). Download the plugin that corresponds to the version of
VCV Rack 2.3.0 that you want to use. If you're not sure, you likely have the Intel x64 version -- the VCV Rack mac-arm64 release is
still in beta.

First, delete any previous versions (folders or .zip/.vcvplugin files) of the plugin from the plugins folder within your Rack2 user folder. Then download the .vcvplugin file for your platform from the links below. Place the file in your Rack2/plugins folder, and restart Rack.

The exact user folder location depends on your OS version and cloud-documents integrations, here are some suggestions to find it reliably:

• MacOS: Finder, Go menu, click Documents > Rack2/plugins
• Windows: Right-click Explorer on taskbar, click Documents > Rack2/plugins
• Linux: ~/.Rack2/plugins

Additional info is available in the Rack documentation on installing non-library plugins.

NOTE: For maximum safety, you may also want to export Teletype scenes from your favorite patches before upgrading.

Changelog from v2.0.2-beta to v2.0.3-beta:

• New connection UI for hardware and virtual grids:
  • Modules remember the last grid they were connected to, even if another module steals it.
  • Click the USB port on a module to reconnect to the last used grid (stealing it back if necessary.)
  • The USB port is filled with a "wireless nub" to skeuomorphically indicate an active grid connection.
  • The USB port widget is MIDI mappable with CCs using VCV MIDI-MAP, or CCs or notes with Stoermelder MIDI-CAT, so you can use a hardware controller (or a sequencer!) to swap a grid between multiple modules.
• Teletype
  • Added a Theme submenu to the right click menu, with the same color choices and levels as grid LEDs.
  • Added a clarifying message to the screen when Teletype is stopped because the audio engine isn't running.
• Virtual grids
  • LED levels now use nonlinear scaling to better match perceptual brightness of hardware. This should hopefully make Kria easier to read on the virtual grid.
  • Improved graphics on grid256.
• Update to Rack 2.3.0 SDK (plug-in will not load on earlier versions.)
• Fix a potential crash when entering non-numeric values in knob toolips
• General reliability work, including platform-specific fixes for M1 Macs and various flavors of Linux (#87, #127, #129, #133.)

v2.0.2-beta

Rack SDK v2.2.3
ansible v1.5.1 b6addda
earthsea v1.9.4 4b88b2e
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Installation instructions

First, delete any previous versions (folders or .zip/.vcvplugin files) of the plugin from the plugins folder within your Rack2 user folder. Then download the .vcvplugin file for your platform from the links below. Place the file in your Rack2/plugins folder, and restart Rack.

The exact user folder location depends on your OS version and cloud-documents integrations, here are some suggestions to find it reliably:

• MacOS: Finder, Go menu, click Documents > Rack2/plugins
• Windows: Right-click Explorer on taskbar, click Documents > Rack2/plugins
• Linux: ~/.Rack2/plugins

Additional info is available in the Rack documentation on installing non-library plugins.

NOTE: For maximum safety, you may also want to export Teletype scenes from your favorite patches before upgrading.

Changelog from v2.0.1-beta to v2.0.2-beta:

• Ansible trigger inputs now use Schmitt triggers like the White Whale and Meadowphysics inputs.
• Teletype's preview image in the module library now has some code on it.
• The Clock knob on Meadowphysics and White Whale is improved:
  • Meadowphysics shows the current clock divisor/multiplier on the Clock knob tooltip when an external clock is patched.
  • Entering a value by right-clicking the Clock knob now works correctly in both external and internal clock modes.
• Virtual grids have new "held keys" behavior. There are now two types of holding:
  • Ctrl-click (Cmd-click on Mac): Hold down multiple keys for as long as the Ctrl (or Cmd) key is held; when it's released, all held keys will be released.
    • This is useful for interactions like selecting a range by holding down two keys; hold Ctrl, click the start of the range, click the end of the range, release Ctrl.
    • This hold state is shown with a depressed key, just like a regular single click.
  • Ctrl-shift-click (Cmd-click on Mac): "Lock" a key down until you click it again to release it.
    • This is useful for entering "modes" or "pages" like Meadowphysics configuration mode, or Kria mod pages.
    • Hitting the Esc key, or Release Locked Keys from the right-click menu, will release all locked keys.
    • This lock state is shown with a dot on the key.
• Fix an issue that could in rare cases cause a crash when adding a grid-enabled module to a patch.
• Some technical debt has been tidied up in the audio process and the build system.

v2.0.1-beta

Rack SDK v2.2.2
ansible v1.5.1 b6addda
earthsea v1.9.4 4b88b2e
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Installation instructions

First, delete any previous versions (folders or .zip/.vcvplugin files) of the plugin from the plugins folder within your Rack2 user folder. Then download the .vcvplugin file for your platform from the links below. Place the file in your Rack2/plugins folder, and restart Rack.

The exact user folder location depends on your OS version and cloud-documents integrations, here are some suggestions to find it reliably:

• MacOS: Finder, Go menu, click Documents > Rack2/plugins
• Windows: Right-click Explorer on taskbar, click Documents > Rack2/plugins
• Linux: ~/.Rack2/plugins

Additional info is available in the Rack documentation on installing non-library plugins.

NOTE: For maximum safety, you may also want to export Teletype scenes from your favorite patches before upgrading.

Changelog from v2.0.0-alpha5 to v2.0.1-beta:

• Add the ansible module
  • Contains the beloved sequencer kria (with a hardware or virtual grid connected)
  • Also includes versions of earthsea and meadowphysics, with slightly different capabilities from the standalone modules (with a hardware or virtual grid connected)
  • ...plus CV generators levels and cycles (with a hardware arc controller connected)
  • ansible is a deep module and relies on press-and-hold gestures both with grids and its own panel buttons. Ctrl-click on grid buttons or KEY1/KEY2 to "hold" them.
  • virtual grids may need more love in order to effectively use kria; feedback welcome!
  • Not currently supported: the MIDI and "teletype expander" modes from the hardware
• Support for hardware monome arc controllers (arc2 and arc4, theoretically, but only arc4 has been tested)
  • Currently only the ansible module utilizes the arc
• Complete panel graphics for teletype and ansible, revise trilogy graphics
• Module manuals added to Info submenu / plugin.json
• Display the serialosc version in the right-click menu, and offer a link to the install docs if serialosc is not detected
• Fixes
  • Add Schmitt triggers to the teletype trigger inputs and meadowphysics/white whale clock inputs (2.2V on, 0.8V off, matching the hardware)
  • Correct behavior for meadowphysics external clock input
  • Display the correct clock period on meadowphysics and white whale clock knob tooltips
  • Display the correct internal values on the teletype PARAM knob tooltip, and accept text input of 14-bit PARAM values when right-clicking the knob
  • Fix the "Release Held Keys" command on virtual grids, which was broken in alpha5
  • Fix SPDX license string in plugin.json (thanks @falkTX)
• Build using the official Rack toolchain (thanks @cschol)
• Add Mac ARM64 as a prototype target for M1/M2 computers, for testing use only with the VCV Rack Mac ARM beta build.

v2.0.0-alpha5

Rack SDK v2.0.3
earthsea v1.9.4 4b88b2e
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Installation instructions

First, delete any previous versions (folders or .zip/.vcvplugin files) of the plugin from the plugins folder within your Rack2 user folder. Then download the .vcvplugin file for your platform from the links below. Place the file in your Rack2/plugins folder, and restart Rack.

The exact user folder location depends on your OS version and cloud-documents integrations, here are some suggestions to find it reliably:

• MacOS: Finder, Go menu, click Documents > Rack2/plugins
• Windows: Right-click Explorer on taskbar, click Documents > Rack2/plugins
• Linux: ~/.Rack2/plugins

Additional info is available in the Rack documentation on installing non-library plugins.

NOTE: For maximum safety, you may also want to export Teletype scenes from your favorite patches before upgrading.

Changelog from v1.0.0-alpha4 to v2.0.0-alpha5:

• VCV Rack 2 Free support
  • Graphics refresh to match Rack 2 aesthetic
  • More informative jack and knob tooltips
  • Streamlined right-click menus
  • Provisional support for VCV Rack 2 Pro VST
    • still testing different DAW/OS combinations; please share your observations
• New option to decrease I/O sampling rate for reduced CPU use
  • Modules primarily interact with control-rate signals, so processing I/O every step is unnecessary
  • Slight downsampling is enabled by default
  • I/O rate can be decreased even further, or increased back to audio-rate, from right-click menu
  • Timers and events always use wall-clock time and are not affected by downsampling
• Teletype improvements
  • Screen drawing uses less CPU
  • Screen should not glitch when the Rack engine is stopped (e.g., when no audio output device is selected)
  • Built-in scenes available as factory presets in right-click Presets menu
  • Importing to the active scene changes
    • New behavior for Active Scene > Import from file and Active Scene > Paste and init new scene from clipboard: active scene will be cleared, new script loaded, and I init script will run, just as if the scene had been loaded from flash memory.
    • Additional option Active Scene > Paste and merge clipboard into current scene keeps the alpha2/3/4 behavior; you can paste a scene fragment or pattern block into your current scene without changing the rest of the scene. The init script will not be run automatically, even if the clipboard includes it.
• Virtual grid improvements
  • Keys are now mappable with VCV MIDI Map
    • Note: VCV MIDI Map is unidirectional, with no LED feedback, so this is more useful for meta/alt keys than whole-grid MIDI mapping
  • Better handling of dragging across grid keys; previous key is released before next key is pressed
  • Keys held with Ctrl/Cmd-click are now drawn "pressed" rather than with a highlight ring
  • Grids have a more interesting preview image in the module library

v1.0.0-alpha4

Rack SDK v1.1.6
earthsea v1.9.4 4b88b2e
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Instructions

To install, download the .zip for your platform, place it in your Rack\plugins-v1 folder, and restart Rack. More detailed instructions are available in the Rack documentation on installing non-library plugins.

Changelog from v1.0.0-alpha3 to v1.0.0-alpha4:

• fix crash in earthsea when using the "double speed" rune too many times

v1.0.0-alpha3

Rack SDK v1.1.6
earthsea v1.9.4 6d12465
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Instructions

To install, download the .zip for your platform, place it in your Rack\plugins-v1 folder, and restart Rack. More detailed instructions are available in the Rack documentation on installing non-library plugins.

Changelog from v1.0.0-alpha2 to v1.0.0-alpha3:

• Fine tune "digital-analog" conversion on module inputs and outputs to more precisely match hardware behavior:
  • Centralize conversion math for all modules into one place.
  • Set teletype calibration data to get exactly 0-16383 out of 0-10V signals on IN, and the max range of PARAM.
  • Change trigger inputs to fire on rising edge crossing ~2.2V (rather than on any 0V to >0V transition.)
  • Add a small voltage offset to outputs to improve average V/Oct accuracy of 12-bit DAC conversion.
• Disable the Teletype screensaver.

v1.0.0-alpha2

Rack SDK v1.1.6
earthsea v1.9.4 6d12465
meadowphysics v2.1 39a2139
teletype v4.0.0 efd6503
white whale v1.5 6dfef61

Instructions

To install, download the .zip for your platform, place it in your Rack\plugins-v1 folder, and restart Rack. More detailed instructions are available in the Rack documentation on installing non-library plugins.

Changelog from v1.0.0-alpha1 to v1.0.0-alpha2:

Highlights include teletype scene import/export, improved grid communication, 256 support including a virtual 256, and lots of bug fixes.

teletype

• Import and export scenes from the right-click menu. Individual scenes can be read from/written to text files, or the entire set of scenes can be synchronized to a USB stick for exchange with hardware.
• Copy active scene to the clipboard / paste active scene from the clipboard (a @scanner-darkly suggestion)
• Re-focus the screen after using a right-click keyboard shortcut
• Fix: restore M timing immediately when loading a patch
• Implement DEVICE.FLIP (#66)

grids

• Rewritten grid-module serial communication layer
  • Adds support for 256 hardware (#28)
  • Restores support for Series and 40h grid hardware (#44)
    • note: not all module firmwares support 64/256, see #61
  • Fixes stuck notes in earthsea (#59)
  • Fixes flickering on 40h grids (#36)
  • Provides additional thread safety (#42)
• Fix: eliminate a potential crash when unplugging a hardware grid from USB
• Fix: update the VCV Rack patch correctly when manually reassigning a grid to a new module
• Fix: always clear grid when disconnecting, regardless of method
• Virtual grid improvements
  • Virtual 256 added (#28)
  • Selectable LED color and protocol in right-click menu, for older device emulation (#44)
  • Revamped aesthetics
  • Deadzones between keys removed, entire surface is clickable
  • Improved dragging behavior

general

• Use double-precision floats for internal clock phase in all modules
• Display module firmware version & git commit hash in right-click menu
• Fix: preset glyphs are saved correctly in trilogy modules (#6)

v1.0.0-alpha1

To install, download the .zip for your platform, place it in your Rack\plugins-v1 folder, and restart Rack. More detailed instructions are available in the Rack documentation on installing non-library plugins.

• Rack version: 1.1.6
• Teletype 4.0.0 (plus upstream post 4.0.0 fixes up to b93538)
• Latest trilogy modules (July 2021)

Changelog from pre-alpha to alpha1:

• Teletype PARAM and IN ranges were off by 4 (#53)
• Keyboard shortcuts on Teletype right-click menu
• Minor updates to Teletype graphics
• The Initialize command now resets the firmware state
• Other firmware loading infrastructure changes & prep for future features
• New CI configuration for versioned releases
  • Windows and macOS are built native rather than cross-compiled
  • Using newer compilers on all three platforms (see GitHub docs for versions)
  • Linux builds have moved from Ubuntu 16.04 to 20.04; may drop support for older distros

pre-alpha release

Updated 9/5/2021. The Teletype module is now in the main branch.

• Rack version: 1.1.6
• Teletype 4.0.0 (plus upstream post 4.0.0 fixes up to b93538)
• Latest trilogy modules (July 2021)

Follow these instructions in the Rack documentation to add this package to your Rack installation.

Changelog from 0.6 to 1.0.0-pre:

• Most known, reproducible issues with 0.6 have been fixed (crashes on grid disconnect, etc.)
• Support for older grid hardware (40h/series protocols) has been temporarily removed. (#44)
• The virtual grid modules can only be used if your thread count is set to 1. Communication between modules and virtual grids is not yet thread-safe. (#42)
• Future feature roadmap is online here. (No promises, just documentation of the current thinking.)

pre-pre-alpha

This tag has been retired -- go to the main releases page for the latest release.