Skip to main content

A utility to examine 24-bit integer and 32-bit floating point audio samples/ranges.

Project description

🚀 audioutil - Analyze Audio Sample Ranges & Noise Floors

Overview

audioutil is a standalone tool, also featured in the Intro to Audio Samples tutorial. It offers the following capabilities:

  • Noise Floor Comparisons: Analyze your own noise floor recordings to identify optimal equipment setups and observe differences across tests. Build a historical database of your results to compare equipment and arrangements over time. See audioutil stats... walkthroughs.
  • Stepped-Level Tests: Record audio while a stepped-level test tone plays, then use audioutil steadylevels... to observe sample values at each level. Refer to the test tone steady levels test in the tutorial.
  • Sample Range Dumps (24-bit & 32-bit float): Understand 0.0 to 1.0 (0 dBFS) sample ranges and compare 24-bit with 32-bit floating-point ranges. See the audioutil range simple (walkthrough) and audioutil range detailed (walkthrough).
  • Plot Test Recordings: Visualize .wav test recordings over time using Matplotlib. The straightforward implementation makes it a good starting point for graphing audio samples or learning Matplotlib.
  • Interactive IEEE-754 Mode: Use audioutil interactive (walkthrough) to input values and view detailed IEEE-754 interpretations.

⚠️ IMPORTANT: While a simple tool for the tutorial, audioutil proved invaluable for understanding environmental noise and how recorder settings/equipment arrangements impact noise floor tests. It's primarily designed for small .wav files (e.g., 5-10 second noise floor test recordings).


Install

If you wish to install audioutil directly from PyPi (i.e., you are not following the tutorial), you can use the following command:

pip install at-audioutil-pkg

After installing audioutil, you can use audioutil -h to verify it is installed.

⚠️ Installing audioutil directly won't replace cloning the source code for the tutorial. To follow along with the tutorial video and walkthroughs, you'll need to clone the source code as instructed in the tutorial steps.

⚠️ FFmpeg Not Found? If you encounter an error that ffmpeg is not found, it means you likely don't have it installed. The tutorial demonstrates resolving this for a Windows demo environment by using winget install Gyan.FFmpeg.

Important: I don't endorse or vouch for the security of any FFmpeg builds, including the one shown. Please exercise caution when installing. For more information on available FFmpeg Windows builds, check the Windows download section at https://ffmpeg.org. As of July 2025, their site links to Gyan.FFmpeg builds, and I myself have had no issues with Gyan.FFmpeg to date.


Tutorial

📺 Watch the Full "Intro to Audio Samples" Tutorial Here: https://www.youtube.com/watch?v=8WXKIfXnAfw

See the main tutorial github page for additional details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

at_audioutil_pkg-0.0.5.tar.gz (19.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

at_audioutil_pkg-0.0.5-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

File details

Details for the file at_audioutil_pkg-0.0.5.tar.gz.

File metadata

  • Download URL: at_audioutil_pkg-0.0.5.tar.gz
  • Upload date:
  • Size: 19.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for at_audioutil_pkg-0.0.5.tar.gz
Algorithm Hash digest
SHA256 8857f09ebdbc66f9595a0d5b69526049e7a9ae3e7a71695172d9ac0e6f8c3a4c
MD5 2cd146550803b5bb4df8ab4f16f34fba
BLAKE2b-256 2a2befd63b63f7db8e4a6405209cd82357c59314eb48d8a9c662e96682c9bdc8

See more details on using hashes here.

File details

Details for the file at_audioutil_pkg-0.0.5-py3-none-any.whl.

File metadata

File hashes

Hashes for at_audioutil_pkg-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 59d3ae59aab4d5524460e7f4ebbdbd65ea12598eca576d1af43cde149db11b25
MD5 fe39ffb128fc7c7fb8869a0b979166c5
BLAKE2b-256 438ab20285f17f99016b6d223f8207dcbd14a9443adc7768e99e3c8acfc22a49

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page