Skip to content

Latest commit

 

History

History
220 lines (151 loc) · 6.49 KB

File metadata and controls

220 lines (151 loc) · 6.49 KB

Glossary

This document defines key terms and concepts used in BitPerfectCore and audiophile audio playback.

Audio Terms

Bit-Perfect

Audio playback where the digital audio data is passed to the DAC exactly as it exists in the source file, without any modification, processing, or conversion. Every bit matches the original.

Sample Rate

The number of audio samples per second, measured in Hz or kHz. Common rates: 44.1kHz (CD quality), 48kHz, 96kHz, 192kHz, 384kHz.

Bit Depth

The number of bits used to represent each audio sample. Common depths: 16-bit (CD quality), 24-bit (studio quality), 32-bit (floating point).

DAC (Digital-to-Analog Converter)

Hardware device that converts digital audio signals to analog signals for speakers or headphones.

Lossless Audio

Audio compression that preserves all original data. Formats: FLAC, ALAC, WAV, AIFF, APE, WavPack.

Lossy Audio

Audio compression that discards data to reduce file size. Formats: MP3, AAC, OGG, Opus. (Not supported by BitPerfectCore)

PCM (Pulse Code Modulation)

Standard digital audio format representing audio as a sequence of samples.

DSD (Direct Stream Digital)

Alternative digital audio format using 1-bit samples at very high rates (2.8MHz, 5.6MHz, 11.2MHz).

Gapless Playback

Seamless transition between tracks with no silence or interruption, essential for albums and live recordings.

Exclusive Mode (Hog Mode)

Taking complete control of an audio device, bypassing system audio mixing and processing.

Resampling

Converting audio from one sample rate to another. Avoided in bit-perfect playback as it modifies the audio.

Buffer

Temporary memory storage for audio data before playback. Prevents dropouts and glitches.

Latency

Time delay between audio processing and output. Lower is better for real-time applications.

Jitter

Timing variations in digital audio signals. Can affect audio quality.

Clipping

Audio distortion when signal exceeds maximum level. Should never occur in bit-perfect playback.

Headroom

Available dynamic range before clipping occurs.

CoreAudio Terms

CoreAudio HAL (Hardware Abstraction Layer)

macOS framework for low-level audio hardware access.

Audio Device

Physical or virtual audio hardware (DAC, sound card, etc.).

Audio Stream

Flow of audio data from source to device.

IOProc (Input/Output Procedure)

Callback function that provides audio data to hardware.

Audio Unit

macOS audio processing plugin. Not used in bit-perfect path.

Sample Rate Conversion (SRC)

Resampling performed by the system. Bypassed in bit-perfect mode.

Audio Queue

High-level audio API. Not used by BitPerfectCore (uses HAL instead).

BitPerfectCore Terms

Audio Engine

Core component that orchestrates bit-perfect playback.

Audio Renderer

Component that sends audio directly to hardware.

Format Decoder

Component that decodes audio files to PCM.

Sample Rate Matcher

Component that configures device to match source sample rate.

Buffer Manager

Component that manages audio buffer allocation and queuing.

Device Manager

Component that enumerates and configures audio devices.

Gapless Player

Component that handles seamless track transitions.

Metadata Extractor

Component that reads audio file metadata (tags, artwork).

Audiophile Terms

Transparent

Audio reproduction without coloration or character. The goal of bit-perfect playback.

Colored

Audio reproduction with added character or modification. Avoided in bit-perfect playback.

Neutral

Audio equipment or playback that doesn't add or subtract from the source.

Fidelity

Faithfulness to the original recording. High fidelity = accurate reproduction.

Resolution

Level of detail in audio reproduction. Higher sample rate and bit depth = higher resolution.

Dynamic Range

Difference between quietest and loudest sounds. Measured in dB.

Frequency Response

Range of frequencies a system can reproduce. Ideally flat (20Hz-20kHz for human hearing).

THD (Total Harmonic Distortion)

Measure of distortion in audio signal. Lower is better.

SNR (Signal-to-Noise Ratio)

Ratio of signal to background noise. Higher is better.

File Format Terms

FLAC (Free Lossless Audio Codec)

Popular open-source lossless audio format. Supported by BitPerfectCore.

ALAC (Apple Lossless Audio Codec)

Apple's lossless audio format. Supported by BitPerfectCore.

WAV (Waveform Audio File Format)

Uncompressed PCM audio. Supported by BitPerfectCore.

AIFF (Audio Interchange File Format)

Apple's uncompressed PCM format. Supported by BitPerfectCore.

DSF/DFF

DSD audio file formats. Supported by BitPerfectCore.

APE (Monkey's Audio)

Lossless compression format. Planned support.

WavPack

Hybrid lossless/lossy format. Planned support.

Metadata Tags

Embedded information in audio files (artist, album, title, etc.). ID3, Vorbis Comments, APE tags.

Technical Terms

Thread-Safe

Code that can be safely called from multiple threads simultaneously.

Lock-Free

Algorithm that doesn't use locks, essential for real-time audio.

Real-Time

Processing that must complete within strict time constraints. Audio rendering is real-time.

Deterministic

Behavior that is predictable and consistent. Required for audio thread.

Async/Await

Swift's asynchronous programming model.

Protocol-Oriented

Design approach using Swift protocols for abstraction.

Dependency Injection

Design pattern for providing dependencies to components.

Unit Test

Test of individual component in isolation.

Integration Test

Test of multiple components working together.

Code Coverage

Percentage of code executed by tests.

Acronyms

  • API - Application Programming Interface
  • SPM - Swift Package Manager
  • HAL - Hardware Abstraction Layer
  • PCM - Pulse Code Modulation
  • DSD - Direct Stream Digital
  • DAC - Digital-to-Analog Converter
  • ADC - Analog-to-Digital Converter
  • FLAC - Free Lossless Audio Codec
  • ALAC - Apple Lossless Audio Codec
  • WAV - Waveform Audio File Format
  • AIFF - Audio Interchange File Format
  • THD - Total Harmonic Distortion
  • SNR - Signal-to-Noise Ratio
  • dB - Decibel
  • Hz - Hertz
  • kHz - Kilohertz
  • MHz - Megahertz
  • CPU - Central Processing Unit
  • RAM - Random Access Memory
  • I/O - Input/Output
  • UI - User Interface
  • UX - User Experience
  • MVP - Minimum Viable Product

Last Updated: June 2026
Note: This glossary will be expanded as the project develops.