SYSRES Build Instructions

This document provides instructions for compiling and building SYSRES on Linux, MacOS, and Windows platforms.

Linux

SysRes uses the X window system to provide a graphical user interface under Linux and the ARSC library to access the soundcard. ARSC assumes the presence of an ALSA driver for the soundcard.

To build and install:

1. Open a terminal and navigate to the sysres source directory.
2. Compile the source using the provided Linux makefile by running:

   make -f makefile.lnx

3. Install SYSRES by copying the executable file sysres to your system's binaries folder:

   sudo cp sysres /usr/local/bin/

(Note: The precompiled Linux version of SYSRES is online at http://audres.org/sysres-linux.zip. SYSRES has been tested with several versions of Linux and Echo soundcards like Indigo IO, Gina3G, and Layla3G).

---

MacOS

SysRes 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. Audio Configuration: macOS treats built-in speakers and microphones as separate devices. For simultaneous playback and recording (essential for testing room acoustics), you must open Audio MIDI Setup and create an Aggregate Device bridging your physical input (Microphone) and physical output (Speakers). (Note: Virtual loopback devices like 'ZoomAudio' will loop the digital signal but will not output physical sound into the room.)
3. Open a terminal, navigate to the sysres source directory, and run:

   make -f makefile.mac

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

sudo make -f makefile.mac install

---

Windows

SysRes can be built on Windows using Visual Studio 2019.

To build:

1. Ensure you have Visual Studio 2019 (v16.0) installed along with the "Desktop development with C++" workload.
2. Navigate to the VS16 subfolder and open the solution file sysres.sln in Visual Studio.
3. Select your desired build configuration and platform (e.g., Release / x86 or x64) 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 VS16 directory. You can then run the setup or the executable directly.

Audio Configuration Tips:

• SYSRES on Windows typically uses the standard Windows audio APIs (Wave) or ASIO.
• For the lowest latency and most direct access to the audio hardware during room acoustic testing, it is highly recommended to install and use an ASIO driver (such as ASIO4ALL if your soundcard does not have a native ASIO driver).
• Ensure that the default sample rate of your recording device matches your playback device in the Windows Sound Control Panel to prevent resampling issues.