Flapwave 0.2.0 for Windows (x86_64), public preview
=======================================================

Flapwave is a synthesizer with a step sequencer built into the chassis, from Flaptown. This folder holds:

  Flapwave.clap    the CLAP plugin
  Flapwave.vst3    the VST3 plugin (a folder: copy the whole folder)
  Flapwave.exe     the standalone app
  INSTALL.txt      where the plugins go

PREVIEW: automation may change until 1.0. This is a 0.x build. Until 1.0 a parameter's ID or range can move, and a
host project that automates it may need its lanes redone. At 1.0 the IDs and ranges freeze for good.

Install
-------

Copy Flapwave.clap to  C:\Program Files\Common Files\CLAP\   (%COMMONPROGRAMFILES%\CLAP)
Copy Flapwave.vst3 to  C:\Program Files\Common Files\VST3\   (%COMMONPROGRAMFILES%\VST3)

Then rescan plugins in your host (REAPER, Bitwig and others). To remove Flapwave, delete the two again.
Flapwave.exe needs no installing: put it anywhere and run it. INSTALL.txt has the same steps and a PowerShell
one-liner.

Unsigned build
--------------

Flapwave isn't code-signed. The first time you open Flapwave.exe, Windows may show "Windows protected your PC"
(Microsoft Defender SmartScreen). Click "More info", then "Run anyway". It asks once. Hosts load the plugins
without asking. Check the zip against SHA256SUMS from the download page first:

  Get-FileHash flapwave-0.2.0-windows-x86_64.zip

Requirements
------------

  - Windows 10 or 11 on x86_64. No runtime to install: Flapwave uses only DLLs that ship with Windows.
  - The faceplate needs OpenGL, which every current graphics driver has.

The standalone
--------------

  Flapwave.exe                     opens the faceplate and plays through the default audio device (WASAPI)
  Flapwave.exe --backend dummy     runs without an audio device
  Flapwave.exe --help              every option (sample rate, period size, devices, MIDI ports, tempo)

Only the faceplate opens; closing it quits the app. Run from Explorer, the app writes its messages to
%LOCALAPPDATA%\Flapwave\flapwave.log (rewritten at each start). Run from a terminal, it prints them there. A
terminal doesn't wait for a windowed app, so the prompt can come back before the text; to read --help in order, use
  Flapwave.exe --help | more

Licence
-------

Flapwave is free software under the GNU General Public License, version 3 only (LICENSE.txt). Its source is at
Reepo on flaptown.com. THIRD-PARTY.md lists the third-party material it ships (the Syne Mono typeface, under the SIL
Open Font License in OFL-SyneMono.txt, and code ported from Skia), and THIRD-PARTY-CRATES.md the licences of the
Rust crates it is built from. VST is a registered trademark of Steinberg Media Technologies GmbH.
