• Pathfinder โ€” Documentation ยท Audio Tech Hub
    // user guide ยท v1.0.5

    Pathfinder Documentation

    Everything from install to your first finished pattern โ€” the field, paths, MIDI playback, the step sequencer, the effect chain, presets, shortcuts and troubleshooting. For the free VST3 + AU instrument on macOS and Windows.

    For Pathfinder v1.0.5 ยท free VST3 + AU by Audio Tech Hub ยท macOS + Windows

    Pathfinder turns any folder of samples into a playable instrument. Your sounds scatter into a 3D field of glowing spheres; you draw a path through the field and Pathfinder plays every sphere it crosses โ€” tempo-locked to your host and pitch-corrected to your key. This guide takes you from install to your first finished pattern.

    1. Install

    1. Download the installer from the Audio Tech Hub releases page or via the KVR product page.
    • Windows: Pathfinder-โ€ฆ-win64-setup.exe โ€” installs the VST3.
    • macOS: Pathfinder-โ€ฆ-macos.pkg โ€” signed + notarized, installs VST3 and/or AU (pick either or both during install).
    1. Rescan plugins in your DAW and load Pathfinder as an instrument (it's played with MIDI notes).
    2. On first launch you'll see a short welcome walkthrough: 1 ยท SCAN โ†’ 2 ยท HOVER โ†’ 3 ยท DRAW โ†’ โœจ RANDOM โ†’ SOUND โ€บ. It ends on a big โ–ธ SCAN A FOLDER button โ€” that's your real step one.

    Pathfinder checks for updates when it loads. If a newer version exists, an

    โ†‘ update available pill appears in the top-right โ€” click it to open the

    download page.

    2. Your first sound in 60 seconds

    1. Click SCAN FOLDER (bottom-right of the strip โ€” it pulses until the field has sounds) and pick any folder of samples. Every audio file becomes a sphere: color = category, size = loudness. You can also drag a folder straight onto the plugin window.
    2. Hover over spheres. Each one you touch previews instantly, pitch-corrected to your project key. This is how you explore what you've got.
    3. Press P (or click DRAW) and drag a line through some spheres. When you release, the stroke is captured as a path โ€” the spheres it crossed, in the order you crossed them.
    4. Play a MIDI note (or click the slim on-screen keyboard above the strip). Pathfinder walks your path in time with your host's tempo. Hold the note to let it run; play C3 to hear it as drawn, other notes to transpose the whole path.

    That's the core loop: scan โ†’ draw โ†’ play. Everything else in this guide builds on it.

    3. The field

    Every sample is a sphere, auto-sorted into eight categories by name:

    ColorCategory
    Electric bluekick
    Coralsnare
    Pale yellowhat
    Violetperc
    Mintmelodic
    Greytexture
    Rosevox
    Greenfx
    • Category pills (top center) filter the field. Toggle a category off and its spheres go quiet โ€” handy for drawing a path through only your melodic sounds. The small + on a pill scans a folder directly into that category.
    • Camera: right-drag to orbit, mouse wheel to zoom, middle-drag to pan, Space toggles a slow auto-spin, R resets the view.
    • Double-click a sphere to isolate it: the camera flies in, the sphere is selected (ring + waveform readout, top-right), and it auditions.
    • File list (left edge) shows every loaded sound as a row. Hover a row to reveal โ˜… (favorite that sound) and โœ• (remove it from the map). The header has + file (add one file), โ˜… folder (favorite the whole scanned folder) and โ€“ hide to collapse the list.
    • The EXPLORED n / N meter tracks how much of the field you've actually listened to. Try to fill it โ€” the best sound is usually the one you haven't hovered yet.

    Importing sounds

    MethodWhat it does
    SCAN FOLDER buttonScans a folder (recursively) into a fresh field
    Drag & drop a folder / several filesSame as a scan โ€” new field
    Drag & drop a single fileAppends one sphere to the current field
    + file (file list)Appends one sphere via the file picker
    + on a category pillScans a folder forced into that category

    Supported formats: WAV, AIF/AIFF, FLAC, MP3. Files longer than the MAXLEN setting (default 3 s) are skipped โ€” raise it on the strip if your material runs longer. One Windows quirk: .aif files can't be drag-dropped (no system codec) โ€” the SCAN FOLDER button imports them fine.

    Tip โ€” name your samples with keys. Pathfinder reads key tags from filenames (bass_Ebm.wav, pluck-C.wavโ€ฆ). Tagged samples are pitch-corrected to your project key by the shortest musical distance (never more than a tritone), so sounds from completely different packs play in tune together.

    4. Capturing paths

    A path is an ordered set of spheres. There are three ways to capture one:

    • DRAW (key P): drag a freehand line. The stroke snaps to the spheres it passes; the shape of your line becomes the rhythm and melody of the phrase.
    • LASSO (key L): circle a group of spheres; they're captured in the order the loop passes them.
    • โœจ RANDOM (strip button): rolls a fresh path for you. Great when you're empty-handed โ€” keep rolling until something sparks.

    Two things shape every capture:

    • Path slots P1 P2 P3 P4 (keys 1โ€“4): four independent paths. The active slot is what DRAW/LASSO/RANDOM write into and what MIDI plays. Sketch a groove in P1, a fill in P2, a chord stack in P3โ€ฆ
    • Max-orbs chip [ 8 ] (mode bar): drag it up or down (1โ€“64) to cap how many spheres a capture keeps.

    Press Esc to clear the current trail or selection.

    5. Playing paths with MIDI

    • Any note-on starts the active path. C3 plays it as captured; other notes transpose the entire path chromatically. Velocity controls level.
    • Playback is tempo-locked: the path walks on your SYNC grid (strip, default 1/16) and its total length snaps to whole bars at the host BPM.
    • Loop pill โˆž (strip, also LOOP on the SOUND page): OFF โ†’ LOOP โ†’ RVS. In LOOP the path cycles while the key is held; RVS plays it backwards. Each path slot remembers its own loop mode. XF sets the crossfade (1โ€“500 ms) between loop cycles.
    • Path envelope: the A / D / S / R minis on the strip (mirrored as big knobs on the SOUND page) shape every triggered path โ€” attack softens entries, release lets tails breathe.
    • LAYER mode (LYR pill): flips the path from a sequence into a stack. With LAYER on, one key fires the whole captured group at once โ€” instant chords from any folder. With it off, the spheres play one at a time.

    The slim home keyboard above the strip (C2โ€“C5) mirrors incoming MIDI โ€” keys light up as your DAW plays โ€” and is fully clickable, so you can perform without a controller.

    6. EXPLODE

    EXPLODE turns one sound into a palette:

    1. Double-click a sphere to select it.
    2. Click โœธ EXPLODE in the mode bar.

    The sample is sliced into tempo-synced chunks (one per SYNC division) and the fragments scatter back onto the map as new spheres. Draw a path through the debris for glitchy, granular phrases โ€” a single vocal or pad becomes a whole field of rhythmic fragments. Re-scan your folder to restore the original field.

    7. The SOUND page

    Press Tab (or click SOUND โ€บ, bottom-right) to open the deep editor. Left side: a hero sphere blending your path's category colors (it reacts to the audio), a recipe list of the captured sounds, and three tabs. Tab or โ—‚ takes you back to the field.

    • WAVE โ€” the merged waveform of your captured path, with the ATTACK / DECAY / SUSTAIN / RELEASE / LOOP / LAYER / XFADE row beneath it and a big keyboard (C2โ€“C6) to perform on.
    • FX โ€” the effect chain (next section).
    • SEQ โ€” the step sequencer (section 8).

    8. The step sequencer

    Open SEQ on the SOUND page, or hit โ–ถ SEQ on the field page to start/stop it from home โ€” both views stay in sync.

    • Six lanes (L1โ€“L6), each playing one captured sound. Path spheres fill the lanes automatically; click a lane header's mini-waveform to preview, drag a sphere onto it (or right-click with a map selection) to reassign.
    • Click cells to place steps. BARS switches 1 / 2 / 4 bars (16 / 32 / 64 steps). SWING drags 0โ€“60. CLEAR wipes the grid.
    • ๐ŸŽฒ on a lane swaps that lane's sound for a random one; ๐ŸŽฒ ALL rerolls every unmuted lane โ€” a brand-new kit in one click. Click the L# label to mute a lane.
    • Per-lane chips: drag pitch ยฑ12 semitones (repitches and speeds the sample, sampler-style) and nudge steps off the grid. Lanes 1โ€“4 also have a one-shot โ†’ loop โ†’ reverse button.
    • MIDI button: arm it and the pattern runs while you hold a MIDI key โ€” the key transposes the whole pattern, C3 plays it straight. Sequence your sequence from the piano roll.

    The sequencer runs at host tempo, follows your DAW transport when triggered over MIDI, and renders correctly on export/bounce.

    9. Effects

    Five effects, always in view, one drag away:

    REVERB ยท DEGRADE ยท FLAIR ยท DELAY ยท GRANULAR

    Two ways in:

    • FX popup (strip, FX pill): five compact rows. Drag a row up/down to ride that effect's mix; double-click to bypass/enable. This is the perform view.
    • FX tab (SOUND page): five cards with colored level meters. Drag a card for mix, double-click to bypass, grab the โ‹ฎโ‹ฎ grip and drop a card onto another to reorder the chain, and hit โ€ข โ€ข โ€ข for the full parameter detail โ€” every parameter as a ring knob (drag to set, double-click to reset, power button to bypass).

    Highlights:

    • DELAY has a TEMPO toggle in its detail page: off = free time in ms, on = a RATE chip (1/1 down to 1/16, with triplet and dotted values) that follows your host BPM live.
    • GRANULAR is a full granular engine (grain size / position / interval / pitch / width) with its own TempoSync + Rate so the grain clock locks to your session.
    • Effect mixes and bypasses (all five slots) are host-automatable โ€” see section 12.

    10. Key, scale and pitch correction

    The strip's Key and Scale combos (Chromatic, Major, Minor, Pentatonic, Dorian) define your musical context. Everything Pathfinder plays โ€” hover previews, paths, the sequencer keyboard โ€” is corrected toward that context: key-tagged samples are shifted by the shortest circle-of-fifths distance (clamped to ยฑ6 semitones) and snapped to the scale. Drums and untagged sounds pass through untouched, so hats stay hats.

    11. Presets and favorites

    Click PRESETS (bottom-right) for the three-column browser:

    • Favorite Folders โ€” folders you've starred (โ˜… folder). One click reloads that field.
    • Favorite Sounds โ€” individual starred sounds; click to drop one into the current field.
    • Favorite Settings โ€” full presets. Type a name and SAVE.

    Pathfinder presets are full-state: all four path slots, loop modes, layer mode, the entire sequencer (steps, lane sounds, pitches, nudges, mutes, bars, swing), the FX chain and your key/scale/ADSR all reload exactly as saved โ€” the trail redraws on the map and the kit snaps back.

    Outside of presets, Pathfinder remembers your last setup: a fresh instance opens with your previous key, scale, ADSR, layer mode and settings. A saved DAW project always wins โ€” reopening a project restores that project's exact state, per instance.

    12. Settings, MIDI CC and automation

    The โš™ gear (top-right) opens Settings:

    • MIDI CC CONTROLS โ€” click LEARN next to a parameter, move a knob on your controller, done. โœ• clears one assignment, RESET ALL starts over. Mappings persist across sessions.
    • ABOUT โ€” version, live ENGINE CPU readout, UI SIZE buttons (75% / 90% / 100%), a link to audiotechhub.com and โœ‰ REPORT A BUG.

    You can also resize by dragging the zoom grip in the bottom-right corner (75โ€“100%; double-click it to snap back to 100%).

    Host automation exposes 16 parameters to your DAW: Key, Scale, Slot 1โ€“5 Amount (effect mixes), Slot 1โ€“5 Active (effect bypasses), and Path Attack / Decay / Sustain / Release.

    13. Quick reference

    Keyboard & mouse

    InputAction
    H / P / LHover / Draw / Lasso mode
    1 2 3 4Select path slot P1โ€“P4
    TabOpen / close the SOUND page
    EscClear trail / selection
    SpaceToggle camera auto-spin
    RReset camera
    Right-drag / wheel / middle-dragOrbit / zoom / pan
    Double-click a sphereIsolate + audition
    MIDI C3Play the active path as captured (other notes transpose)

    Bottom strip, left to right

    Key ยท Scale ยท PREVIEW (hover preview length) ยท MAXLEN (scan length filter) ยท SYNC (playback grid) ยท A D S (envelope) ยท โˆž (loop OFF/LOOP/RVS) ยท LYR (layer mode) ยท R (release) ยท XF (loop crossfade) ยท ? (tooltips on/off) ยท FX (quick-mix popup) ยท โœจ RANDOM (roll a path) ยท SCAN FOLDER ยท zoom grip

    14. Things to try

    • In-key arps โ€” toggle every category pill off except melodic, draw a long winding path, set Scale to Minor and loop it: evolving arpeggios that stay in your song's key.
    • Granular textures โ€” EXPLODE a vocal or a pad, then draw a new path through the fragments for moving, atmospheric fills. Add GRANULAR and tempo-synced DELAY on top.
    • Kits from chaos โ€” lasso your kick, snare and hat spheres, open SEQ, and build a drum pattern from found sounds. ๐ŸŽฒ ALL until it grooves.
    • Instant chords โ€” capture a group of melodic spheres, flip LYR on, and any folder becomes a one-key chord instrument. Slow the attack for pads.

    15. Troubleshooting

    • No sound? In order: is a folder scanned (field has spheres)? Are the category pills you need enabled? Is the plugin receiving MIDI (keys light on the home keyboard)? Is a path captured in the active slot (P1โ€“P4)?
    • Samples missing after a scan โ€” files longer than MAXLEN are skipped; raise it and rescan.
    • .aif won't drag-drop on Windows โ€” use SCAN FOLDER instead.
    • Window opened too small / controls clipped โ€” drag the bottom-right zoom grip, or set UI SIZE to 100% in โš™ Settings.
    • Out of tune? Pitch correction needs a key tag in the filename (_Cm, -F#โ€ฆ) and follows the strip's Key/Scale. Set Scale to Chromatic to hear everything unquantized.

    Something broken? โš™ โ†’ REPORT A BUG, or email audiotechhubonline@gmail.com.

    Pathfinder is free and open source (GPLv3). If it's making you sounds, consider voting for it in the KVR Developer Challenge 2026.

    Get Pathfinder โ€” free

    Questions this guide doesn\'t answer? Email support โ€” it goes straight to the developer.