Skip to content

Fixed issue #60 #102

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 17 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,42 @@
# SoundScape
SoundScape is a Python project that visualizes the real-time audio recorded through a microphone, using the PyAudio and PySimpleGUI libraries. It creates a dynamic and interactive soundscape that changes according to the sound input. You can use it to explore the sound properties of different environments, such as a busy street, a quiet park, or a noisy classroom.
SoundScape is a Python project that visualizes real-time audio recorded through a microphone, utilizing the PyAudio and PySimpleGUI libraries. It creates a dynamic and interactive soundscape that adapts according to the sound input. This tool enables users to explore the sound properties of different environments, such as a bustling street, a serene park, or a lively classroom.

*SoundScape has different visualizers. Let's learn about them:*
# Visualizers
SoundScape offers various visualizers to analyze the audio input:

## 1. Waveform

This visualizes the waveform of audio in real time.
The Waveform visualizer provides a graphical representation of the audio signal's amplitude over time. It displays the intensity of the sound wave, allowing users to observe the variations in loudness.

![image](https://github.com/Soumya-Kushwaha/SoundScape/assets/87495134/db464b28-ba01-40bf-a246-eed9f42c49d2)

<br>

## 2. Spectogram

This visualizes the change in frequency across time.
## 2. Spectrogram
The Spectrogram visualizer illustrates the frequency content of the audio signal over time. It represents how the intensity of different frequencies changes over time, providing insights into the spectral characteristics of the sound.

![image](https://github.com/Soumya-Kushwaha/SoundScape/assets/87495134/a346cd22-9bd4-4d6e-b700-a419ab842703)

<br>

## 3. Frequency v/s Amplitude

This visualizes the changes in frequency and amplitude in real time sound.
## 3. Frequency vs. Amplitude
The Frequency vs. Amplitude visualizer simultaneously displays changes in both frequency and amplitude in real-time sound. It offers a comprehensive view of how the pitch and volume of the sound vary over time, enabling users to understand the dynamic nature of the audio input.

![image](https://github.com/Soumya-Kushwaha/SoundScape/assets/87495134/725fe4a1-4d1a-4a2d-819b-703b6d11047d)
![image](https://github.com/Soumya-Kushwaha/SoundScape/assets/87495134/725fe4a1-4d1a-4a2d-819b-703b6d11047d)

<br>

# Usage
To use SoundScape, you need to install the requirements from ```requirements.txt```, and run different visualizers. You can interact with the soundscape using your microphone. For more details, please refer to the ```Installation.md``` file.
To use SoundScape, follow these steps:

Install the requirements from requirements.txt.
Run different visualizers.
Interact with the soundscape using your microphone.
For more details, please refer to the ```Installation.md``` file.

# Contribution Guidelines
Please refer to the ```Contributing.md``` for details.
Please refer to the ```Contributing.md``` for details on how to contribute to SoundScape.

# References
Please refer to the ```References.md``` for details.
Please refer to the ```References.md``` for additional resources and acknowledgments.