Hunter Hears Py

https://github.com/hunterhogan/hunterhearspy
Admin
A comprehensive Python library for audio processing including file I/O, spectrogram analysis, and...
Tokens:686
Snippets:10
Trust Score:8.3
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install hunterHearsPy

Source: https://github.com/hunterhogan/hunterhearspy/blob/main/README.md

Installs the hunterHearsPy library using pip. This is the standard method for adding the package to your Python environment.

```bash
pip install hunterHearsPy
```

--------------------------------

### Load and Save Audio Files

Source: https://github.com/hunterhogan/hunterhearspy/blob/main/README.md

Reads audio files with optional sample rate conversion and saves them in WAV format. The `writeWAV` function always outputs 32-bit float WAV files.

```Python
from hunterHearsPy import readAudioFile, writeWAV

# Load audio with sample rate conversion
waveform = readAudioFile('input.wav', sampleRate=44100)

# Save in WAV format (always 32-bit float)
writeWAV('output.wav', waveform)
```

--------------------------------

### Load Multiple Audio Files

Source: https://github.com/hunterhogan/hunterhearspy/blob/main/README.md

Loads multiple audio files into a unified NumPy array, ensuring consistent formatting. The resulting array has a shape of (channels, samples, file_count).

```Python
from hunterHearsPy import loadWaveforms

# Load multiple files with consistent formatting
array_waveforms = loadWaveforms(['file1.wav', 'file2.wav', 'file3.wav'])

# The result is a unified array with shape (channels, samples, file_count)
```

--------------------------------

### Spectrogram Conversion

Source: https://github.com/hunterhogan/hunterhearspy/blob/main/README.md

Converts between audio waveforms and their spectrogram representations using Short-Time Fourier Transform (STFT). Supports custom windowing functions and inverse transformation.

```Python
from hunterHearsPy import stft, halfsine

# Create a spectrogram with a half-sine window
spectrogram = stft(waveform, windowingFunction=halfsine(1024))

# Convert back to a waveform
reconstructed = stft(spectrogram, inverse=True, lengthWaveform=original_length)
```

--------------------------------

### Frequency Domain Audio Processing

Source: https://github.com/hunterhogan/hunterhearspy/blob/main/README.md

Applies custom processing functions to audio in the frequency domain (spectrograms). The `waveformSpectrogramWaveform` utility handles the STFT and inverse STFT automatically.

```Python
from hunterHearsPy import waveformSpectrogramWaveform

def boost_low_frequencies(spectrogram):
    # Boost frequencies below 500 Hz
    spectrogram[:, :10, :] *= 2.0
    return spectrogram

# Create a processor that handles the STFT/ISTFT automatically
processor = waveformSpectrogramWaveform(boost_low_frequencies)

# Apply the processor to a waveform
processed_waveform = processor(original_waveform)
```
Tokens:
Raw