Home

Welcome to the IEAudio4Linux Wiki!

IEAudio4Linux is a lightweight, modern C++ wrapper for ALSA, simplifying Linux audio development.

---

Prerequisites

IEAudio4Linux requires the ALSA (Advanced Linux Sound Architecture) Library Development package to be installed.

1. Install Alsa development tools:
   • Using apt:

     sudo apt install libasound2-dev

   • Using dnf:

     sudo dnf install alsa-lib-devel

Getting Started

Launch your preferred terminal and navigate to a empty working directory.
Clone IEAudio4Linux to the working directory.

git clone https://github.com/Interactive-Echoes/IEAudio4Linux.git
cd IEAudio4Linux

IEAudio4Linux uses CMake as its build system. To get started, ensure you have CMake installed and follow these steps:

1. Generate Build Files:

   cmake -S . -B ./build

   This command creates a ./build directory where all the CMake-generated files will be placed.

2. Build IEAudio4Linux:

   cmake --build ./build

   After building, you can find the library in the ./build/bin directory named IEAudio4Linux.

Integrating IEAudio4Linux

To integrate the built IEAudio4Linux library into your application:

1. Include IEAudio4Linux in Your Project:
   Add the IEAudio4Linux directory to your application's project directory or if your application is using Git simply call:

   git submodule add https://github.com/Interactive-Echoes/IEAudio4Linux.git ThirdParty/IEAudio4Linux
   git submodule init .

2. Update CMakeLists.txt:
   In your application's CMakeLists.txt, include IEAudio4Linux by adding:

   add_subdirectory(<path_to_IEAudio4Linux>)
   # Example: add_subdirectory(ThirdParty/IEAudio4Linux)
   target_link_libraries(<your-target> PUBLIC IEAudio4Linux)

   Alternatively, you can link against the DLL using other methods if preferred.

3. Build IEAudio4Linux:
   Make sure IEAudio4Linux library is in the expected directory

---