SoundMirror

Audio Streaming Application.

There are two basic components:

• Server: a C++ application that captures raw audio data and streams it to clients;
• Client: an Android application built with Kotlin that connects to the server, receives the audio stream, and plays it in real time.

Build Instructions

Server

1. Clone the repository:

git clone https://github.com/Fetisyony/SoundMirror.git
cd SoundMirror/server

2. First make sure that you have Boost library installed on you device. Now create a build directory and run CMake:

mkdir build && cd build
cmake ..

3. Compile:

cmake --build . --config Release

4. You will find the resulting executable in build/.

Client

1. After cloning the repository in the part about server side, open the client/ directory in Android Studio.

2. Sync Gradle.

3. Ensure that your device fits the requirements in build.gradle.kts: Compile SDK Version and Target SDK Version.

Usage

• Start the server application using CMake. Upon startup, it will display the IP address it is listening on

• Launch the Android application and grant it notification permissions

• Enter into the text field the server IP address displayed by the server upon startup

• Tap Connect

• That's it!

Note: Once streaming, you can background the app; audio continues playing. To return, tap on the notification, which brings your existing application instance back to the foreground.