Meander
Meander plugin module for VCV Rack
Install / Use
/learn @knchaffin/MeanderREADME
PurrSoftware Meander V1.0.11 plugin module for VCV Rack V1.
Contents
<a name="manual"></a> Manual

Caveat:
Anything I say here about music theory and practice as well as how I have implemented that theory and practice in Meander is my own understanding, which is surely not absolutely correct and musicians might choose to debate with me on that. There are also a lot of exceptions to the "rules" in music. If fact, it is these exceptions that give composers and musicians their own distinctive sound. In the end, it is all about what sounds good or entertaining or evokes certain feelings. From my perspective, there are no absolute rules in music. So, take what I say with a grain of salt.
Quickstart
Meander is self contained except for actual sound generation. It has it's own clock, so you do not need to connect a clock generator. The minimum configuration is to connect the Harmony 1V/Oct output to a polyphonic VCO and the VCO to a mixer or Audio output module. The sound will not be great, but that is the first step. Then connect the melody and bass 1V/Oct outputs to their own VCOs. The melody output is 1 channel monophonic. The bass output is 1 or 2 channel polyphonic. The harmony output is 3 or 4 channel polyphonic. Next steps are to add an ADSR and VCA for each part. The Meander gate outputs should control the ADSR trigger. Everything else is just icing on the cake.
General:
Meander is fundamentally a musical "expert" system that has quite a few rules for what makes western music sound good and applies those rules to "sequence" other sound generation modules. Meander has no audio sound generation or modification capabilities, so even though it is basically a complex application (which Meander is and has been over its 30+ year history), it is lightweight in terms of the load it puts on the CPU and DSP. Meander has its own internal clock, so no inputs are required in order to start making music.
Is Meander a generative or algorithmic composition engine? Probably, but I think of it more as an "improvisation system". I've tried to incorporate elements of how musicians improvise melody against a harmonic progression and bassline. The melody player might play scale runs, chord note runs and structured scale or chord note riffs or ostinatos in coordination with the harmony lead. Meander uses fBm time correlated noise to give fractal structure to the scale runs and chord arpeggios, while doing its best to sound good (or at least musical).
Meander is limited to western music heptatonic (7) note scales, primarily so that the chord rules can be uniformly applied. Meander is founded on the 7 modes and 12 roots (~keys) for 84 combinations of mode and root. The Circle of 5ths is the visualization device for seeing the mode and root harmonic intervals. The proper key signature notation is displayed inside of the circle of 5ths.
The Meander module panel is generated procedurally at runtime, rather than an relying on an SVG file. It has an SVG file but that only has the logo text.
Only one functional instance of Meander can be loaded from the VCV Rack plugin browser. If a second or other instance is loaded, the additional instances are disabled and the user is notified of that via a warning on the added panel image. This is due to the complex issues of porting a large stand alone Windows application to Rack, and the complications of having extensive global memory data and code.
All Meander panel control parameters can be controlled by an external 0-10V CV via the input jack just to the left of each parameter knob or button. No external control is necessary to use Meander. The CV control is there to allow you to do (almost) anything you can dream up.
The mode and root are selected by the control knobs on the far left side of the panel. As you rotate these knobs, the circle of 5ths will rotate to show the chords that should be played for this mode and root. The root will always be at the I degree position and is also designated by a red light just inside of the inner circle. Only the colored segments should be played. Each colored segment is marked with the chord "degree", which are the Roman numerals I-VII. The degrees are color coded as to whether the chord will be played as a major, minor or diminished chord. Major chord degrees are designated with uppercase Roman numerals whereas minor chord degrees are designated with lower case Roman numerals. A diminished chord degree is designated with a lowercase Roman numeral and a superscript "degree" symbol. All of this is done automatically by Meander, following music theory common practice.
Meander has 3 main music "parts" sub-panels: Harmony, Melody and Bass. The harmony drives the melody and the bass parts. The melody drives the arpeggiator (arp) sub-part. The arpeggiator is a melodic arpeggiator rather than a harmonic arpeggiator. Each of the parts can be enabled or disabled via the "Enable" buttons at the top of the subpanels. If the part is not enabled, Meander still composes that part (so that the harmony part is always available to the bass generator) but does not play that part.
Each part has three output ports at the bottom of the panel. Those are the 1V/octave, the gate and the volume outputs. The 1v/Oct output is typically connected to a VCO V/OCT input, whereas the Gate output is typcially connected to an ADSR gate input, which is connected to a VCA. Meander follows the Gate voltage standard, but not the common practice. The gate off state is 0V. The gate on state is >=2.1V . The gate on voltage also carries the volume for the note in the range of 2.1V-10V. Thus, the gate output can also be used to control volume by modulating a VCA or controlling an ADSR Sustain parameter, or the channel level on a mixer, etc. The gate could also be used as a CV for anything else you choose to use it for. The volume output is totally optional for anything you might want to use it for. It passes the part Volume setting out, but it may also be modulated by such things as bass part note accents. It can safely be ignored until you become more experienced with Meander.
A big aspect of Meander is that the harmony, melody and bass parts "meander" according to some fairly complex fractal based math. You do not have to worry about that unless you want to. Meander uses "fractal Brownian motion" for producing meandering patterns. The specic type of fBm variation is called 1/f noise and is made up of 1D quintic interpoldated Perlin noise, where the 1-D is time.
Each of the three parts is discussed following in more detail:
Harmony
Harmony is made up of chords made up of notes from the mode and root that is selected, as well as determined by the current circle of 5ths degree position chord type. A harmonic progression is the movement on the circle in steps over time. At the bottom of the Harmony sub-panel is the "Presets" control which allows you to select between 50+ ready-made harmonic progressions. Each progression is made up of from 1 to 16 steps, designated by the Roman numeral degrees I-VII, corresponding to to the degree positions on the circle for the current mode and root. I.E., the same progression can be played in any of the 84 mode and root "scales". As the pogression plays, you can watch the circle and see which chords are playing for each step. Each preset has an initial number of "steps". You can manually reduce the number of steps via the "Steps" knob, but you cannot increase it past the max value for that preset. The minimum number of steps is 1. Sometimes some interesting music can be created by setting the steps to 1, in which case the harmony stays on the root position of the circle, but may still meander through inversions and the melody and bass will follow.
Technically, Meander uses the "diatonic circle of fifths" rather than the "chromatic circle of fifths". The 7 degrees of the diatonic scale are designated in color on the Meander panel, whereas the 5 remaining degrees of the chromatic scale are rendered in gray. The music theory behind the circle-of-fifths is beyond this manual, but the basic theory is that triad chords next to each other on the colored (diatonic) part of the circle always share one note between them. Each degree going CW around the circle represents a 5th interval, thus the name circle of fifths. Going CCW, the interval is a 4th. The shared note between two chords going CW is a 5th above the tonic or root note of the first chord. Basically, the further away from each other two chords are on the circle, the more dissonance there will be. A common progression is to start out on the I position and then jump several positions CW on the circle and then walk back CCW on the circle back to the I position. Each step CCW gives a feeling of resolution of tension back to the I position. There are a myriad ways to form the progression, but there are a few progressions that almost all popular western music is composed of. Meander has 50+ such presets. One of the most common progressions in popular music is I-V-vi-IV , which is #26 in the presets. That same progression can be played in any of the 84 mode and root combinations, but may have s distinctly different feel in a different mode and root scale. Not all music is based on chord progressions, but a lot is, particularly popular music. Most progression based Western music limits the chord progression degrees to the 7 colored diatonic scale positions.
Note, whereas the harmonic "degrees" (the Roman numerals) meaning and roles are fixed by definition, other aspects such as "harmonic function" are context, style and composer specific and relative. In harmonic function analysis, chords are typically grouped using the circle of thirds as tonic, dominant a
Related Skills
node-connect
347.9kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
108.7kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
347.9kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
347.9kQQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
