audio-toolset 0.1.0

Tools for processing audio signals

Audio Toolset

A Python library for processing audio signals.

audio_toolset provides an intuitive and flexible way to process audio files in Python. Each Channel object handles a single mono audio file, allowing you to apply filters, EQ, dynamics processing, gain adjustments, noise reduction, and more.

Stereo files can be handled by first splitting them into mono channels using split_to_mono and then recombining them with join_to_stereo.

Features

• High level Channel object for simple user interface
• Load audio from a file or AudioData
• Gain processing
  • gain, normalize, fade
• Filters
  • lowpass, highpass, eq_band
  • noise_reduction (spectral gating)
• Dynamics
  • compressor, limiter, soft_clipping
• Plotting tools (see examples)
  • plot_signal - generate signal time and frequency plot
  • Dynamic plots - compressor, limiter can generate attenuation plots
  • Bode plots - lowpass, highpass, eq_band can generate filter bode plots

Installation

pip install git+https://github.com/maxoshe/audio-toolset.git

Examples

Process with a channel strip

from audio_toolset.channel import Channel

guitar = Channel("guitar.wav")
guitar.highpass(cutoff_frequency=100, db_per_octave=6)
guitar.eq_band(center_frequency=2000, gain_db=3, q_factor=1)
guitar.lowpass(cutoff_frequency=10000, db_per_octave=12)
guitar.normalize(target_db=-1)
guitar.compressor(threshold_db=-20, compression_ratio=4, attack_ms=50, release_ms=100)
guitar.write("guitar_processed.wav")

Process with a chained channel strip

speech = Channel("speech.wav").highpass(cutoff_frequency=100).lowpass(cutoff_frequency=300)

Plotting

audio_toolset provides multiple plotting tools to visualize signals, filters, and dynamics. All plots are generated interactively using Plotly and can be saved as images from the interactive viewer.

Signal Plots

Use plot_signal() to visualize the time-domain and frequency-domain representation of an audio channel.

2. Filter (Bode) Plots

Filter plots show the frequency response (Bode plot) of filters applied using eq_band(plot_filter_bode=True), highpass(plot_filter_bode=True), or lowpass(plot_filter_bode=True).

3. Dynamics Plots

Dynamics plots visualize the response of compressors and limiters applied to a channel. Generated by compressor(plot_compressor_response=True) or limiter(plot_limiter_response=True)