Harmelody - macOS install
=========================

Two plugins in here:

  Harmelody       adds up to 4 in-key harmony voices to a vocal
  Harmelody Tune  autotune on its own

Both come as VST3 (Reaper, Ableton, Cubase, Studio One) and AU (Logic,
GarageBand). Install whichever your DAW uses, or both, it doesn't matter.
Standalone apps are in here too and don't need installing.


Install
-------

Copy the folders out of this zip and into your plugin directories:

  VST3/*.vst3            ->  ~/Library/Audio/Plug-Ins/VST3/
  Components/*.component ->  ~/Library/Audio/Plug-Ins/Components/

In Finder, hit Cmd+Shift+G, paste the destination path, then drag the bundles
in.

If a plugin with the same name is already there, delete it first. Don't merge.
Dragging a folder onto an existing folder of the same name can nest it inside,
and your DAW will keep loading the old version without telling you.

Then restart your DAW. Logic and GarageBand also rescan on launch. If Harmelody
doesn't show up, quit Logic, run this in Terminal, and reopen:

  killall -9 AudioComponentRegistrar


These builds are signed and notarized by Apple, so there's nothing else to do.
No Terminal, no right-click-Open, no security warnings. If macOS complains
about one of these, something's actually wrong and I want to hear about it.


Using it
--------

GETTING-STARTED.txt covers routing chords in Ableton and Reaper, plus
troubleshooting. Two things to know going in:

  - Harmelody with no chord source still harmonizes. It uses the key shown in
    the header, which is C major on a fresh instance.
  - Harmelody Tune with no key source does nothing, on purpose. Set Mode to
    Scale Preset and pick a root and scale, or route MIDI chords.

The standalone apps don't need installing. Run them straight out of the
Standalone folder.


If something breaks
-------------------

The plugin header shows a version like "v0.9.1 - 3 Aug 14:22". Send me that and
the name of the zip you installed from, plus your DAW and macOS version. It's
the only way I can tell which build you're on.

blaine.cowen@gmail.com


What changed in 0.9.4
---------------------

- Studio is now Harmelody's own engine. It keeps the singer's formants intact
  better on wide shifts, tunes exactly, and costs less CPU. Auto still switches
  to it on export, so exports made with 0.9.4 can sound slightly different from
  earlier ones.
- Engine now defaults to Auto: the fast engine while you play, Studio
  when your host renders. See "Known limits" below for what that means for
  your exports.
- Fixed clicks in the lead vocal on the Studio engine. Whenever a harmony voice slid
  to a new note, the lead's own delay moved with it, which ticked at every step
  of the slide and left the lead about 1 ms late against your other tracks.
  On Auto that is every export, so if an earlier bounce had faint ticks on the
  lead, re-export it.


Known limits in this beta
-------------------------

- Both windows resize from the bottom-right corner. They scale as a whole and
  keep their proportions, so nothing reflows.
- Engine shows which engine is actually running - beside the control in
  Harmelody, in the bottom status bar in Harmelody Tune. On Auto that is the
  only way to tell.
- Engine defaults to Auto: the fast engine (~17-31 ms) while you play, and
  Studio automatically when your host renders, bounces, freezes or
  exports. So your export won't be identical to what you monitored - it's the
  same performance rendered better. Pick an engine by hand if you need them to
  match exactly.
- Throat Length can't be shifted by the fast engine, which keeps formants by
  copying waveform grains. On Auto, turning Throat off centre switches you to
  Studio for playing as well as exporting, so the latency goes up.
