CLARK

CLARK (Comprehensive Live Audio Rendering Kit) is an open source audio visualizer capable of visualizing the audio playing on your computer in real time. This project is started with the goal of providing aspiring data scientists a tool that they can view/manipulate audio data.

CAPABILITIES

CLARK's current build can visualize data in both mono and stereo sounds. You can adjust the smoothness, height, and colors of the sound waves as you please. You can alter the smoothness of the waves as you please, meaning you can view the raw data itself or a smoother animation. You can also increase or decrease the size of audio data CLARK visualizes. As of now, CLARK can only visualize sound in sine waves.

INSTALLATION/USAGE

To install and use CLARK, follow these steps:

1. Download the Project:

   • Clone this repository to your local machine:

     git clone [https://github.com/halilmert088/CLARK.git](https://github.com/halilmert088/CLARK.git)

   • Navigate into the project directory:

     cd CLARK

   • Alternatively, if you have the project files extracted, simply navigate to the directory containing setup.py and other project files.

2. Prepare clark.py:

   • Ensure your clark.py file has its main execution logic wrapped in a main() function, and the if __name__ == '__main__': block calls this main() function. This is necessary for the clark console command to work correctly.

3. Install CLARK:

   • Open a terminal or command prompt.
   • Navigate to the root directory of the CLARK project (where setup.py is located).
   • Run the following command to install CLARK and its dependencies in editable mode:

     pip install -e .

     This command will install required libraries like pyaudio, numpy, PyQt5, and pyqtgraph.

4. Run CLARK:

   • After the installation is complete, you can start CLARK by simply typing clark in your terminal:

     clark

CLARK is designed to be modular in nature. Feel free to build on it, or use it as a base for your own projects. I plan to add more visualization modes as I progress further in my studies.