1 · How Khorlo works
| Part | What it does |
|---|---|
| String | One of eight sound sources placed around the cylinder. Pitch is relative to the key you play. Position sets when a plucker reaches it. Each string can use a String, Beam, Bell, Bowl, Membrane, or Plate resonator. |
| Plucker | A ring with a contact point that travels around the cylinder. Rate sets its speed. Each of the eight pluckers can run at a different rate and strike a different selection of strings. |
| Exciter | The shape of the strike. Change it to make the attack sharper, rounder, or noisier. |
| Voice | One note, with its own eight strings and pluckers. At the voice limit, a new note takes over from the oldest one. Set the limit in AMP. |
The cylinder itself doesn't move. The contact points move at the rates you set. A plucker at 2 Hz crosses eight evenly spaced strings sixteen times a second. Move a string to change its timing. Add a second plucker at another rate to create an overlapping rhythm.
The four pages
| SYNTH | Pluckers on the left, strings on the right, and the 3D view between them. |
| EFFECTS | Twelve effects applied to the combined output. Drag them to change their order. |
| ROUTINGS | All modulation routes in one table, and the MIDI CC column that sets which controller drives each CC source. |
| PRESETS | Browse, save, and organize presets using folders, tags, and favorites. Click the preset name in the header to open it. |
SYNTH, EFFECTS, and ROUTINGS share the bottom row: MACROS and RANDOM on the left, the MOD panel in the middle, and AMP and the two voice filters on the right.
The header has the ☰ menu, the SYNTH, EFFECTS, ROUTINGS, and GLOBAL tabs, the preset name with its previous/next arrows, SAVE, INIT (a new patch, from any page), and the master volume dial (double-click for −6 dB). Hover over a control to see what it does in the tips line under the header. Messages such as Loaded, Undo, and Panic show there too. You can turn the descriptions off under GLOBAL › PREFERENCES.
In your DAW, send Khorlo MIDI notes to play it. Tempo-synced controls follow the host's clock. The sustain pedal (CC 64) holds notes after you let go of the keys. The download is VST3, AU, and CLAP. There is no standalone app.
Editing the 3D view
The view shows string vibration and plucker movement while notes sound. You can edit the instrument directly:
- Drag a plucker ring vertically for Height or sideways for Offset.
- Drag its bright start marker sideways for Rate or vertically for Strength.
- Drag a string's head around the cylinder for Position. Drag its wire vertically for Pitch.
- Hold Option and Command (Alt and Ctrl on Windows) while adjusting Position or Offset to snap to eighths of a revolution (45°).
- Hold Shift for finer changes.
P1 has no Offset and S1 has no Position. Both sit at 0°, the point every other plucker and string is measured from. Modulation can't move S1. The 3D handles also accept modulation cables.
2 · Your first sound
The first-run tour walks through the main controls. Open it again from ☰ › Getting started, or try this:
- Click the preset name in the header to open PRESETS, then click INIT to reset the patch. Click SYNTH to return.
- Hold a MIDI note. P1 starts moving and strikes S1.
- Click the S2 tab to turn on a second string. Its different Position adds another strike to the loop.
- Adjust S2's Pitch and Position to change its note and timing.
- Move P1 Rate to speed up or slow down the pattern.
- Choose an exciter shape from the five buttons in the middle of P1, beside its pad. Each button draws the strike it makes. Listen to how the attack changes.
- Raise Rate further to try a sustained tone. Lower Strength if you want a lighter sound.
The cards open at full width. The arrow at the inner end of the P or S bank tabs folds all four cards in that column to their main controls. Click it again to open them. Folded plucker cards hide the exciter buttons and pad.
Khorlo remembers how you left the window: the page, which banks are showing and whether they are folded, the MOD tab, the AMP or FILTER tab, and MACROS or RANDOM. Each instance in your project keeps its own.
3 · Pluckers
The left column shows four plucker cards at a time. Use the P1–P4 and P5–P8 bank tabs to switch sets. Click a numbered card tab to turn it on or off. Shift-click to solo it.
| Control | What it does |
|---|---|
| Rate | Revolutions per second, from 0.05 to 64 Hz in free mode. Higher rates move from separate plucks to sustained textures. Modulation can extend the rate beyond the slider's range. |
| Height | Where along the string the plucker strikes. Lower is rounder, higher is brighter. |
| Strength | Strike force. Higher settings are louder and brighter, with more saturation. It also controls the strength of bowed sustain. |
| Offset | The contact point's starting position around the cylinder, in degrees (0° to 360°). Use it to shift a plucker's timing relative to the others. P1 has no Offset. |
| Attack | Softens the start of the strike. Raise it for a gentler attack. |
Choosing which strings to strike
The eight numbered buttons at the bottom of each card select the strings that plucker can strike. All eight are enabled by default. Click a number to skip that string.
Try sending P1 to strings 1 and 2, and P2 to strings 3 through 8. Give the pluckers different rates for a slow bass pattern and a faster top line. A string must also be switched on to sound. Locked pluckers share this selection.
Loop and once
Click the icon beside Rate to choose loop or once. Loop repeats while the note is held. Once travels one revolution per note and stops.
Free, tempo, and linked rates
Click SNC beside a card to cycle its rate mode. P1 offers Free and Tempo. P2–P8 also offer LNK.
- Free: Set Rate in hertz.
- Tempo: Choose a beat division. Click the rate field, scroll over it, or right-click to type a division. Each division sets the length of a full revolution. At 1/4 with eight active strings, one revolution produces eight strikes per quarter note. Modulating Rate steps from one division to the next, so the pattern stays on the beat.
- LNK: Set a ratio of P1's rate from two menus, each 1 to 32. The ratio reads P1 : this plucker. 4 : 1 runs at one quarter of P1's speed. 1 : 8 runs eight times faster. 3 : 2 is three turns of P1 for every two of this plucker, and 7 : 5 or 32 : 31 are there for patterns that repeat only after many bars. A linked plucker follows P1 in every note, including any modulation on P1's Rate.
Exciter shapes
Choose from the five buttons in the middle of the card, beside its pad. Each button draws the strike it would make at the card's current Hardness, Width, and Noise, so you can see the difference before you hear it.
| Impulse | A sharp, bright strike. |
| Half-sine | A rounder strike, like a soft mallet. |
| Exp | A fast attack with a short decaying tail. |
| Saw | An asymmetric, buzzy strike. |
| Burst | A short burst of noise. This is the default exciter. |
The exciter pad
The pad shapes the strike itself, and most of a sound's character is decided here. The picture in it is the strike, drawn for one cycle of a C3 (about 8 ms), and it changes as you move the controls. A first strike on a quiet string writes the whole picture into the string. A strike on a string that is still ringing writes only its first 4 ms, then fades out. Drag inside it, or use the H, W, and N sliders beside it, which set the same three values in the same order:
| Hardness | Drag up for a harder striker. Higher Hardness gives a brighter strike. |
| Contact Width | Drag right to widen the contact. A wider contact softens the top end. |
| Noise | Right-drag in the pad to set it. On Burst, Noise blends the plain string at 0% into pure noise at 100%. The noise takes on the color of the string or object it plays and lasts as long as it rings, so Decay and Brightness shape it too. On the other shapes, Noise adds a scrape to the start of each strike. |
Right-click a slider to enter an exact value. Shift-drag inside the pad for finer changes.
4 · Strings
The right column works like the plucker column. Switch banks with S1–S4 and S5–S8. Click a numbered tab to turn a string on or off, or Shift-click to solo it.
| Control | What it does |
|---|---|
| Pitch | Tunes the string up to 24 semitones above or below the played note, in semitone steps. Every string, including S1, is tuned relative to your MIDI note. |
| Detune | Adds a fine offset of up to one semitone either way. Small differences between strings create beating and an ensemble sound. |
| Pan | Places the string in stereo. Strings start centered. |
| Position | Places the string around the cylinder, in degrees (0° to 360°), and changes when pluckers reach it. S1 always sits at 0° and has no Position. |
| Wash | Makes repeated strikes blend into a sustained wash. Higher settings reduce each new strike according to how strongly the string is already ringing. |
| Decay | Sets the string's ring time. The slider reads about 0.05 to 3 seconds. The resonator, pitch, and damping also affect the tail. |
| Level | Sets this string's volume, from silence to +6 dB. The vertical fader is beside the resonator buttons. Double-click for 0 dB. It also accepts modulation. |
Expanded controls
| Stiffness | Stretches the overtones apart. Small amounts add a piano-like or metallic character. Larger amounts can sound bell-like. |
| Brightness | Controls how long the high frequencies survive. Low settings sound muted. High settings let the top end ring. |
| Drive | Adds saturation. On strings, strong attacks can start sharp and settle as the sound decays. The other resonator types saturate without this pitch bend. |
| Spread | Detunes the second resonating body by up to a semitone. It only affects the sound when Coupling is above zero. |
| Coupling | Adds a second resonating body for a doubled, beating sound. Set Coupling first, then adjust Spread. This increases CPU use. |
Coupling and Spread work within one string. They do not couple separate strings or set stereo width. Use Pan to position strings in stereo.
Resonator types
The six buttons on each string card select its resonator:
| String | A modeled plucked string. The default. |
| Beam | A struck bar with widely spaced overtones. Try it for mallet sounds. |
| Bell | A bell with a low hum and a cluster of ringing overtones. |
| Bowl | A singing bowl with widely spaced partials. |
| Membrane | A drumhead for tuned and noisy percussion. |
| Plate | A dense metallic sound with closely spaced partials. |
The controls stay available for every type. On the five non-string resonators, Stiffness changes the spacing of the partials, Decay controls their ring times, and Coupling adds detuned copies whose tuning is set by Spread. The first strike of a note on Beam, Bell, Bowl, Membrane, or Plate comes in at full strength, like the strikes after it.
5 · Gestures and locking
| Gesture | Action |
|---|---|
| Drag | Adjust a control. |
| Shift-drag | Fine adjustment, on every control. |
| Option-drag (Alt) on a P/S slider | Adjust the property across all eight pluckers or strings, keeping their relative offsets until a value reaches its limit. P1's Offset and S1's Position stay at 0. |
| Option-Command-drag (Alt-Ctrl) on Position or Offset | Snap to eighths of a revolution (45°). |
| Double-click a value control | Reset it. Most sliders return to the middle. Exciter controls return to neutral, string Level and effect OUT to 0 dB, and limiter INPUT to 0 dB. Offset and Position go back to where a fresh card starts. On a MOD amount, double-click sets the amount to 0 and keeps the route. |
| Right-click a value control | Enter an exact value. Offset and Position take degrees. The exciter pad uses right-drag for Noise instead. |
| ⌘ / Ctrl-drag | Adjust modulation depth on a modulated control. |
| Mouse wheel on Rate | Step through tempo divisions. |
Arrow keys depend on what you are editing. See Keyboard shortcuts.
Tab menus
Right-click a tab for these actions:
| Numbered P or S tab | Turn on or off, Solo, Copy, Paste, Paste to all, Lock to…, Keytrack (strings) or Trigger from DAW (pluckers), Randomize, and Reset. |
| P or S bank tab | All on, All off, Only the first, Spread offsets evenly (pluckers) or Spread positions evenly (strings), Randomize all, Unlock all, and Reset all. These actions cover all eight cards. |
| MOD tab | Show, Copy, Paste, Clear destinations, and Reset. |
Paste to all keeps each string's Position or plucker's Offset. To distribute the positions evenly, choose Spread positions evenly or Spread offsets evenly from the bank menu.
Drones and DAW-played pluckers
Untick Keytrack on a string's tab and the string drones: it plays at C3 plus its Pitch and Detune whatever key you press, and ignores glide and the pitch wheel. A dot beside its pitch icon shows it.
Tick Trigger from DAW on a plucker's tab and the plucker plays while your DAW is playing, with no key held, and keys no longer start it. In TEMPO it stays on the DAW's beat. A dot beside its rate icon shows it. Pair it with a drone string, and a plucker that keys trigger, to play over a part that runs on its own.
Locking cards together
Right-click a numbered tab and choose Lock to…. The tab gains a padlock with the other card's color. Editing either card updates the shared properties on both.
- Locked pluckers keep separate Offsets.
- Locked strings keep separate Pitches and Positions.
- On/off remains independent for every card.
You cannot lock another card to a card that is already following one. Choose Unlock from its menu to separate it, or Unlock all from the bank menu.
6 · Modulation and macros
MOD1–MOD6 use shapes you draw. Each holds up to six destinations. CTRL 1 and CTRL 2 use incoming controls such as velocity, macros, MPE expression, and your MIDI controller. Each holds nine slots, with a separate source and destination per slot. Both offer the same sources.
Assigning modulation
Drag a MOD tab onto the control you want to move. Available targets light up as you drag. You can route to P and S sliders, exciter controls, AMP and filter dials, effect dials, and 3D handles.
You can also click a destination slot to open the destination picker (MOD1 DESTINATION, and so on). Browse its groups or search for a control by name. Click a filled slot to change its destination, or choose Clear slot at the foot of the picker to remove the route.
| Amount | How far the route moves the control, from -100% to +100%. Below 0 it moves the control the other way. The dial fills clockwise from the top for a positive amount and the other way for a negative one. Drag the amount dial, or right-click it to type a value. Double-click sets it to 0, which stops its effect but leaves the route assigned. |
| UNI | Moves one way from the value you set: up for a positive amount, down for a negative one. |
| BI | Moves in both directions around the value you set. A negative amount turns the movement upside down. |
Click UNI or BI, or right-click the route's name, to switch between them. Presets made before this version load and sound the same: a route that moved down is now UNI with a negative amount.
To delete a route, choose Clear slot in its picker or click its × on the ROUTINGS page. To remove every route from a MOD, right-click its tab and choose Clear destinations.
A modulated slider shows a range line for its reach and a colored mark for its current value. The displayed reach also responds to the route's velocity influence.
On CTRL 1 and CTRL 2, each slot also has a source. Click it to choose from a grouped list, with search: Keyboard, MIDI CC, Macros, Plucker Rings, and Other.
Drawing shapes
- Drag a node to move it.
- Drag between nodes to bend the segment.
- Double-click a straight segment to add a node. Double-click a node to remove it.
- Drag across empty space to select several nodes and move them together.
- Press Delete or Backspace to remove the selected nodes.
- Double-click a bent segment to straighten it. Hold Option (Alt) to straighten every one.
- Hold Shift while dragging for finer moves. Hold Option (Alt) and drag to bend every segment together. Hold Option and Command (Alt and Ctrl) to land a node on the grid lines.
- In Envelope mode, right-click a node to make it the sustain point.
Use the shape menu for starting points including Ramp, Saw, Triangle, Sine, Square, Pulse, Exp, Log, AD, ADSR, and Steps. Choose + save current shape… to keep your own. Saved shapes are listed under MY SHAPES, and the menu's Delete list removes them. FREE sets the shape's length in seconds. SYNC locks it to a note division of the tempo.
| Mode | Playback |
|---|---|
| Trigger | Runs once for each note, using the shape's length. |
| Free Run | Cycles continuously as an LFO, whatever you play. It can sync to tempo. |
| Envelope | Holds at the sustain node while the key is down, then plays the rest of the shape when you release the key. |
| One-shot | Plays through once, ignoring key release. |
In Trigger, Envelope, and One-shot, every note runs its own copy of the shape. Each note's pluckers, strings, and filters move on their own, starting when that note starts and following its own release. In Free Run, all notes share one cycle.
CTRL 1 and CTRL 2 sources
| Note / Velocity | The played key and how hard you played it. Each voice reads its own values for per-voice destinations. |
| Mod Wheel / Pitch Wheel / Aftertouch | Controller values shared across the instrument. With MPE enabled, per-note pressure is available through Pressure. |
| Macro 1 to Macro 4 | The four dials in the MACROS panel at the bottom left. |
| Pressure / Slide | Per-note pressure and Slide (CC74) in MPE mode. Enable MPE under GLOBAL › PREFERENCES. |
| P1 Ring–P8 Ring | A ramp falling from 1 to 0 over each plucker revolution. Each voice has its own ramps. Most useful at rhythmic rates. Higher rates produce increasingly coarse modulation. |
| Random | A new random value for each note, chosen when the note starts and held until it ends. Each note of a chord gets its own. |
| Constant | Always full. The route moves its destination by a fixed amount: the depth. |
| Expression / Breath / Foot / CC A to CC E | Your MIDI controller. Each listens to one CC, which you choose on the ROUTINGS page (see below). Shared across the instrument, like the Mod Wheel. |
MIDI controllers
Eight sources come from your hardware: Expression, Breath, Foot, and five free ones, CC A, CC B, CC C, CC D, and CC E. Route them on CTRL 1 or CTRL 2 like any other source, with amount, polarity, and velocity.
Which CC drives each one is set in the MIDI CC column on the ROUTINGS page. The defaults are Expression 11, Breath 2, Foot 4, CC A 74, CC B 75, CC C 76, CC D 77, and CC E 78. Click a CC and move a control on your hardware to learn it (Esc cancels), pick one from the list under the arrow beside it, or right-click to type a number. The list opens with the Common CCs by name, then every number in ranges, with search. Choose None at its foot to leave a source free.
With MPE on, Slide uses CC 74, so a source set to CC 74 rests until you turn MPE off.
To move a dial from your hardware, route one of these sources to it. Dials have no MIDI learn of their own.
The CC numbers belong to your setup, not to presets. A preset that uses Expression plays with whatever control you have set as Expression. They are saved with each project and as the default for new instances.
Macros
The four macro dials do nothing until you give them a job. Pick Macro 1, 2, 3, or 4 as the source in a CTRL 1 or CTRL 2 slot, then choose a destination and amount. Give the same macro several slots and one dial moves several controls at once.
Click the name field beside a macro to label it. Its source name remains Macro 1–4 in the routing menus. Assigned macros light up and show their destination count.
Random patches
The RANDOM tab sits beside MACROS. Click TAME for a new patch that stays playable and musical, or WILD for one that can reach anything Khorlo can do. The tab stays open, so you can roll as many times as you like. Undo brings back the patch before.
Below the rolls are two KEEP boxes, one labeled STRINGS and one labeled EFFECTS. Check one to keep your strings or your effects as they are on every roll. Unchecked, a roll makes new ones.
Changing the whole pattern
Four destinations act on all eight pluckers or strings at once: Plucker Spread, String Spread, Plucker Random, and String Random. They sit under Global in the destination picker, and on the ROUTINGS page, beside Volume and Glide. Spread fans the positions apart. Random scatters them. Use these for timing changes across the whole set, or modulate individual string Positions for smaller changes.
Modulating another MOD
A MOD can control another MOD's rate or destination amounts. For example, use an envelope to fade in an LFO's effect. Drop the cable onto a MOD's rate field or numbered amount dial.
To reach another MOD's slots while dragging, pause over its tab until it opens, then continue to the target. A MOD cannot target itself.
The ROUTINGS page
Each row represents one route, listed in two columns. Changes here also appear in the MOD panel. The MIDI CC column on the right sets which CC drives each of the six controller sources.
| Source | The MOD or controller driving the route. Click to change it. Picking one of MOD1 to MOD6 moves the route to that MOD. On a CTRL route, picking another source changes it. On a MOD route, picking a macro moves the route to CTRL 1, and any other source moves it to CTRL 2. |
| Destination | The control being moved. Click to choose another. Inactive or unavailable destinations appear dimmed and struck through. |
| Amount | Depth from -100% to +100%. Below 0 it moves the control the other way. Drag sideways or right-click to type a value. Double-click sets it to 0. |
| UNI / BI | Click to switch. UNI moves one way from the value you set, BI moves both ways around it. |
| Velocity | How much note velocity scales the route's depth. Drag or right-click to enter a value. This is unavailable when the source is already Velocity. |
| × | Delete the route. |
Several sources can affect the same destination. For example, a macro can set the filter's opening while an envelope adds movement on each note.
Velocity per route
At 0%, the route's depth ignores velocity. At 100%, a soft note gets less modulation and a hard note gets the full amount. At 50%, a note played at half velocity gets three-quarters of the set depth.
Set this separately for each route. One MOD can open the filter more on hard notes while its vibrato route stays unchanged. Per-voice targets follow each note. Shared targets such as effects act on the combined sound.
7 · Amp and filters
The bottom-right panel has three tabs: AMP, FILTER 1, and FILTER 2.
AMP
| Attack / Decay / Sustain / Release | The amplitude envelope for each voice. Attack controls the fade-in, Decay moves toward the Sustain level, and Release controls the fade after you let go. |
| Vel | How much velocity affects strike strength. At zero, strike strength ignores velocity. Routes using Velocity can still change the sound. |
| Glide | Slides the pitch between notes in the two mono modes, Retrig and Legato. It does nothing in Poly. It is also a destination, under Global: a route adds to this dial, so a MOD or a macro can make notes slide or snap. |
| Build | How quickly a bowed string swells. Zero is immediate. Higher values build more slowly. It does not set the release time or stop a stuck note. |
| Bend | The pitch-bend wheel's range above and below the played note. |
| Voices | How many notes can sound at once, from 1 to 16, release tails included. When a new note needs a voice, the oldest tail gives way first, then the oldest held note, with a short fade. Fewer voices use less CPU. The mode menu offers Poly, Retrig, and Legato. |
The filter pair
Each voice has two filters. Click the dot on a filter tab to enable or bypass it without switching tabs. Both filters are off in INIT.
| TYPE | Opens a picker with the model on the left and its modes on the right. |
| FREQ | Filter cutoff. On Vocal, it shifts the vowel's frequencies. |
| RESO | Emphasizes frequencies around the cutoff. Higher settings can ring or self-oscillate, depending on the model. |
| DRIVE | Pushes more signal into the filter for saturation. |
| CHAR | A model-specific character control. See the table below or hover over it for a description. |
| ROUTING | SERIAL sends filter 1 into filter 2. PARALLEL sends the voice into both and mixes their outputs. |
| WET / MIX | In SERIAL, WET blends the dry voice with the filtered signal. In PARALLEL, MIX balances filter 1 against filter 2. Each mode remembers its own setting. |
| Model | Sound and CHAR control |
|---|---|
| Clean | A neutral filter. CHAR tilts the sound darker or brighter. |
| DMF | A softer filter. CHAR adds warmth. |
| Hybrid | A four-pole ladder with two personalities. At low CHAR it is smooth and polite, with the resonance held in check. Turn CHAR up and it gets rawer and dirtier, the resonance bites harder and the low end fills out. Nothing switches over. It slides between the two. |
| Cascade | A warm four-pole ladder whose level holds steady as the resonance rises. CHAR bends the soft clipper inside the resonance loop, which rounds and thickens the sound. You hear it mostly with DRIVE up. |
| Squelch | The acid-style diode ladder. CHAR thins the bass inside the resonance loop, so the sound gets more nasal and grittier as you turn it up. |
| Scream | A resonant filter with the distortion built into its resonance. It starts screaming around seven tenths of RESO. CHAR hardens that distortion a little. It is a subtle control on this model. |
| Comb | A tuned echo with a metallic, hollow sound. CHAR controls damping. |
| Allpass | Phaser-like sweeps. CHAR spreads the stages. |
| Vocal | Vowel sounds. CHAR selects A, E, I, O, or U. |
Six models offer seven modes, listed gentle to steep: Low 12, Low 24, High 12, High 24, Band 6, Band 12, and Band 24. The number describes the slope in dB per octave. Comb, Allpass, and Vocal have no mode selection.
FREQ, RESO, DRIVE, CHAR, MIX, and WET accept modulation. In the destination picker, MIX and WET are Filter 1/2 Mix and Filter 1/2 Wet under Voice Filter. Use a MOD in Envelope mode for a filter envelope. Changing the model or mode resets that filter, so it can interrupt a ringing sound.
8 · Effects
The EFFECTS page processes the combined output of the voices. It shows the effects in your chain, and the sound runs through them in reading order: left to right along the top row, then along the bottom row. Ten cards fill the page, five across and two down. With more, the page scrolls sideways: drag any empty part of it, or the thin bar at the bottom.
A new instance and INIT start with Equalizer 1, Delay, Reverb and Limiter, the first three bypassed.
| Effect | What it does |
|---|---|
| Chorus | Thickens the sound with delayed, detuned copies. Choose 4, 8, 16, or 32 voices. Short delays thicken. Longer delays create more separation. |
| Compressor | Controls level changes. Choose Single band or Multiband and a VCA, FET, or Opto model. In Multiband each band, LOW, MID and HIGH, has its own THRESH and GAIN; LOW X-OVER and HIGH X-OVER set where the bands split, and TIME sets how fast all three respond. You can also drag a band's threshold up and down in the display. |
| Delay | Mono, Stereo, or Ping-pong repeats, with free or tempo-synced timing and a filter in the feedback path. The chosen filter determines how the repeats change. |
| Saturation | Four MODEL choices: Tube, a two-stage overdrive with SAG; Tape, with HYST and SPEED; Wavefolder, with FOLD; and Diode, a tight clipper. DRIVE sets how hard the signal is pushed, and TONE makes it darker or brighter. BIAS, on every model but Tape, adds asymmetry. |
| Distortion | A distortion pedal, separate from Saturation, so you can use both. Three MODEL choices: Overdrive, warm, with the bass kept clean; Distortion, hard and biting; and Fuzz, thick, with a scooped middle. DRIVE is the pedal's gain in dB. Even at 0 it is a little dirty, as a pedal is; MIX blends the clean sound back in. TONE runs from dark to bright on every model. BIAS, on the Fuzz only, is its battery: 9 V in the middle, lower for a starved, sputtering fuzz, higher for a cleaner one. The level stays about the same as you turn DRIVE. It adds 6 samples of delay, which your DAW compensates. |
| Equalizer 1, Equalizer 2 | Two equalizers with the same controls, so you can shape the sound before and after another effect. Three bands. LOW and HIGH can each be a Cut (12, 24, or 48 dB per octave), a Shelf, or a Bell. MID can be a Bell, a Notch, a Band pass, or a Tilt. Click a band's header to choose its shape. Each band has FREQ, Q, and GAIN dials. A Cut, a Notch, and a Band pass have no GAIN. |
| Filter | The same nine models and seven modes as the voice filters, applied to the combined sound. |
| Flanger | A short, swept delay with feedback for metallic sweeps. |
| Phaser | Sweeping notches for a rounder swirling effect. |
| Reverb | Room, Plate, Hall, or Cave spaces. Decay sets the tail, Pre Delay separates it from the original sound, Width sets the stereo spread, and Low Cut and High Cut shape its tone. Early sets the level of the first reflections. Diffuse smears them out. |
| Limiter | Reduces peaks. It starts last in INIT, but can be moved like any other effect. While it is last, an effect you add goes in front of it. |
Effect controls
- The EFFECTS switch above the first card turns the whole chain on or off, so you can hear the dry sound. Each effect keeps its own setting.
- + ADD EFFECT, beside the EFFECTS switch, lists the effects not in your chain. The one you pick goes at the end of the chain, switched on.
- The × in a card's top-right corner takes that effect out of the chain and switches it off. Its settings are kept, so adding it back brings it back as it was.
- Click the dot or name in a card's header to enable or bypass that effect.
- Drag the nine-dot grip beside the × to reorder the chain.
- Each header has two small dials. MIX blends the effect with its input (every effect except the equalizers has it). OUT sets its output level, up to +12 dB. The red dot marks 0 dB. Turn a dial to see its value, right-click to type one, double-click to reset. When MIX is modulated, its ring shows how far the routes can move it and where it is now.
- Chorus, Delay, Flanger, and Phaser have a TEMPO SYNC switch. With it on, the rate dial steps through note lengths. On Chorus, Flanger, and Phaser, the last step is Stop, where the dial becomes SWEEP and sets the sweep's position.
- The Delay and Filter cards have a filter TYPE field. It opens the same FILTER TYPE picker as the voice filters.
- Drag a MOD tab onto a dial to modulate it.
Presets store which effects are in the chain, their settings and their order. An effect added to Khorlo after a preset was saved (Equalizer 2, Distortion) loads switched off and out of the chain. Loading a preset can enable or bypass the limiter, so check its state when you need peak control.
Limiter
The limiter reduces gain and rounds off remaining peaks with a ceiling curve. It has no look-ahead in this release.
| INPUT | Input gain in dB. Turn it clockwise for more gain and limiting. Double-click for 0 dB. |
| CEILING | The maximum level of the limited signal. |
| ATTACK | How quickly gain reduction responds. Slower settings let more of the transient reach the ceiling curve. |
| RELEASE | How quickly gain recovers. Fast settings can pump. Slower settings hold the reduction longer. |
| CHAR | How softly the ceiling rounds peaks. Higher settings soften more of the signal near the ceiling. |
| LINK | How much the channels share gain reduction. Full keeps their gain changes together. Zero lets each channel respond on its own. |
| MIX | In the card's header. Blends the limited signal with the unlimited input. |
| MODEL | Clean, Punch, Warm, or Crush. Changes the response from transparent limiting to more obvious pumping and saturation. |
The display shows the ceiling and limiter response, with live output and gain-reduction information while audio plays. Drag horizontally for INPUT or vertically for CEILING.
INIT starts with the limiter on, INPUT at 0 dB, and CEILING at −0.1 dB. The soft knee and ceiling curve can affect signals below the ceiling.
9 · Presets
Click the preset name in the header to open PRESETS, where you browse and organize your library. Click a tab such as SYNTH to go back. The header's arrows step through the folder of the loaded preset while you stay on another page. SAVE lights up when the patch has changed.
A preset stores the instrument settings, including polyphony, modulation, and effects. INIT resets the sound to its starting settings.
Across the top of the page are the search button, the Name, Designer, and Save To fields, SAVE, and INIT. Below them, IMPORT brings in preset files or a preset pack's .zip. A .zip becomes a bank of its own at the top of the library, with its folders kept, and the list opens on it. Single preset files go into the Save To folder, or into User when Save To is the factory folder. A preset with the same name as one already there is left out. EXPORT writes the loaded preset to a file. A-Z flips the list's order, and the count beside it says how many presets are showing.
Folders and Favorites
In FOLDERS view, the left sidebar lists your banks and User folder:
- Banks: The factory bank and any other preset folders. The factory bank is the folder named Factory and the version number you have installed. Use tags to find instrument types within it.
- User: Your own presets and subfolders. SAVE can also update a factory preset after confirmation.
- All: Every preset in the library, alphabetically.
- Favorites: Every preset you have starred, from any folder.
Click the star on a preset row to add it to Favorites. Hover over a row and click its × to delete it. Deletion asks for confirmation. Hover over a row's badge to read its instruments. Click one of your folders to make it the Save To folder. Show files at the bottom of the sidebar opens the presets folder on your computer.
The tags for the loaded preset sit under the folders. Drag the divider between them to resize the two. Double-click it to put it back.
The factory bank is an ordinary folder of preset files. You can edit or delete its presets. Deleted presets stay deleted. A new release adds its own factory folder beside the older ones, and Khorlo then asks once whether to keep the old sets or delete them all. Your User presets are untouched either way, and favorites carry over to the new set by name.
Where your presets are
Khorlo makes its presets folder the first time it opens in your DAW. Every preset in the browser is a file in this folder, and every folder inside it is a folder in the sidebar.
| System | Presets folder |
|---|---|
| macOS | ~/Library/Application Support/JAS-I/Khorlo/Presets/ |
| Windows | %APPDATA%\JAS-I\Khorlo\Presets\ |
| Linux | ~/.config/JAS-I/Khorlo/Presets/ |
The quickest way there: right-click any preset and choose Reveal in Finder (see below). The ~ means your home folder. All three systems hide these folders, so you won't find them by browsing until you show them.
On a Mac, this is the Library inside your home folder, not the Library at the top of your drive (Macintosh HD > Library). To show it for good:
- In Finder, choose Go > Home.
- Choose View > Show View Options.
- Tick Show Library Folder.
Or, to open it once, choose Go > Go to Folder in Finder, paste the path above, and press Return.
On Windows, choose View > Show > Hidden items in File Explorer, or paste the path into the address bar. On Linux, press Ctrl+H in your file manager to show hidden folders, or Ctrl+L and paste the path.
To add a preset pack, click IMPORT on the PRESETS page and choose the pack's .zip. Or copy the pack's folder into the Presets folder, then reopen Khorlo. The pack appears in the sidebar under its own name.
Right-click menus
| A preset | Move to the save folder moves it into the Save To folder. Reveal in Finder shows its file (on Windows, Reveal in File Explorer; on Linux, Open Containing Folder). Set as Init makes INIT load this preset. Init loads the blank patch puts INIT back to the starting settings. |
| A folder | Reveal in Finder (or the Windows or Linux words above) shows it on your computer. |
Instrument badges
A colored badge beside each name shows its instrument tags. A preset can have more than one: the badge uses the first tag's letters and a color band for each. Hover to read them all. An unclassified preset has a dim badge.
| Family | Instrument tags |
|---|---|
| Low | Bass (BAS), Synth Bass (SBS) |
| Melodic | Lead (LED), Keys (KEY), Organ (ORG), Sequence (SEQ), Synth (SYN) |
| Plucked | Pluck (PLK), Guitar (GTR), Strings (STR) |
| Tuned | Bell (BEL), Mallets (MAL) |
| Percussion | Drums (DRM), Percussion (PRC) |
| Blown | Brass (BRS), Reed (RED), Wind (WND), Vocal (VOX) |
| Sustained | Pad (PAD), Atmospheres (ATM), Texture (TEX), Drone (DRN) |
| Other | FX (SFX) |
Editing and filtering tags
The tag panel has four collapsible groups:
| INSTRUMENT | The instrument types listed above. |
| TONE | Bright, Dark, Warm, Metallic, Glassy, Wooden, Hollow, Airy, Full, Thin, Harsh, Noisy. |
| CHARACTER | Clean, Gritty, Soft, Aggressive, Delicate, Organic, Synthetic, Evolving, Ambient, Wide, Lo-fi, Experimental. |
| ARTICULATION | Plucked, Struck, Bowed, Blown, Sustained, Staccato, Percussive, Rhythmic, Swelling, Gated. |
In FOLDERS view, clicking a tag adds it to or removes it from the open preset, and saves it at once. In TAGS view, the same buttons filter the whole library, and CLEAR shows everything again. Choose two tags to find presets carrying both.
Filtering also offers UNTAGGED and DESIGNER. Select two designers to see presets by either. Tags outside the built-in list appear under OTHER, where you can remove them.
Name, Designer, and Save To
| NAME | Click to edit. You can also drag this field onto a folder to move the preset. |
| DESIGNER | Enter the preset author's name. It is stored in the file and appears in the Designer filter. |
| SAVE TO | Shows where SAVE will write. For your own presets, edit the subfolder after User/. Leave it empty for the main User folder. On a factory preset, it shows its factory folder. Saving it under a new name puts it in User. |
Making folders
A folder is made by saving into it. Type its name in Save To, such as User/Live Set, then SAVE. Typing User/Live Set/Opener in the Name field does the same: it sets Save To to User/Live Set and the name to Opener. Slashes create deeper folders. A new folder appears in the sidebar once a preset is in it.
To move a preset, drag its row or the Name field onto a folder, or right-click it and choose Move to the save folder.
Saving and renaming
SAVE in the header, with a preset loaded, asks Replace (write over it with what you hear now) or Save As (keep it, and save yours under a new name). With nothing loaded, it opens PRESETS with the name selected: type a name and click SAVE. On the PRESETS page, SAVE, or Return in the Name field, asks the same question when it would write over the loaded preset. Other cases ask you to choose:
| Situation | Options |
|---|---|
| The name is already in use | Save as copy keeps both files and adds a number to yours. Replace overwrites the existing file. |
| You changed a user preset's name | Save As saves the edited patch under the new name and keeps the original. Rename changes the existing file's name. |
| You save over a factory preset | Update factory replaces that factory file. Save to User saves your version separately and keeps the factory copy. |
Cancel, Esc, or a click outside a save question cancels the operation. Pressing Enter selects its first choice.
Where your files live
Khorlo keeps your presets, favorites, tags, saved shapes, color schemes, and settings in one folder:
| macOS | ~/Library/Application Support/JAS-I/Khorlo |
| Windows | %APPDATA%\JAS-I\Khorlo |
| Linux | ~/.config/JAS-I/Khorlo |
Your presets are in its Presets folder. Back up this folder to keep your work safe. If you used an earlier Khorlo, the first time this version opens it moves your old Khorlo folder (the same place, without JAS-I) into the new one, with everything in it.
10 · Menu, GLOBAL and appearance
Open the ☰ menu at the top left for these actions:
| Undo / Redo | Undo or restore edits. After loading a preset, Undo brings back the one you had before. |
| Appearance… | Set the window size, colors, and 3D appearance. |
| Getting started… | Run the introductory tour again. |
| Manual… | Open the manual. |
| About Khorlo / Website | Which build you have, and the JAS-I website. |
| DSP load meter (dev) | Show audio-processing load for troubleshooting. |
The GLOBAL page
The GLOBAL tab in the header holds the settings that belong to Khorlo rather than to a preset. Its cards:
| VOICES | MODE, and PANIC, which stops every voice and every effect tail right now. Use it for stuck notes or runaway feedback. |
| OUT | A scope of what Khorlo plays, with its TIME and HEIGHT, peak and RMS levels, the voices sounding, and a clip light. |
| FOLDERS | Where your presets are, how many each folder holds, and REVEAL FOLDER. |
| TUNING | Pick a scale from the list, load a .scl or .kbm file, set A4 and the root, drag a note up or down to retune it, or save the scale as a file. A is the note the others are tuned from, so A4 sets it. The tuning is saved with your project, not with presets. When an MTS-ESP master is running (ODDSound MTS-ESP Master or Mini, or a DAW that provides one), every note takes the master's pitch, live, and keys the scale leaves out stay silent. |
| PREFERENCES | MPE turns on per-note pitch bend, pressure, and Slide. Each note bends on its own channel, up to 48 semitones either way, and a bend on channel 1 moves every note. Khorlo remembers it for new instances, a project keeps its own, and loading a preset doesn't change it. Performance Mode freezes the moving background, draws the 3D view at a lower frame rate, and pauses the live modulation displays. Control Descriptions shows what a control does in the tips line under the header. |
| LINKS | About Khorlo, the manual, the website, and the Getting started tour. |
| VIEW | The window size. |
Window size
Right-click an empty part of the header to pick a window size, or open Appearance, which floats over the instrument (drag its title bar to move it). You can also drag the plugin window's corner.
| Size | Pixels |
|---|---|
| 75% | 1200 × 675 |
| 100% | 1600 × 900 |
| 125% | 2000 × 1125 |
| 150% | 2400 × 1350 |
| 200% | 3200 × 1800 |
Your DAW saves the window size with the session, along with the page and panels you left open. Presets don't store them. A new Khorlo opens at the size you last chose.
Color schemes
Eleven schemes ship with Khorlo: Khorlo, the original look, plus Abyss, Darkness, Ember, Verdigris, Violet Hour, Bone, Glacier, Foxglove, Forest and Venom, and Halo, the light one. The same menu lets you save your own schemes with + New and delete the ones you don't want.
Below the scheme menu, FOG sets the speed, opacity and warp of the moving background and its three colors, Left, Center and Right. Soft and Deep beside it change how the colors mix: Soft is lighter with gentler contrast, Deep has darker shadows and brighter highlights. Those three also light the cylinder from those sides, so the glass takes on the colors you choose. CYLINDER sets the outer glass and the inner glow, each with a strength slider and a color. Save writes your changes onto the scheme shown in the menu. Cancel puts back the look and the scheme you opened the panel with. Reset appearance restores the original look without changing the window size. Appearance settings are remembered separately from the sound.
11 · Keyboard shortcuts
Your DAW keeps the computer keyboard for notes and transport. Send MIDI to play Khorlo. Inside a DAW these keys reach Khorlo:
| Keys | Action |
|---|---|
| ⌘Z / Ctrl+Z | Undo. |
| ⌘⇧Z / Ctrl+Shift+Z | Redo. |
| Up / Down on PRESETS | Load the previous or next preset. |
| Left / Right on PRESETS | Move one column across the list. |
| Home / End on PRESETS | Load the first or last preset. |
| Delete / Backspace in a shape | Remove the selected nodes. |
A few more work whenever Khorlo has the keyboard, which a DAW rarely allows: 1–8 selects a plucker and Shift + 1–8 a string, [ and ] step through the MODs, the arrow keys nudge the last control you touched (Shift for a finer step) or move selected envelope nodes up and down by 1% (Shift for 10%), and Esc closes a menu or clears the node selection.
12 · If something sounds wrong
| Problem | Try this |
|---|---|
| No sound | Send a MIDI note. Check that a plucker and string are enabled, that the plucker's numbered buttons include that string, and that string Level and master volume are up. Check AMP settings, the effect OUT dials, and the EFFECTS switch too. |
| A stuck note or runaway sound | Press PANIC on the GLOBAL page. It stops every voice and effect tail right away. If notes hang only while the sustain pedal is down, check the pedal. |
| The tail is too long | Shorten AMP Release or string Decay. Check delay feedback and reverb decay. For unwanted sustain while holding a note, lower plucker Rate. |
| A MOD does nothing | Check its destination and Amount. Make sure the target is enabled and has room to move. Envelope mode needs a note. A CTRL route needs input from its source: for Expression, Breath, Foot, or CC A to CC E, check its CC on the ROUTINGS page. |
| Spread does nothing | Raise Coupling to add the second resonating body. Very low non-string resonators may omit that body to reduce processing cost. |
| A filter does nothing | Enable its tab's dot. In SERIAL, check WET. In PARALLEL, check the balance between the two filters. |
| One plucker is silent | Check its on/off state, Strength, and numbered string buttons. The selected strings must also be enabled and have audible Levels. |
| Changing resonator type does nothing | A held note changes at its next pluck. If no plucker reaches that string, play a new note. |
| Hard notes start sharp | Lower string Drive to reduce the pitch bend on strong attacks. This effect applies to the String resonator. |
| Chords sound muddy | Try less Coupling, shorter Decay, or different Pan positions. Lower individual string Levels to balance the chord. |
| CPU use is high | Reduce AMP Voices or string Coupling. Bypass unused effects. For a slow interface, enable Performance mode. |
| My presets are missing | Check the JAS-I folder listed under Where your files live. Your presets are in its Presets folder. |