DivineMatrix: Important Installation Instructions

ATTENTION COMPOSERS: Please read this short document completely before beginning installation. Following these exact security and directory placement steps ensures that both your operating system and your digital audio workstation (DAW) initialize DivineMatrix and its accompanying routing utilities flawlessly.

1. Trust, Security, & Independent Software

DivineMatrix is designed to deliver elite, lightweight, and high-performance orchestral routing control straight to your DAW. Our core philosophy relies on total transparency and mutual respect between creators.

To secure “Verified Publisher” digital signature certificates from Apple or Microsoft, independent creators must pay large recurring corporate platform fees. We are choosing to skip those gatekeeper systems at our product launch.

By opting out of these corporate validation costs, we pass more savings directly down to you, making our premium tools more accessible for independent musicians.

Because we distribute DivineMatrix independently without corporate code-signing certificates for this launch, your operating system will flag the installer as coming from an “Unidentified Developer” or “Unknown Publisher.” Don’t worry—this is completely normal for independent boutique software. 

It should also be noted that even a “Verified Publisher” who has paid their fees to Windows or Apple does not guarantee the copy is virus free, it only verifies the “Publisher” identity. We have openly placed on our website who we are with social online presence for many years to prove it.

In addition, if you want to be 100% certain you can always check our software at https://www.virustotal.com – Just upload the .exe or .dmg and it will scan the software for you.

Windows VirusTotal / Antivirus False Positives

When scanning the Windows .exe installer on VirusTotal, a couple antivirus engines may flag the file with generic labels like “Unk.Threat” or “Unclassified”.

This is a standard false positive caused by two main factors:

• No Reputation Record: Security engines rely on reputation databases. If a new executable hash hasn’t been downloaded thousands of times yet, automated engines flag it simply because it is unfamiliar to their cloud system.
• Heuristic Analysis: Unlike macOS app bundles, newly compiled standalone Windows binaries trigger aggressive heuristic warnings from lesser-known antivirus vendors until the build establishes a public track record.

The application is built directly from source and contains no malicious code. If your Windows Defender or local antivirus flags the installer, you can safely select “Allow on device” or add an exception.

Windows SmartScreen Bypassing

When downloading or launching the Windows installer (.exe), Microsoft Defender SmartScreen may display a warning stating that it “prevented an unrecognized app from starting.”

1. Open your browser’s download folder and locate the DivineMatrix installer.
2. (Optional Check) If your browser blocks the file download, click the three small dots next to the file name, select Keep, and choose Keep Anyway.
3. Double-click the installer. When the blue Windows SmartScreen pop-up window appears, click the small More info link directly under the main text.
4. A new button labeled Run anyway will appear at the bottom right. Click it to launch the setup wizard.
5. Follow the clean installation prompts to complete your setup.

macOS Gatekeeper Bypassing

When opening the installer package on a Mac, Gatekeeper may display an alert saying the app “cannot be opened because the developer cannot be verified.”

1. Locate the DivineMatrix installer inside your Applications or Downloads folder.
2. Control-Click (or right-click) the application icon instead of double-clicking it, and choose Open from the contextual shortcut menu.
3. A security dialog box will pop up asking if you are sure you want to run it. Click Open to launch and bypass the block.

Alternative Method: Open Settings -> Privacy & Security. Scroll down to the “Security” section. You will see a note stating that DivineMatrix was blocked. Click Open Anyway and enter your password.

System Architecture & DAW Core Routing

1.1 The Architecture: Direct OS Virtual MIDI Ports

Traditional multi-port setups often force you to load bridge plugins on every track or deal with complex network configurations. DivineMatrix completely bypasses this legacy approach by utilizing native, kernel-level OS Virtual MIDI Ports.

• Zero Latency & Maximum Speed: MIDI data flows directly through the operating system’s kernel buffer. 
• The 2-Way Routing Layout: DivineMatrix uses a clean, unified port structure:
  • 1 Master Input Port (DivineMatrix Input): Captures your live keyboard performance, mod wheel, and expression data and feeds it straight into the DivineMatrix core engine.
  • 32 Output Receiver Ports (DivineMatrix Port 01 through DivineMatrix Port 32): The DivineMatrix engine processes your chords/divisi and streams the separated notes and CCs out to your DAW instrument tracks.
• DAW Cleanliness: Your DAW treats DivineMatrix exactly like a hardware MIDI interface, allowing for pristine, multi-channel orchestral routing without cluttering your project.

1.2 Initial Driver & Port Setup (Windows & macOS)

Before opening your DAW, your operating system needs the virtual MIDI endpoints available so DivineMatrix can bind to them automatically on startup.

Windows Setup

NOTE: If you are using Windows 11, we suggest using MIDI 2.0 Studio to create port names. This method is much more dependable for names showing correctly in your DAW. Otherwise, if you are on Windows 10, use the method below:

1. Install loopMIDI: If you do not have this on your computer, our DivineMatrix installer will install the free loopMIDI utility by Tobias Erichsen (installs the kernel-level virtual MIDI driver engine).
2. Create the Ports: Open the loopMIDI application and create the following ports by typing their exact names into the box and clicking the + button:
   • DivineMatrix Input (You only need 1 of these)
   • DivineMatrix Port 01 through DivineMatrix Port 16 (or up to 32, depending on how many ports your template requires)

Note: loopMIDI saves these ports permanently to your Windows registry. You only ever have to create them once.

macOS Setup

• Zero Setup Required: macOS has CoreMIDI built natively into the operating system. When you launch DivineMatrix on a Mac, the application automatically spawns 11 ports DivineMatrix Input and DivineMatrix Port 01 through DivineMatrix Port 10 dynamically on app open. They will instantly appear in your Mac MIDI environment. If you desire to change this for your collection you can go to the HUB in the PRESETS tab and choose from the menu and enter your custom number of ports. This will then be saved with the collection, so each collection can have a custom number of ports available.

1.3 Step-by-Step DAW Routing Setup (Cubase, Reaper & Studio One)

Because DAWs like Cubase, Reaper, and Studio One support advanced multi-channel MIDI routing natively, setting up your orchestral template is straightforward:

Step 1: Route Your Master Keyboard into DivineMatrix

1. Create an Input Track: Create a standard MIDI track in your DAW and name it DivineMatrix Input.
2. Set MIDI Input: Set the MIDI input of this track to your physical USB keyboard/controller.
3. Set MIDI Output: Set the MIDI output of this track to DivineMatrix Input.

This track captures your live playing and feeds it directly into the DivineMatrix background engine.

Step 2: Route the Engine’s Divisi Output to Your Virtual Instruments

1. Create Instrument Tracks: Create your virtual instrument tracks (e.g., Kontakt, EastWest Play, VSL, or hardware synths) for your section (e.g., Violin 1, Violin 2, Viola, Cello).
2. Set MIDI Inputs: Go to the MIDI input dropdown of each instrument track and select the corresponding DivineMatrix Port (e.g., assign Violin 1 to DivineMatrix Port 01, Violin 2 to DivineMatrix Port 02, etc.).
3. Select Channels: If you are using 16-channel multi mode on a port, select the exact MIDI channel (Channel 1 through 16) that corresponds to your DivineMatrix matrix layout for that instrument.

1.4 Step-by-Step Ableton Live Routing Setup

Ableton Live routes MIDI across virtual ports natively without requiring Max for Live utilities.

Step 1: Enable Ports in Preferences

1. Open Ableton Live and go to Preferences -> Link / MIDI.
2. Under MIDI Ports:
   • Turn Track to On for DivineMatrix Input (Inputs).
   • Turn Track to On for DivineMatrix Port 01 through Port 32 (Outputs).
   • If using Windows 11 with MIDI 2.0 Studio, usually the (B) side is the one to use, such as DivineMatrix Port 01 (B) and DivineMatrix Input (B).

Step 2: Route Your Keyboard Performance Input

1. Create a new MIDI Track and name it DivineMatrix Input.
2. MIDI From: Select your physical MIDI keyboard.
3. MIDI To: Select DivineMatrix Input.
4. Monitor: Set to In (or arm the track in red to play live).

Step 3: Route Your Instruments

1. Create your Instrument Track (e.g., loading Kontakt with your virtual instrument).
2. MIDI From: Select DivineMatrix Port 01 (and choose the specific sub-channel, e.g., Ch. 1, Ch. 2, matching your matrix layout).
3. In the VST3i, choose MIDI Channel 1 for input (normally this is the default it loads at).
4. ARM: Make sure to arm your tracks to capture the MIDI coming to the DAW from DivineMatrix.

1.5 Guaranteeing Perfect DAW Tempo Sync

DivineMatrix includes a real-time arpeggiator and sequencer engine that locks its playback rate directly to your DAW’s project tempo (e.g., syncing perfectly when you change your project from 120 BPM to 105 BPM).

To ensure your DAW streams timing and transport clock (0xF8) into DivineMatrix, configure your DAW’s synchronization settings:

• Cubase Tempo Sync Setup: Go to Transport -> Project Synchronization Setup. Click on the MIDI Clock Destinations tab and check the box next to DivineMatrix Input.
• Reaper Tempo Sync Setup: Go to Preferences -> Audio -> MIDI Devices. Locate DivineMatrix Input under MIDI Outputs, right-click it, select Configure output for use as clock/timecode, and check Send MIDI clock.
• Studio One Tempo Sync Setup: Go to Studio One -> Options -> External Devices. Add a new MIDI Out device, name it DivineMatrix Sync, and set its Send To output to DivineMatrix Input. Under Send Mail / MIDI Clock, check Send MIDI Clock.
• Ableton Live Tempo Sync Setup: Go to Preferences -> Link / MIDI. Under MIDI Ports, find DivineMatrix Input in the Output column and turn Sync to On.

Global Scales & Transpositions

2.1 The Global Control Toolbar Layout

The top layout ribbon serves as the master command deck for the engine. It handles global structural changes instantly, and every single parameter inside it is completely MIDI Learnable for real-time control via hardware knobs or program changes.

• Global Octave Shift: Instantly steps the entire performance register up or down by octaves.
• Key Signature Selector: Defines the root pitch note parameter for the global scale constraint engines.
• Scale Mode Framework: Restricts your performance to specific musical scale parameters. Selectable profiles include:
  • Chromatic: Unrestricted 12-tone routing.
  • Major: Standard diatonic intervals.
  • Natural Minor: Standard minor intervals.
  • Dorian: Minor profile featuring a natural 6th accent.
  • Pentatonic: Fast, 5-note gaps designed for structural melodic runs.

2.2 Semi-Tone Transposition & Scale Coercion Logic

Inside the primary routing matrix, every discrete instrument channel features an independent Semi-Tone Transposition Engine capable of shifting pitch output up or down (e.g., -24 to +24).

Combined with the Global Toolbar Scale Lock, this unlocks an incredible creative shortcut for harmonic orchestration:

1. The Power 5th Example (+7): If you transpose a specific channel up by +7 semi-tones to create a soaring perfect fifth layer, you would normally risk playing notes outside your song’s scale when hitting accidentals.
2. The Scale Coercion Safeguard: When a Global Scale Mode (e.g., Natural Minor) is active, the engine intercepts that +7 transposition value and dynamically forces the output to snap to the closest mathematically valid note within your selected scale.
3. The Result: You can perform complex melodic shapes using exclusively the white keys on your keyboard controller, and every single transposed harmony layer will stay perfectly locked within your chosen key signature without ever producing a discordant note.

Preset Architecture & Presets

3.1 The 48-Preset Save/Load Interface Matrix

DivineMatrix stores up to 48 complete project patch configurations inside its active memory cache at one time.

• MIDI Learn Preset Management: Every single one of the 48 preset slots is MIDI learnable. You can assign standard hardware program messages or dedicated control keys to jump between completely distinct orchestration templates on the fly.
• Managing Existing Project Packs (Option C): When managing saved collections in the Option C area of the Save/Load workspace dashboard, look directly next to the active collection title row. Clicking the integrated icon triggers lets you instantly Rename, Duplicate, or Delete any collection profile template inside your disk file storage system.
• Custom Category Zone Target Menus: When generating or compiling a new matrix profile layout, use the Target Category Zone drop-down menu selection box to group your files systematically. If default naming pools do not match your template structure, you can generate entirely new, customized text category group zones right inside the field.

3.2 Smooth Performance Patch Changes (Sustain & Note-Hold Logic)

Switching presets mid-song in legacy MIDI utilities often triggers catastrophic data cuts, dropping sustained notes instantly or leaving behind stuck notes that loop indefinitely.

DivineMatrix implements intelligent tracking code designed for flawless performance patch changes:

• Dynamic Preset Transitions: When you change layout configurations, any notes you are currently holding down or capturing with your physical sustain pedal continue to bloom and track naturally on their original instrument ports.
• The Hand-off: The engine isolates the old preset profile variables in the background until your physical hand lifts or the sustain pedal releases. The very next note you strike initializes the new preset configuration completely.
• Arpeggiator Continuity: This seamless transition architecture handles all arpeggiator patterns as well, letting you shift from an intimate, slow string layout to a rapid, high-intensity brass pulse mid-measure without causing timing hiccups or stuck MIDI loops.

3.3 CRITICAL OPERATIONAL WARNING: Data Preservation Protocol

Because the user workspace renders inside a local browser window wrapper, you must remember the underlying storage protocol:

CRITICAL RULE: All visual configurations, slider mapping tweaks, and preset routing modifications made during a session are held temporarily within the engine’s active runtime memory bank. Closing or exiting the local web UI terminal page before manually committing your edits will result in the immediate and permanent loss of all unsaved work. Always click Save Collection to permanently write your setup configuration database file to disk storage before shutting down.

Divisi Voicing & Voice Allocation

DivineMatrix uses a real-time voice allocation engine designed to convert keyboard input into clean, multi-port orchestral scores. The engine features two distinct modes of operation—Smart Orchestra and Strict Divisi—to accommodate different performance styles, from expressive 1-finger sketching to precise, multi-port counterpoint.

4.1 Interface State & Mode Mechanics

When switching between modes via the toolbar toggle (represented by the Lightbulb Icon), the routing UI dynamically adapts to reflect the underlying allocation logic for all 16 MIDI ports.

4.2 Smart Orchestra & Dual-Gravitational Voicing (B1–B3, T3–T1)

Rather than stacking instruments into a dense wall of sound, Smart Orchestra divides note allocation into two distinct gravitational forces: The T-Side (Melody) and The B-Side (Bass).

Note Allocation Mechanics

• T1 (Top 1): Locks strictly to the highest active note (the leading melody line).
• T2, T3: Cascades downward from the melody line to capture inner harmonies.
• B1 (Bass 1): Locks strictly to the lowest active note (the fundamental harmonic floor).
• B2, B3: Stacks upward from the bass floor to support mid-bass counter-melodies.

Understanding Smart Tutti & Performance Technique

In Smart Orchestra Mode, playing a single key triggers Smart Tutti, broadcasting that single pitch across all active instrument ports. This allows you to perform soaring single-finger lead lines with the weight of an entire orchestra.

Troubleshooting: Why are my instruments dropping notes?

Solution: Ensure your VST instruments (like Iconica, Kontakt, or Spitfire) are set to Sustain or Polyphonic patches, rather than Legato patches.

Why? Legato patches in most sample libraries are heavily scripted to be monophonic. They look for specific overlapping keyboard techniques to trigger glides between notes. Because our Smart Divisi Engine is already doing the complex work of voice-leading, dynamic allocation, and note handovers in real-time, it conflicts with the VST’s internal legato script, causing the instrument to “choke” or drop notes. By using standard Sustain patches, you allow our engine to control the transitions flawlessly without the VST interfering!

4.3 Split Keyboard Architecture (Multi-Zone Performance)

When operating in Smart Orchestra Mode, engaging Keyboard Split Mode divides your physical MIDI controller into two decoupled performance zones:

• 3 Fixed Split Points: Features pre-configured, optimized split points tailored for standard 61-key, 76-key, and 88-key controllers.
• Decoupled Zone Separation:
  • Lower/Left-Hand Zone: Operates exclusively on B1–B3 (Bass Anchor) logic.
  • Upper/Right-Hand Zone: Operates exclusively on T1–T3 (Melody Anchor) logic.
• Performance Advantage: Left-hand bass movements, pedal points, or rhythmic staccatos remain completely isolated from right-hand melody lines. Moving your right hand across complex floating figures will never pull your Celli or Double Basses out of their low-frequency seating.

4.4 Strict Divisi Mode (1 through 6)

When Smart Orchestra is toggled off, the engine enters Strict Divisi Mode, changing the port indicators to an absolute numerical rank system (6 5 4 3 2 1).

• Fixed Rank Mapping: Voice 1 claims the highest note held, Voice 2 claims the second highest, Voice 3 claims the third, and down to Voice 6.
• Zero Smart Tutti: Playing a single note triggers only Voice 1. Auxiliary ports remain silent until additional notes are added.
• Continuity Locks: Features an internal continuity shield that locks voices to their active pitches. Releasing an inner note in a 3-note or 4-note chord will not cause adjacent voices to collapse, shift ranks, or blip.
• Rhythmic & Staccato Accuracy: Strict Mode is specifically built for rhythmic bouncing (e.g., holding or re-striking an anchor note while alternating upper chord staccatos). Because single notes never trigger a full-orchestra Tutti broadcast, the volume and instrument count remain completely stable.

4.5 Flavor-Based Chorder & Per-Channel Modifiers

The integrated Complex Chorder allows performers to trigger dense harmonic structures using single-finger inputs without altering the global routing template.

• Global Chord Flavoring: Selectable harmonic profiles allow you to generate Triads, 7ths, 9ths, or Complex Tension Chords.
• Per-Port Chorder Toggles: Every channel features an independent Chorder On/Off switch.
• Targeted Application: You can enable the Chorder exclusively on woodwind or string-pad ports to generate rich structural backing harmonies from a single key, while keeping your lead Flute or solo Violin ports set to Off for unharmonized solo performance over top.

Step Sequencer & Swell Engine

5.1 Per-Channel Note Range Constraints

Every channel features highly accurate, independent Playback Range Constraints (Floor and Ceiling boundaries).

[ MIDI C1 ] -> (Below Floor: Ignored) -> [ FLOOR: C2 ] -> (VALID ZONE) -> [ CEILING: G4 ] -> (Above Ceiling: Ignored)

DESIGN NOTE: Unlike standard DAW plugins where note filters are tied strictly to an arpeggiator module, the note range safety framework in DivineMatrix functions perfectly whether the arpeggiator engine is turned ON or turned OFF.

This allows you to permanently safeguard your sample libraries. For instance, you can set a hard note-range ceiling on your Tuba channel at E3 to guarantee that no matter what chords you strike in the heat of a live performance, the engine will physically block the Tuba from ever tracking into a high register where the samples sound thin or unnatural.

5.2 Highly Programmable Step Sequencer & Rhythmic Design

The DivineMatrix step sequencer transitions seamlessly between an expressive arpeggiator and a highly customizable precision rhythmic composer.

• The Velocity Editor Grid: The visual workspace features a multi-step drawing board where you can paint customized velocity curves with a single mouse swipe.
• Programmable Note On/Off Rests (The “0” Draw Rule): To program intricate rhythmic syncopation instead of continuous step loops, you can draw a value of 0 on any specific step inside the sequencer. A value of 0 tells the engine to execute a hard MIDI rest/note-off command on that exact division pulse.
• The Result: By mixing standard velocities with zero-value rests, you can design highly complex, customized polyrhythmic grooves, custom time-signature loops, and groove patterns across separate instrument layers.

5.3 Smart Step Sequencer & Articulation Key-Switch Guide

Welcome to the most advanced orchestration and phrase-building tool on the market. With our built-in Smart Step-Length Entry and independent Note/Pitch Editor, you can quickly program intricate melodic lines, key-switch transitions, and shifting rhythms using your MIDI controller and computer keyboard in tandem.

Part 1: Smart Step-Length Entry (MIDI Step Record)

Programming varying note lengths in a step sequencer is historically slow. In DivineMatrix, we’ve solved this using Grid Spans. You select how many steps a note should occupy on your computer keyboard, strike a key on your MIDI keyboard, and the engine automatically handles the rest.

How to use it:

1. Open the Arp & Sequencer window.
2. Select your target Channel, turn ARP ON, then toggle SEQ MODE ON.
3. Set your target lane to NOTE and click STEP REC (it will pulse red).
4. Decide your note length using keys 1 through 8 on your computer keyboard:

1. 
   Strike a key or chord on your MIDI keyboard. The note is recorded, subsequent steps are automatically tied together to sustain the note, and the red cursor automatically advances to the next empty step!
2. To insert a Rest (Silence): Press R or 0 on your computer keyboard. The engine will instantly insert a silent rest of your currently selected step-length and advance the cursor forward.

Part 2: Advanced Key-Switch Sequencing

DivineMatrix allows the Note Editor to trigger pitches down to the absolute bottom of the MIDI spectrum (below C0). This is incredibly useful for sequencing Articulation Changes (Key Switches) on the fly during a sequence.

How to use it:

If you are using an orchestral library (such as Spitfire, Orchestral Tools, or EastWest) on a MIDI port:

1. Program your primary melody on Channel 1 (e.g., Violin Legato).
2. Set up a second channel (Channel 2) on that same port running the same instrument.
3. Set the Channel 2 NOTE sequencer to target the Key Switch register of your library (usually keys C-1 through B0).
4. Using Step Record or by drawing with the mouse, map the articulation triggers (e.g., C0 for sustain, D0 for staccato, E0 for pizzicato) to sync perfectly with your melody.

Because our legato ties bypass re-triggering for sustained notes, you can sequence seamless legato shifts, glissandos, and articulation jumps on the fly!

5.4 The CC Swell Automation Engine

By detaching the sequencer grid from note generation, DivineMatrix introduces a powerful Swell Automation Engine designed for massive cinematic movement.

[ Step Sequencer Board ] -> (Arp: OFF / Swell: ON) -> [ Generates Smooth Vector Curves ] -> Direct Target: CC01 / CC11

• How to Activate: Toggle the channel’s Arpeggiator switch to OFF, and toggle the specialized Swell Engine switch to ON.
• Vector Drawing Control: Once active, the step sequencer drawing board no longer triggers new note attacks. Instead, it transforms into a high-resolution controller lane that converts your custom drawn shapes into smooth, continuous MIDI automation streams targeted directly at CC1 (Mod Wheel) or CC11 (Expression).
• Dynamic Range Shaping: This lets you draw hyper-precise, automated crescendos, decrescendos, and rhythmic volume rises that remain completely phase-synchronized with your host DAW project tempo grid.

5.5 Master Performance Demo: Orchestrating a Hybrid Multi-Port Arrangement

To see the true creative power of combining the Swell Engine and the Step Arpeggiator across different sections of your template, try building this professional 4-bar cinematic sequence:

Setup 1: The Ambient String Wall (Ports 01 & 02)

• Instruments: Violins, Violas, and Cellos.
• Configuration: Turn Arpeggiator OFF and turn Swell ON.
• Action: Open the CC11 Expression lane and draw a long, slow, sweeping upward line that spans across the entire length of the grid block.
• Behavior: When you hold down a sustained chord, the strings will not retrigger rhythmically. Instead, they will sit perfectly in place, creating a massive, long, slow, dramatic crescendo that breathes with organic, cinematic movement.

Setup 2: The Rhythmic Brass & Woodwind Pulse (Ports 03 & 04)

• Instruments: French Horns, Trumpets, Flutes, and Oboes.
• Configuration: Turn Arpeggiator ON and set the Sync Rate to 1/8 or 1/16 notes.
• Action: Draw a sharp, alternating up-and-down rhythmic velocity groove with several steps set to 0 to create a syncopated groove pattern.
• Behavior: While your left hand holds down the foundation and your strings execute the long slow volume swell, the brass and winds will instantly lock to the DAW grid, firing off driving, aggressive rhythmic pulses underneath the arrangement.

5.6 Data Portability: Exporting Sequences and Preset Collections

Your rhythmic patterns and entire custom setups are completely modular and portable, allowing you to back up your work or share setups with other composers.

• Arpeggiator Sequence Portability: Inside the arpeggiator workspace, clicking Export Sequence packages your custom velocity maps, rest points, and swell curves into an individual, lightweight sequence file saved directly to your PC’s local storage folder. You can import these files instantly onto other channels or email them directly to other creators.
• Full Collection Packs: Clicking Export Collection in the main manager window bundles your entire 48-preset routing matrix, scale settings, transpositions, and channel configurations into a single consolidated file. This makes it effortless to back up your master templates, share custom setups with other users, or move your entire production setup from your main studio workstation to a live touring laptop in seconds.

POLYMATRIX MOTIF ENGINE™

Dynamic Multi-Voice Sequencer, Piano Roll & Harmonic Orchestration Matrix

1. SYSTEM OVERVIEW

The POLYMATRIX MOTIF ENGINE™ is an intelligent, multi-voice composition and sequencing environment built directly into the DivineMatrix channel architecture. Unlike traditional static step sequencers or basic arpeggiators, the PolyMatrix Engine combines:

• Full Polyphony with Independent Note Lengths: Program moving multi-part voice leading, sustained chord pads, and counter-melodies on a single channel.
• Live Diatonic Chord Tracking: Live keyboard input dynamically re-voices and shifts the entire polyphonic arrangement to match the chord progression you play in real time.
• Octave Register Intelligence: Choose between locking motifs into their ideal orchestral frequency registers or allowing the playback register to soar dynamically with your hand position across the keyboard.
• Dynamic Modal Intelligence (Key Follow): Sequences programmed in any key or mode automatically transpose and conform to the active Global Key & Scale in real time.
• Multi-Octave Motifs & Repeat Multipliers: Cycle melodies across multiple octaves and generate complex rhythmic pulse variations without reprogramming steps.
• Cubase-Inspired Studio Workflow: Multi-note lasso selection, keyboard transposition, instant duplication, and non-destructive undo/redo history.
• Seamless Preset Handoff: Sustained polyphonic patterns and modulations carry over during preset changes until keys or pedals are released.

2. MODES: MONOPHONIC SEQUENCER vs. POLYMATRIX ENGINE

Each channel’s Arp & Sequencer module contains two distinct sequencing engines:

• Voice Capacity:
  • Monophonic Note Sequencer (POLY OFF): 1 Note per Step (Single Line)
  • PolyMatrix Motif Engine (POLY ON): Unlimited Polyphony (Chords, Dyads, Clusters)
• Duration Control:
  • Monophonic Note Sequencer (POLY OFF): Tied Steps via Legato Tie Curve
  • PolyMatrix Motif Engine (POLY ON): Independent Note Lengths (1 to 32 steps per note)
• Primary Use:
  • Monophonic Note Sequencer (POLY OFF): Driving Basslines, Ostinatos, Staccato runs
  • PolyMatrix Motif Engine (POLY ON): Divisi String Chords, Moving Harmony, Counterpoint
• Visual Interface:
  • Monophonic Note Sequencer (POLY OFF): 32-Step Dynamic Pitch Sliders
  • PolyMatrix Motif Engine (POLY ON): Full 88-Key Unified Piano Roll Canvas
• State Memory:
  • Monophonic Note Sequencer (POLY OFF): Stored independently in note_curve
  • PolyMatrix Motif Engine (POLY ON): Stored independently in poly_events

Non-Destructive Independence: Toggling between the Mono Sequencer and the PolyMatrix Engine preserves both sequences in memory. You can switch between a single-line staccato pattern and a full chord progression without losing your work.

3. HARMONIC, REGISTER & DIRECTION CONTROLS

The PolyMatrix Engine integrates directly with the Arp & Sequencer header deck:

A. Chord Track (Live Diatonic Chord Revoicing)

• CHORD TRACK: ON (Purple Glow / Degree Mode): Translates the 7 physical white keys (C, D, E, F, G, A, B) into the 7 Diatonic Degrees (I, ii, iii, IV, V, vi, vii°) of whatever Key and Scale are active on the Global Toolbar. When set to Key: B | Natural Minor, pressing white key C (Degree 1) plays the motif in B Minor; pressing white key E (Degree 3) dynamically morphs the entire motif into D Major. Chords, suspensions, and counter-melodies re-harmonize dynamically on the fly with zero wrong notes.
• CHORD TRACK: OFF: The sequence plays as a fixed motif anchored strictly to the Global Toolbar root key.

B. Octave Register Tracking (FIXED vs. FOLLOW)

Controls how the engine interprets the physical keyboard octave when CHORD TRACK is active:

• FIXED (Default / Arranger Mode): Anchors the PolyMatrix motif to its exact programmed sweet spot on the canvas (e.g., G3–E4). Playing low bass notes (C1–C2) or high leads (C6–C7) shifts the harmonic degree without pulling the accompaniment out of its frequency register. Ideal for split-keyboard performance and strict orchestral section arranging.
• FOLLOW (Dynamic Register / Live Performance Mode): Detects the octave position of your hands relative to Middle C4.
  • Playing in the C3–C4 octave → Plays at the base drawn register.
  • Moving hands up to C4–C5 → Transposes the entire motif +1 Octave (+12 semitones) in real time.
  • Moving hands up to C5–C6 → Transposes the entire motif +2 Octaves (+24 semitones).
  • Dropping hands down to C2–C3 → Drops the motif -1 Octave (-12 semitones).
  • Ideal for expressive live performance where building intensity physically climbs the keyboard.

C. Key Follow (Modal Scale Conforming)

• KEY FOLLOW: ON (Purple Glow): Every note in the sequence dynamically maps through the DivineMatrix harmonic matrix. Changing the Global Toolbar from C Major to A Minor, D Dorian, or F# Harmonic Minor instantly conforms the entire multi-part progression to the target mode.
• KEY FOLLOW: OFF: Sequences output fixed, absolute MIDI note pitches. Use this mode for Drum Kits, unpitched percussion, or fixed sound effects.

D. Note Repeat (Ratchet Multiplier)

Divides the playback clock to repeat each sequence step before advancing:

• 1x (OFF): Plays steps sequentially (1 → 2 → 3 → 4).
• 2x (Doubles): Repeats each note twice (C C → E E → G G). Ideal for driving spiccato string ostinatos.
• 3x (Triplets): Repeats each note three times (C C C → E E E). Ideal for 3/4 or 6/8 cinematic pulses.
• 4x (Quads): Repeats each note four times (C C C C → E E E E). Ideal for heavy action trailer drives.

E. Pattern Direction Modes

• FORWARD (Standard): Plays from step 1 to the end of the pattern.
• REVERSE (Retrograde): Reverses the sequence from the last step to the first.
• PING-PONG (Palindrome): Plays forward to the peak, then reverses smoothly without double-triggering the turnaround points.
• WEAVE (Broken Intervallic Weave): Advances with a “jump forward 2, step back 1” pattern (C → F → E → G → F → A).
• INSIDE-OUT (Outside-In): Alternates between outermost pitch boundaries, collapsing inward (C → A → E → G → F).
• SHUFFLE (Step Shuffler): Randomly triggers pattern steps while preserving the velocity and expression grooves. When Repeat is active (2x, 3x, 4x), the same random step is held across the repeat window before choosing a new step.

F. Melodic Octave Cycling

When applied to the PolyMatrix Engine, the Octave Range climbs across full octaves over time:

• 1 OCT: Plays at the programmed sequence pitch.
• 2 OCT: Plays Iteration 1 at base pitch; transposes Iteration 2 +1 Octave up (+12 semitones), then loops.
• 3 OCT / 4 OCT: Climbs across 3 or 4 full octaves on successive pattern cycles, creating evolving, non-static orchestral crescendos.

4. THE PIANO ROLL WORKSPACE

Clicking the POLY button (located in the Sequencer Target strip when NOTE is active) opens the high-resolution PolyMatrix Piano Roll.

Visual Layout & Display

• Unified 88-Key Pitch Axis: Spans the full orchestral range from C8 (MIDI 108) down to A0 (MIDI 21) with synchronized, single-scrollbar scrolling.
• Smart Auto-Centering: Opening the window automatically calculates the midpoint of your drawn notes and centers the viewport on them (or defaults to Middle C4 if empty).
• Grid Resolution: Automatically adapts columns to the active Step Count (4, 6, 8, 12, 16, or 32 steps).
• Beat Markers: Bolder vertical accent lines indicate quarter-note beat boundaries (every 4 steps).
• High-Contrast Notes: Active notes display as Sun-Amber blocks with pitch labels, right-edge resize handles, and glowing cyan selection rings.

5. MOUSE INTERACTIONS & GESTURES

• Add Note: Quick Left-Click on empty cell — Places a new 1-step note at the clicked pitch and step.
• Delete Note: Right-Click or Double-Click note — Instantly deletes the specific note block.
• Move Note(s): Left-Click & Drag note body — Moves all selected notes freely across Time (Steps) and Pitch (Keys).
• Resize Duration: Drag Right Handle — Adjusts the sustain length of the note (from 1 step up to the full pattern length).
• Lasso Selection: Click & Drag (> 5px) on empty grid — Draws a selection box. All notes touched or enclosed become selected.
• Multi-Select Toggle: Shift-Click / Ctrl-Click note — Adds or removes individual notes from the current selection.
• Draw Automation: Click & Drag on bottom strip — Paints continuous velocity, CC1 Dynamics, or CC11 Expression curves.

6. KEYBOARD SHORTCUTS & CUBASE WORKFLOW COMMANDS

• Transpose +1 Semi: Up Arrow — Moves selected note(s) up by 1 semitone.
• Transpose -1 Semi: Down Arrow — Moves selected note(s) down by 1 semitone.
• Octave Jump Up: Shift + Up Arrow — Transposes selected note(s) up by +12 semitones.
• Octave Jump Down: Shift + Down Arrow — Transposes selected note(s) down by -12 semitones.
• Nudge Step Left: Left Arrow — Moves selected note(s) 1 step earlier in time.
• Nudge Step Right: Right Arrow — Moves selected note(s) 1 step later in time.
• Duplicate Selection: Ctrl + D (Windows) / Cmd + D (macOS) — Clones selected notes and places them directly after the current block.
• Copy Notes: Ctrl + C (Windows) / Cmd + C (macOS) — Copies selected notes to clipboard.
• Paste Notes: Ctrl + V (Windows) / Cmd + V (macOS) — Pastes clipboard notes at the end of current selection.
• Delete Selection: Delete or Backspace — Deletes all highlighted notes.
• Select All: Ctrl + A (Windows) / Cmd + A (macOS) — Selects every note on the active piano roll.
• Deselect All: Escape — Clears the active note selection.
• Undo: Ctrl + Z (Windows) / Cmd + Z (macOS) — Reverts the last note edit, drag, resize, or deletion.
• Redo: Ctrl + Y / Ctrl + Shift + Z (Windows) / Cmd + Shift + Z (macOS) — Re-applies the last undone change.

7. INTEGRATED DYNAMICS & MODULATION (AUTOMATION DRAWER)

The lower section of the PolyMatrix window contains a dedicated 32-step automation drawer. This eliminates the need to close the piano roll to adjust dynamics.

Automation Lanes:

• VELOCITY: Controls the strike velocity (1 to 127) for each step.
• CC1 DYNAMICS (Mod Wheel): Drives VST3 dynamic crossfading and orchestral layer intensity.
• CC11 EXPRESSION: Controls master volume swell and phrasing shaping.

Operational Features:

• Continuous Mouse Drawing: Click and drag across the strip to draw smooth dynamic ramps and swells.
• Exact Numeric Readout (0–127): Hovering over any step displays its exact value.
• Live Mod Wheel Scaling: When Swell is engaged, your physical MIDI keyboard’s Mod Wheel acts as a master scaler over the drawn automation curves in real time.

8. PRESET HANDOFF & PERFORMANCE CONTINUITY

The PolyMatrix Engine includes intelligent memory handoff architecture:

• Uninterrupted Preset Transitions: When holding keys or the sustain pedal down while switching presets, the currently playing polyphonic chord progression continues playing seamlessly in its original key, scale, octave register, tempo, and voice voicing.
• Clean Release Handshake: The instant you release your fingers and pedal, the legacy tail is cleanly silenced with zero stuck notes, and the newly selected preset engages on your next strike.

9. ORCHESTRAL SCORING WORKFLOW EXAMPLES

Example 1: Full-Section Cinematic Chord Progression

• Channel 1 (Violins 1 & 2): Arp set to UP, Rate 1/16, Repeat 2x. High rhythmic spiccato ostinato (C5 → E5 → G5).
• Channel 2 (Violas): PolyMatrix Engine ON. Program sustained 4th/5th dyads (G3+C4 → A3+D4 → B3+E4).
• Settings: Set CHORD TRACK: ON and OCTAVE: FIXED.
• Performance: Play simple single white keys (C → F → G → A) with your left hand. The Violas and Violins voice-lead through a complete I → IV → V → vi symphonic cue in perfect harmony.

Example 2: Expressive Soaring Climax

• In PolyMatrix, set CHORD TRACK: ON and OCTAVE: FOLLOW.
• During quiet verses, play left-hand chords around C3 (motif plays in the warm mid-range).
• As the music builds toward the chorus, move your hand up to the C4 and C5 octaves—the entire string section automatically climbs +1 and +2 octaves higher to deliver a soaring orchestral crescendo.

10. DIVISI-AWARE HARMONIC ORCHESTRATION (VOICE-SLOT ANCHORING)

The PolyMatrix Motif Engine™ is deeply integrated with DivineMatrix’s core Divisi Voice Allocation Matrix. Unlike traditional sequencers that treat chords as a flat trigger or basic arpeggiators that merely repeat the notes your fingers are holding, the PolyMatrix Engine uses each channel’s assigned Divisi Voice Route (T1, T2, T3, B1, B2, B3) as its harmonic anchor point.

How Voice-Slot Tracking Works

When you play a 3-part or 4-part chord on your keyboard, DivineMatrix’s real-time Divisi brain immediately separates the chord into distinct orchestral voice tiers (Top Soprano, Middle Harmony, Bottom Bass). Any channel running the PolyMatrix Engine will automatically anchor its dynamic harmonic transformations to its assigned voice slot:

• Bottom Voice 1 (B1 / Voice 3): Anchors the motif to the Bass Root (1st degree).
• Top Voice 2 (T2 / Voice 2): Anchors the motif to the Inner Harmony (3rd or 4th degree).
• Top Voice 1 (T1 / Voice 1): Anchors the motif to the Soprano Lead (5th or top melody note).
• Voice Allocation Routing:
  • YOU PLAY CHORD: A3 – C4 – E4
  • Voice 1 / T1 (E4 – Top Soprano Note): Routed to Port 01 (Violins). PolyMatrix tracks E4 (High Flourish Motif).
  • Voice 2 / T2 (C4 – Middle Inner Note): Routed to Port 03 (Violas). PolyMatrix tracks C4 (Inner Moving Harmony).
  • Voice 3 / B1 (A3 – Bottom Bass Root): Routed to Port 04 (Cellos). PolyMatrix tracks A3 (Deep Root Ostinato).

The Multi-Section Orchestration Advantage

This architecture allows you to create full orchestral counterpoint and voice-leading from a single held chord:

• Cellos (Port 04, assigned to B1): Program a driving low ostinato. When you play A3 – C4 – E4, the Cellos track A3, anchoring the low-end foundation.
• Violas (Port 03, assigned to T2): Program a moving dyad pattern. The Violas track C4, weaving warm harmonic counterpoint right in the middle register.
• Violins (Port 01, assigned to T1): Program a high cascading melody. The Violins track E4, soaring across the top of the hall.

Result: One single 3-finger chord on your keyboard commands three completely different, independent polyphonic sequences that split, voice-lead, and resolve across the entire orchestra in real time.