_             _ _            ____                  _              ____ _     ___
   / \  _   _  __| (_) ___      / ___| _ __   ___  ___| |_ _ __ __ _ / ___| |   |_ _|
  / _ \| | | |/ _` | |/ _ \ ____\___ \| '_ \ / _ \/ __| __| '__/ _` | |   | |    | |
 / ___ \ |_| | (_| | | (_) |_____|__) | |_) |  __/ (__| |_| | | (_| | |___| |___ | |
/_/   \_\__,_|\__,_|_|\___/     |____/| .__/ \___|\___|\__|_|  \__,_|\____|_____|___|
                                      |_|

• Real-time visualization of Fast Fourier Transform (FFT) spectrum of audio input.
• Support for adjusting parameters such as duration, sampling rate, and block size.
• Seamless integration with SoundDevice for audio input capture.
• Customizable Frequency Range: Allow users to specify the frequency range to display in the spectrum.
• Color Customization: Provide options for users to customize the colors used in the spectrum visualization.
• Added PyQt5 modules and a Gaussian filter that enables user input for Duration (in seconds), Sampling Rate (in Hz), Block Size, and also smoothens the output.
• Much more dynamic and user-controlled interface.

Audio-SpectraCLI/

├── .gitignore
├── CODE_OF_CONDUCT.md
├── Contributing.md
├── Dockerfile
├── LICENSE
├── Readme.md
├── requirements.txt
├── setup.cfg
├── setup.py
├── .github/
│   └── workflows/
│       ├── docker-publish.yml
│       ├── label.yml
│       └── python-publish.yml
├── Audio_SpectraCLI/
│   ├── main-old.py
│   ├── main.py
│   └── __init__.py
└── tests/
    ├── test-old.py
    └── test.py

1. Install using pip

pip install Audio-SpectraCLI

2. Import and use modules

• Create a Python file.
• You can use Example.py as a reference or use the following code :

from Audio_SpectraCLI import AudioSpectrumVisualizer
from PyQt5.QtWidgets import QApplication

# Creating an instance of AudioSpectrumVisualizer with custom parameters
app = QApplication([])
audio_visualizer = AudioSpectrumVisualizer(
    duration=5, fs=22050, block_size=1024, frequency_range=(1000, 5000), color='red')

# Starting the audio spectrum visualization
audio_visualizer.show()
app.exec_()

Once you have activated the audio_visualizer instance, feel free to use it wherever in the program. It consists of several parameters (which gives more control to the user), so make sure to configure and add those before using it in your code. Also, the user can modify (wrt v4.0) the Duration (in seconds), Sampling Rate (in Hz), and Block Size.

1. Prerequisites You should have docker installed on your machine. You can download and install Docker from here.
2. Pulling the Docker Image

You can pull the pre-built Docker image from Docker Hub using the following command:

docker pull adityaseth777/audio-spectracli

3. Viewing Files Inside the Docker Container For seeing the files inside the Docker container for debugging purposes, you can run an interactive shell session:

docker run --rm -it --entrypoint /bin/bash audio-spectracli

4. Use the 'ls' command to view the files and get a proper understanding of the file structure :

ls

5. You can use Example.py as a reference or use the following code :

from Audio_SpectraCLI import AudioSpectrumVisualizer
from PyQt5.QtWidgets import QApplication

# Creating an instance of AudioSpectrumVisualizer with custom parameters
app = QApplication([])
audio_visualizer = AudioSpectrumVisualizer(
    duration=5, fs=22050, block_size=1024, frequency_range=(1000, 5000), color='red')

# Starting the audio spectrum visualization
audio_visualizer.show()
app.exec_()

Once you have activated the audio_visualizer instance, feel free to use it wherever in the program. It consists of several parameters (which gives more control to the user), so make sure to configure and add those before using it in your code. Also, the user can modify (wrt v4.0) the Duration (in seconds), Sampling Rate (in Hz), and Block Size.

If you prefer to build the Docker image locally, follow these steps:

1. Clone the repository :

git clone https://github.com/AdityaSeth777/Audio-SpectraCLI.git
cd Audio-SpectraCLI

2. Build the Docker image:

docker build -t audio-spectracli .

3. Viewing Files Inside the Docker Container For seeing the files inside the Docker container for debugging purposes, you can run an interactive shell session:

docker run --rm -it --entrypoint /bin/bash audio-spectracli

4. Use the 'ls' command to view the files and get a proper understanding of the file structure :

ls

5. You can use Example.py as a reference or use the following code :

from Audio_SpectraCLI import AudioSpectrumVisualizer
from PyQt5.QtWidgets import QApplication

# Creating an instance of AudioSpectrumVisualizer with custom parameters
app = QApplication([])
audio_visualizer = AudioSpectrumVisualizer(
    duration=5, fs=22050, block_size=1024, frequency_range=(1000, 5000), color='red')

# Starting the audio spectrum visualization
audio_visualizer.show()
app.exec_()

Once you have activated the audio_visualizer instance, feel free to use it wherever in the program. It consists of several parameters (which gives more control to the user), so make sure to configure and add those before using it in your code. Also, the user can modify (wrt v4.0) the Duration (in seconds), Sampling Rate (in Hz), and Block Size.

• Save and Export: Implement functionality to save the generated spectrum as an image file or export data for further analysis.
• CLI endpoints.
• Option to choose between CLI/GUI.

Check the Contributing page.

MIT © Aditya Seth

I will be improving this project.

Contact: contact@adityaseth.in

💙 If you like this project, give it a ⭐ and share it with friends!