Skip to content

Repository files navigation

SoundCheck

A signal generator utility for macOS, to help sound engineers, audio technicians and audiophiles test sound recording and reproduction equipment. Generates test signals only — SoundCheck is not an audio analyser and never captures or measures audio.

Status

V1 is built: sine wave, pink noise, and white noise generators, with the full UI chrome (on/off, frequency field, level field, output device picker, per-channel mute/phase, live sample rate/bit depth display) wired end-to-end to a real AVAudioEngine graph, live Core Audio device enumeration, and persisted settings. See docs/v1-spec.md for the complete spec and the SoundCheck V1 map (closed) for how it was built.

V2 is in progress on the V2 map. Done so far: band-limited pink noise (5 presets + manual range) and 1/3-octave pink noise (31 ISO 266 bands), both live as sub-modes of the Pink signal type. Sine sweep and square wave are still being built out — see the map for current status.

Requirements

  • macOS, Xcode (SwiftUI + AVAudioEngine + Core Audio). iOS portability is considered but not designed for yet.

Building and testing

xcodebuild -project SoundCheck.xcodeproj -scheme SoundCheck -destination 'platform=macOS' build
xcodebuild -project SoundCheck.xcodeproj -scheme SoundCheck -destination 'platform=macOS' test

Or open SoundCheck.xcodeproj in Xcode and use Cmd-R / Cmd-U.

Documentation

  • docs/v1-spec.md — the V1 feature spec: signal types, screen layout, control behaviors, audio engine architecture, and the full decisions log.
  • CONTEXT.md — domain glossary.
  • docs/adr/ — architecture decision records.
  • docs/research/ — research writeups backing specific technical decisions.

Roadmap

  • V1: sine, pink noise, white noise. Done.
  • V2: band-limited pink noise (done), 1/3-octave pink noise (31 standard ISO 266 bands, done), sine sweeps (in progress), square wave (not started).

Out of scope: any audio analysis, metering, or capture.

License

GPLv3 — see LICENSE.

About

A signal generator utility for macOS, to help sound engineers, audio technicians and audiophiles test sound recording and reproduction equipment.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages