# Overtonium

> A free, open source additive synthesizer plugin laid out like a 32-channel mixer. Every channel is one sine oscillator locked to a harmonic of the played note, and every channel has its own tuning, envelope, modulation and place in the stereo field. VST3, Audio Unit, LV2 and standalone, for macOS, Windows and Linux, under the AGPLv3.

The first control to try is TUNE. It moves each partial continuously between equal temperament and just intonation. At the just end a partial sits at an exact whole-number ratio with the fundamental, and the partials blend into one timbre. At the equal end each partial snaps to the nearest semitone, and the same partials sound more like a chord. The factory presets Just Saw and Equal Saw differ only in this control and sound completely different.

Additive synthesizers usually hide their partials behind a spectrum drawing or a few macro controls. Overtonium shows all of them as faders and gives each one the controls of a channel on a mixing desk, so you shape a sound by mixing it.

Written in C++ with JUCE 9 by Benjamin Dehli for Dehli Musikk. Hosts list it under DehliMusikk.

## Documentation

- [Overview](https://benjamindehli.github.io/overtonium/index.html.md): what the instrument is, what TUNE does, a video of [eleven of the forty-four factory presets played on a keyboard](https://www.youtube.com/watch?v=L1oYdPxGlGA), common questions, and the three sample instruments that came before it.
- [Tuning](https://benjamindehli.github.io/overtonium/tuning/index.html.md): TUNE from equal to just, inharmonic stretch, eight historical temperaments and an adaptive one that retunes each key as it is played, on any root, at a reference pitch from a list running 415 to 466 Hz, keyboard tracking, and per-partial drift. Includes audio of each and a diagram of where every partial falls against the semitone it snaps to.
- [Controls](https://benjamindehli.github.io/overtonium/controls/index.html.md): every knob on a channel strip, the two-part envelope, per-partial velocity and pressure, LINK for ganging the 32 channels or only the ones you pick, the lamps and meters, the gestures the panel responds to, and the noise channel.
- [Effects](https://benjamindehli.github.io/overtonium/effects/index.html.md): the bar across the top: the twelve oscillator characters, wobble, the resonator of sympathetic strings with its Piano, Open, Octave, Series, Fifths and Chord modes, bus drive, the echo and the reverb with their three machines each, the converter, the eight CLIP machines on the output, the lookahead limiter, the console mix bus, the cassette recorder and the two printed together, the output meter, and a diagram of the order the signal passes through.
- [Playing](https://benjamindehli.github.io/overtonium/playing/index.html.md): MPE, legato with one voice or as a top line over a polyphonic accompaniment, glide with a time on every channel and the two switches that set when it glides and what the time means, every entry in the Settings menu with its default, how the 884 host parameters are named and why automation keeps working when a release adds more, every one of them listed with its id, range and default, macros, and MIDI Learn.
- [Presets](https://benjamindehli.github.io/overtonium/presets/index.html.md): the forty-four that ship, each one playable on the page, [eleven of them played on a keyboard](https://www.youtube.com/watch?v=L1oYdPxGlGA) with a chapter link to each, what a preset stores and what it leaves out on purpose, how a MIDI program change selects one, where user presets are kept on each platform, and how folders in that directory become groups in the menu.
- [Install](https://benjamindehli.github.io/overtonium/install/index.html.md): which download to take on each platform, what to do when a host does not see the plugin, what it costs in CPU at one, eight and sixteen voices, the opt-in update check, and building from source.
- [Releases](https://benjamindehli.github.io/overtonium/releases/index.html.md): what changed in each version since 1.0.0, newest first, with what to know before upgrading and a link to the full notes for each.

## Source

- [Repository](https://github.com/benjamindehli/overtonium): the whole source, AGPLv3.
- [Releases](https://github.com/benjamindehli/overtonium/releases): installers for macOS and Windows, and a zip for each platform holding the same builds loose.
- [README](https://github.com/benjamindehli/overtonium/blob/main/README.md): what the instrument is, how to build it, the update check and the licensing.
- [Design notes](https://github.com/benjamindehli/overtonium/blob/main/DESIGN.md): every control and how the synthesis works, with the reasoning and the measurements behind each decision. Longer than the project page.
- [Architecture](https://github.com/benjamindehli/overtonium/blob/main/ARCHITECTURE.md): how the code is arranged, and which decisions the rest depends on.
- [Contributing](https://github.com/benjamindehli/overtonium/blob/main/CONTRIBUTING.md): building, the two test suites, style, and how releases are made.
- [Accessibility](https://github.com/benjamindehli/overtonium/blob/main/ACCESSIBILITY.md): what has been checked, not only intended, with the measurements, the known barriers, and how to report one. The plugin window is not keyboard operable and nobody who relies on assistive technology has evaluated it.

## Facts

- Formats: VST3, Audio Unit on macOS, LV2 on Linux, and a standalone application.
- Platforms: macOS as a universal binary for Apple Silicon and Intel, Windows, Linux.
- Licence: GNU Affero General Public License v3, which follows from JUCE.
- Price: free, and free software rather than only free of charge.
- Partials: 32 sine oscillators plus a noise channel, each with its own tuning, envelope, key-off envelope, tremolo, pitch modulation, drift, glide, velocity and pressure amounts, pan, mute, solo and fader. The noise channel has no pitch, so it has no pitch modulation, drift or glide. In their place it has a Karplus-Strong string tuned to the note, which the noise plucks or blows into, with STRING, DECAY, DAMP and POINT knobs. A glide time is how long that partial takes to reach a new note, so the partials can arrive one at a time. Two switches apply to every channel: whether it glides always or only legato, and whether it moves at a fixed rate or takes a fixed time. Both modulators have a waveform per channel: sine, triangle, sawtooth, reverse sawtooth, square, sample and hold, or a smooth random glide. Pitch also has a unipolar square that only bends upward. Each modulator can be switched from one per note to one shared by the whole keyboard, so a chord moves together instead of each key moving from its own starting point. There are two switches, one per modulator, called Shared by all notes in the shape button's menu and shown beside each SHAPE caption. They are off by default and saved with the patch. Wurli, Tape Pluck and Soft Trio share their tremolo, and StyloPoly and Combo Organ their vibrato. On a keyboard that senses how fast a key is released, that speed scales the level each partial's tail starts from, from double at the fastest release to half at the slowest. There is no knob or parameter for it. A keyboard that cannot sense release speed changes nothing. It can report that in two ways, a note-off carrying zero or a note-on with velocity zero, and both are read as no information.
- Tuning: a continuous blend from equal temperament to just intonation, inharmonic stretch, keyboard tracking, and nine keyboard temperaments: equal, just, Pythagorean, quarter-comma meantone, Werckmeister III, Vallotti, Kirnberger III and Young, and Adaptive. Adaptive gives every pitch class five versions a comma apart and tunes the held chord with whichever versions make it purest. It does this again each time a key goes down or comes up, and slides a held note to its new version over a Retune time from instant to one second. Every chord is pure in every key, including a chord that changes into the next one note at a time. The same keys are tuned the same however they were played, and the keyboard never drifts more than two commas. When a chord cannot be pure throughout, Adaptive keeps the compromise as small as it can. A minor seventh is the harmonic one, 7:4 above its root, unless that would put another held note out of tune with it, so a dominant seventh is 4:5:6:7.
- Oscillator character: one setting for all 32 partials that chooses which oscillator each of them is modelled on. Each is named after the part that gives it its sound. Pure is an exact sine. Bulb is a Wien bridge whose lamp responds slowly, so the level lags behind every pitch change and recovers over about half a second. Rail is a phase-shift oscillator driven into its own supply rail, with a third harmonic at -23 dB and no even harmonics. Diode is a triangle shaped by two mismatched diodes, with a second, third and fourth harmonic near -32 dB. Valve is a triode biased so one half of the wave bends over first, with a second harmonic at -20 dB over a third at -23. It is the only one whose loudest added harmonic is an octave rather than a twelfth. Op-amp is an amplifier that is too slow to keep up. It does nothing below a kilohertz and turns partials above it into triangles, so the top of the series gets harder as it goes up. Wheel, FM, PD, 6581, VCO and Combo are measured from recordings of real instruments rather than simulated. Wheel is a tonewheel organ's generator, with seven sets of harmonics chosen by the pitch of each partial: a second harmonic of -13 dB on the lowest C that gets weaker up to A3, drops by 15 dB by C4, and leaves the upper wheels close to pure sines. Each wheel also moves by about a cent in pitch and a tenth of a dB in level once per turn of its shaft, 16 to 31 times a second depending on the note, and the motor moves every wheel together by 0.9 cent at 25 Hz, as measured on the organ. Each held note also carries the faint leakage of the wheels near it in the generator, measured on the organ: the same note two octaves down at -47.7 dB, a fourth down at -49.6, an octave down at -51.9 and a fifth down at -55.4, following the note's level and stopping at C1, the organ's lowest wheel. FM is one operator of a frequency modulation synthesizer with nothing modulating it, and PD is a phase distortion synthesizer's oscillator with the distortion off. Both are nearly pure, with a second harmonic near -54 dB on FM and -52 on PD, which is 3 and 6 dB more than was measured, set by ear, and ten harmonics rather than five. Each note also carries the noise measured under the instrument's own notes, white at -105.5 dB per hertz against the note on FM and -111.5 on PD, which includes 3 dB added by ear, about 62 and 69 dB under the note in all. It follows the notes, so there is no hiss when nothing plays. On FM most of the hiss above 6.4 kHz is a fixed part that follows only the loudest note, as measured on the instrument with chords, so it hardly builds up as keys are added: five keys add about 3.6 dB there where the notes add 7. 6581 is measured from a 6581 sound chip, which has no sine: its 12-bit converter, whose bits are each worth about 1.95 times the one below rather than twice, so the output falls back where many bits change at once, and a slight bow after it, both measured from the chip's slow sawtooth and triangle. A sine run through them gets a second harmonic at -23 dB and a long tail of odd harmonics between -55 and -63 dB, carried to the 32nd, plus the chip's fixed hiss, which does not grow with the number of keys. The chip was recorded through SidStation ASID (https://benjamindehli.github.io/sidstation-asid/), a plugin by the same maker that writes the chip's registers directly, so every setting reached the chip as set. About 40% of the bow is on the mix, as measured from two of the chip's voices together, so a chord also gets faint sum and difference tones between its notes. VCO is an analogue voltage-controlled oscillator's sine, recorded straight from its output, and the mixer it feeds. The sine is made from a triangle, with a second and a third harmonic near -25 dB, the same at every pitch, and each note carries the oscillator's faint hiss, about -122 dB per hertz against the note, while each partial's pitch wanders by about 0.2 cents rms, as the recorded oscillator's did. The mixer, recorded driven from quiet to well past clipping, stays clean until it reaches a rail and then stops, and its negative side reaches its rail 2.44 times sooner than its positive side, so a chord played hard runs into it and gains an octave as well as a twelfth. Combo is the 8' footage lever of a transistor combo organ, which divides one oscillator down for every octave of a note. That gives a square wave through a filter, so it has only odd harmonics, with the third at -16 dB on the lowest C falling to -35 dB above C7, in eight sets chosen by the key played, since the organ filters each key once for all its levers, so the higher partials of a note sound like its higher levers. It carries the organ's faint hiss, about -98 dB per hertz against the loudest note, 10 dB under what was measured, set by ear, which does not grow with the number of keys. The characters are built as band-limited tables rather than as waveshaping, so they cost nothing per sample and nothing aliases. Each of the five circuits is a rack of 32 units rather than one oscillator. A fixed spread, the same in every session and on every machine, puts each partial a couple of cents and a fraction of a dB off spec, from 1.5 ct and 0.1 dB for Bulb to 3 ct and 0.35 dB for Valve. Partial 1 stays exact, as the one the rest were tuned against. This is separate from DRIFT, which wanders. Wheel keeps every partial in tune, since its wheels are geared to one motor, and spreads only the level, by up to 1 dB. FM, PD, 6581 and Combo have no spread, like Pure, and VCO takes the Op-amp circuit's, since only one oscillator was recorded. Each unit of the five circuits is also built to one of three drives, 15% either side of nominal, so no two channels distort by the same amount. There are three rather than one per channel because the drive is built into a band-limited table. The character also sets how the bus behaves where the 33 channels are summed. This is separate from the tables and works on the mix rather than on any one partial. It is an amplitude-reactive drive that is barely there when you play quietly and comes in when you play hard. It is strongest on Bulb and Rail, gentlest on Diode, and absent on Pure, FM and Combo. Wheel uses the triode curve, as the organ's own amplifier uses valves. PD's bus is the slight quadratic bow measured in the phase distortion synthesizer's mix: it gives each note its second harmonic, about -52 dB at full fader, and gives a chord sum and difference tones between its notes 6 dB above that, as the instrument does. There is no knob for it, because how hard a summing amplifier is driven is part of the character you choose.
- Effects: a resonator of 88 sympathetic Karplus-Strong strings between the summed channels and the bus drive, an echo with three machines, a reverb with three machines, a wobble across the whole series, and a converter that reduces render rate and bit depth. Most of the factory presets use the echo, the reverb or both, mostly the tape and the room. 60s Organ and Combo Organ use the bucket brigade and the spring, Shimmer and Tape Choir the plate, Glide and 8-bit Choir the digital echo, Chapel the digital echo and the room, and Space Cowboy the digital echo and the plate. The echo is a tape loop with two motors, a bucket brigade, or a digital delay that sends every repeat to the other side. AGE means something different on each: tape wear, a slowing clock and breathing companding, or falling bits and sample rate. The reverb is a feedback delay network sized from its decay, a modulated plate that is dense from the very start, or a tray of springs whose dispersion turns every hit into a chirp that starts high and falls. Decay, damping and pre-delay mean the same on all three, and the wet levels are matched, so switching machines changes the character of a tail but not its length or loudness. The resonator's strings are tuned one to each piano key, A0 to C8. Piano lets the held keys' strings ring, and all of them while the sustain pedal is down. Open lets all of them ring, as if the pedal were always down. Octave rings the twelve from C3, and Series rings the tuning root's first eight harmonics, tuned pure. Fifths rings the root and the pure fifth above it in four octaves, and Chord keeps the strings of the last chord ringing after its keys come up. The strings never bend. Metallic Piano, Space Cowboy, KarplusStrong, Tape Pluck, 8-bit Choir, Soft Trio, Pendulum and Chapel use the resonator, and the other factory presets have it off.
- MPE: pitch bend and pressure per note, with the slide axis routable to brightness or tuning.
- LINK: makes one drag move many channels: by the same amount, tapered by distance from the channel you grabbed, or scattered apart, reaching all channels, the odd or even ones, one interval, or only the channels you pick. Cmd-click a channel's number on a Mac, or Ctrl-click on Windows and Linux, to pick it, and drag across the numbers to pick a run. Picking one switches LINK to its Selected scope. The selection is kept with the session, and Clear selection in the LINK menu empties it.
- Macros: up to eight, each one host parameter that moves a whole row, such as every tuning knob or every decay, across all channels, the odd or even ones, one interval, or the channels you picked, either uniformly or tapering away from a chosen channel. A macro on the picked channels keeps its own copy of them, saved with the session and with user presets, so picking other channels later does not change it. A macro adds an offset to the patch values instead of replacing them, so the knobs stay where they are and a ring around each one shows where the macro has moved it. Macros let you automate a relationship across 32 channels with one lane.
- MIDI Learn: right-click any control, choose MIDI Learn and move a controller. It works with MPE on, the map is saved with the project rather than the preset, and eighteen controllers the instrument already uses, such as the mod wheel, the two pedals and the MPE slide, cannot be learned.
- Output stage: the master fader drives a CLIP stage of eight machines, Soft, Hard, Asymmetric, Limiter, Fold, Console, Cassette and Print, or Off. Console is a console's mix bus measured from a real chain: a transformer whose lows saturate first, a linked 4:1 bus compressor with its sidechain filtered at 120 Hz and an automatic release, and a tape stage that adds a steady third harmonic once driven, into the limiter at -0.1 dBFS, at unity for a quiet signal. Cassette is a four-track cassette recorder at 9.5 cm/s with Dolby B on a normal tape, measured by recording a test signal onto it and playing it back: the lows saturate first, the top rolls off to -3.6 dB at 12 kHz, the machine's Dolby lowers the hiss by about 10 dB and leaves quiet highs a few decibels duller because it does not quite cancel itself, the speed wanders by about 0.1% with flutter at 68 Hz, and the hiss is there while something plays and gone when nothing does, into the limiter at -0.1 dBFS. Print is the console's chain printed to the cassette recorder: Console, a limiter at -0.1 dBFS, then Cassette, with the tape hiss 6 dB lower than on Cassette. With the Limiter lookahead switched on in Settings, the Limiter looks 2 ms ahead and the plugin reports 108 samples of latency at 48 kHz whichever shape is chosen, so changing preset never changes the latency. Lookahead is off by default. The plugin then reports only the 12 samples of the bus stage, and the Limiter is rougher.
- Automation: 884 parameters reach the host, 44 global, 23 on each of the 32 partials, 22 on the noise channel and 6 on each of the eight macros. A per-channel parameter has its channel in its name, such as "H7 Tune" or "Noise Level". Each parameter has its own id rather than being identified by its position, so when a release adds parameters, existing automation still controls the same things.
- Program change: a MIDI program change loads a factory preset by its position in the alphabetical Factory list, counting from zero, on any channel and with MPE on. Numbers past the last preset are ignored, and your own presets cannot be loaded this way.
- Factory presets: 2-bit Fuzz Organ, 60s Organ, 6581 Pulse, 6581 Sawtooth, 6581 Triangle, 8-bit Choir, Big Saw, Cathedral, Chapel, Combo Organ, DigiLog, Dire Dire EP, Drawbar Organ, Dream Phase, EP Chimes, Equal Saw, FM Piano, Glass Armonica, Glide, Glockenspiel, Init, Just Saw, KarplusStrong, Lo-fi, Metallic Piano, Music Box, Nylon EP, Odd Harmonics, Omni-84, Pendulum, Shimmer, Slow Pad, Soft Trio, Space Cowboy, Space Flute, Sparkle Pad, Stepped, Struck Bell, StyloPoly, Synth Ensemble, Tape Choir, Tape Pluck, Vibraphone, Wurli. Thirty-nine of them set an oscillator character, chosen by ear: ten on Op-amp, nine on Bulb, five on Valve, four on 6581, two each on Rail, Diode, Wheel and PD, one each on FM, VCO and Combo, and five on Pure, three of those on purpose (Init, Just Saw, Equal Saw).
- Audio examples: every section of the tuning page has audio, and so do glide, legato and every factory preset: Just Saw against Equal Saw and the TUNE sweep between them, a STRETCH sweep from harmonic out past a piano, one chord in equal against Werckmeister III, a run up the keyboard with tracking off and on, a held chord with and without drift, a phrase with glide off and on, a melody over chords with Legato off and on, and all forty-four presets playing the same spread C major. They are rendered by the plugin rather than recorded, so they always match what it does.
- Privacy: nothing reaches the network unless the update check is switched on, which is off by default and offered once.

## Optional

- [The whole site](https://benjamindehli.github.io/overtonium/llms-full.txt): every page above as Markdown in one file, for reading all of it in one request.
- [Every parameter](https://benjamindehli.github.io/overtonium/parameters.json): all 884 host parameters as JSON, one per line: the id automation is stored against, the name a host shows, the range and the default. The plugin writes this file itself.
- [Update feed](https://benjamindehli.github.io/overtonium/latest.json): the version the plugin's opt-in check reads.
- [Security policy](https://github.com/benjamindehli/overtonium/blob/main/SECURITY.md): what the update check sends, and how to report a vulnerability.
- [KVR Audio listing](https://www.kvraudio.com/product/overtonium-by-dehli-musikk): the instrument's page in the KVR plugin database, where people can rate it and compare it with other plugins.
- [Dehli Musikk](https://www.dehlimusikk.no/): the other instruments, most of them sample libraries rather than plugins.
