WAVED Build Instructions

This document provides instructions for compiling, building, and generating installers for WAVED on MacOS and Windows platforms.

MacOS

WAVED can be built natively on MacOS using the provided Makefile. It uses a native Cocoa and CoreGraphics implementation for its graphical interface, and Apple CoreAudio/AudioToolbox frameworks for audio.

To build:

1. Ensure you have Xcode Command Line Tools installed (xcode-select --install).
2. Open a terminal and navigate to the waved source directory.
3. Copy the MacOS makefile to Makefile:

   cp makefile.mac Makefile

4. Run make to compile:

   make

To install manually: Run the following command to install the executable to /usr/local/bin:

sudo make install

To create a package installer: Run the following command to generate a native MacOS .pkg installer (which you can then deploy or share):

make pkgexe

This will generate waved-macos.pkg in the project root.

---

Windows

WAVED can be built on Windows using Visual Studio 2019 or 2022.

To build:

1. Ensure you have Visual Studio 2019 or later installed (with the C++ desktop workload).
2. Navigate to the VS18 subfolder and open the modernized solution file waved.sln in Visual Studio.
3. Select your desired build configuration and platform (e.g., Release / Win32) from the toolbar.
4. Build the solution from the Build menu (or press Ctrl+Shift+B).
5. The compiled executable will be generated in the respective output folder within the VS18 directory. You can then run the setup or the executable directly.

To create a setup installer:

1. Ensure you have Inno Setup installed on your Windows machine.
2. After successfully building the Release executable in Visual Studio (VS18\Release\wwaved.exe), open the waved.iss file located in the project root using the Inno Setup Compiler.
3. Click the Compile button from the toolbar. This will bundle the application and generate a Windows setup installer.