This project implements a clap detection system using an a mic or raw audio data as input. It can detect clap patterns including single and double claps.
- Clap pattern detection.
- Dynamic threshold adjustment for robust clap detection.
- Bandpass filtering to focus on clap frequencies.
- Audio recording and saving capabilities.
- Python3
- PyAudio
- NumPy
- SciPy
- install from the official pypi package (might be outdated):
pip install clap-detector
-
Install the required Python packages:
pip install pyaudio numpy scipy
-
Clone the repository:
git clone https://github.com/TzurSoffer/clapDetection/ cd clapDetection/src/clapDetector
-
Run the clap detection script:
python clapDetector.py
- Adjust parameters in the
ClapDetector
class constructor to fine-tune the clap detection system.
-
Create a script that uses this library
import logging from clapDetector import ClapDetector thresholdBias = 6000 lowcut=200 #< increase this to make claps detection more strict highcut=3200 #< decrease this to make claps detection more strict clapDetector = ClapDetector(logLevel=logging.DEBUG, inputDeviceIndex="USB Audio Device") clapDetector.printDeviceInfo() print(""" ----------------------------- These are the audio devices, find the one you are using and change the variable "inputDeviceIndex" to the the name or index of your audio device. Then restart the program and it should properly get audio data. ----------------------------- """) clapDetector.initAudio() try: while True: audioData = clapDetector.getAudio() result = clapDetector.run(thresholdBias=thresholdBias, lowcut=lowcut, highcut=highcut, audioData=audioData) resultLength = len(result) if resultLength == 2: print(f"Double clap detected! bias {thresholdBias}, lowcut {lowcut}, and highcut {highcut}") clapDetector.saveAudio(folder="./") except KeyboardInterrupt: print("Exited gracefully") except Exception as e: print(f"error: {e}") clapDetector.stop()
-
The system will continuously monitor audio input and detect claps.
-
If there are issues with audio input, check the device index in the
ClapDetector
constructor. -
Adjust the bandpass filter parameters for better clap detection in different environments.
This project is licensed under the MIT License - see the LICENSE file for details.