# KeyFlow Installation Guide

## Installing on Windows

1. Quit your DAW if it's running
2. Navigate to the Windows folder in the downloaded package
3. Copy `KeyFlow.vst3` to:
   ```
   C:\Program Files\Common Files\VST3
   ```
   (Create the VST3 folder if it doesn't exist)
4. Open your DAW. In FL Studio, open Options > Manage plugins and click Find installed
   plugins; Ableton Live finds new plugins as it starts.

## Installing on macOS

1. Quit your DAW if it's running
2. Navigate to the macOS folder in the downloaded package
3. For Logic Pro, copy `KeyFlow.component` to:
   ```
   /Library/Audio/Plug-Ins/Components
   ```
   For FL Studio and Ableton Live, copy `KeyFlow.vst3` to:
   ```
   /Library/Audio/Plug-Ins/VST3
   ```
   (Create the folders if they don't exist)
4. Open your DAW. Logic Pro checks new plug-ins as it starts; in FL Studio, open
   Options > Manage plugins and click Find installed plugins.

## Using KeyFlow in FL Studio

FL Studio doesn't pass MIDI on from Audio Units, so KeyFlow comes as a VST3 instrument too.
Its own audio is silent: it sends the scale's notes on to the instrument you choose.

1. Add KeyFlow to the Channel rack (it's under Generators) and play or draw notes into it
2. Open KeyFlow's plugin settings (the cog in its window) and set MIDI Output port to a
   number, say 1
3. On the instrument KeyFlow should play, set MIDI Input port to the same number
4. Pick a root, a scale and the keys you want to play it with, and play

To keep it all in one channel, load KeyFlow and the instrument into a Patcher, connect
KeyFlow's event output to the instrument, and still set KeyFlow's MIDI Output port.

## Using KeyFlow in Ableton Live

Live doesn't load plugins as MIDI effects, so KeyFlow goes on a MIDI track of its own as an
instrument, and a second track takes its notes. Use KeyFlow.vst3 on a Mac too: Live can't
take MIDI from Audio Units.

1. Drag KeyFlow from Plug-ins in Live's browser onto a MIDI track, and play or record notes
   on that track
2. Put the instrument KeyFlow should play on a second MIDI track
3. On the second track, set MIDI From to the KeyFlow track, then choose KeyFlow in the menu
   below it
4. Set the second track's Monitor to In
5. Pick a root, a scale and the keys you want to play it with, and play

## Using KeyFlow in Logic Pro

KeyFlow is a MIDI effect, so it goes in a MIDI FX slot, not with the audio effects:

1. Select a Software Instrument track
2. Click the MIDI FX slot, just above the instrument slot in the channel strip
3. Choose Audio Units > stvdwell > KeyFlow
4. Pick a root, a scale and the keys you want to play it with, and play

Logic records the keys you press and KeyFlow moves them onto the scale as they play back,
so you can change the scale after recording.

## Troubleshooting

- If Ableton Live doesn't list KeyFlow, turn on Use VST3 Plug-In System Folders in
  Settings > Plug-ins and click Rescan
- On Windows, check your DAW scans C:\Program Files\Common Files\VST3, and rescan
- On a Mac, if you see a security warning, open System Settings > Privacy & Security and
  allow KeyFlow, then reopen your DAW
- If Logic lists KeyFlow as failed or unavailable, open Logic Pro > Settings > Plug-in
  Manager, select KeyFlow and choose Reset & Rescan Selection
- KeyFlow needs Windows 10 or later (64-bit), or macOS 10.15 or later

## Support

If you encounter any issues:
- Email: stvdwell@gmail.com
- Check the troubleshooting section above

## Updates

Check https://stvdwell.com/keyflow/ for the latest versions and updates.
