Skip to content
Treefall SDKDocumentation
Treefall SDK source on GitHub

Support matrix

This page describes the Treefall SDK 0.9.0 support boundary. “Supported” means the surface is built, SDK-owned checks run, and the installed package is consumed through documented targets in required qualification. Source compilation alone does not promote a device backend.

Release tiers

Section titled “Release tiers”

The matrix is easiest to use by platform:

macOS

Section titled “macOS”
  • Host-neutral core, session, transport, routing, analysis, writer, and input: Supported.
  • Installed CMake package and documented target catalog: Supported.
  • Dummy audio driver: Supported.
  • CoreAudio device backend: Supported on macOS (Apple desktop).
  • WASAPI, ASIO, ALSA, JACK, and PipeWire device backends: Unavailable.

Windows

Section titled “Windows”
  • Host-neutral core, session, transport, routing, analysis, writer, and input: Supported.
  • Installed CMake package and documented target catalog: Source/package validation only.
  • Dummy audio driver: Supported.
  • WASAPI device backend: Source/fake-test capable only; not release-supported.
  • ASIO device backend: Optional source-only integration requiring a separately supplied SDK; excluded from install/export.
  • CoreAudio, ALSA, JACK, and PipeWire device backends: Unavailable.

Linux

Section titled “Linux”
  • Host-neutral core, session, transport, routing, analysis, writer, and input: Supported.
  • Installed CMake package and documented target catalog: Supported.
  • Dummy audio driver: Supported.
  • ALSA device backend: Not implemented.
  • CoreAudio, WASAPI, ASIO, JACK, and PipeWire device backends: Unavailable.

Important: the generated Windows target entry for WASAPI does not make WASAPI release-supported. It records source and fake-runtime capability only; package/ABI and physical-device evidence are still required for promotion. Likewise, Linux has no production device backend. The only advertised Linux driver is Dummy, while ALSA, JACK, and PipeWire remain separate future providers.

Toolchains and package minimum

Section titled “Toolchains and package minimum”

The package minimum is CMake 3.22 and a compiler with C++20 support. Required qualification uses Apple Clang with libc++ on macOS, Visual Studio 2022 MSVC with vcpkg x64-windows on Windows, and GCC with libstdc++ on Linux. Architectures and toolchain versions outside that matrix may work but are not release-qualified until added to required qualification.

The host-neutral package surface includes Treefall::core, Treefall::diagnostics, Treefall::audio_utils, Treefall::audio_io, Treefall::audio_driver_manager, Treefall::routing, and Treefall::transport. Consumers must test target presence in the discovered package or query runtime capabilities; do not infer target availability from a platform label.

Device promotion rules

Section titled “Device promotion rules”

CoreAudio is the shipped production device backend on macOS (Apple desktop). WASAPI remains source/fake-test capable but not release-supported. ASIO requires a separately supplied vendor SDK and is source-only, never part of install/export/catalog artifacts. No production ALSA, JACK, or PipeWire provider is claimed. A backend becomes supported only after its package, ABI, backend conformance, and real-device acceptance evidence satisfy the release gate.

Source authority

Section titled “Source authority”
Product 0.9.0
Source revision: b8c8b87540fe585b5c7d5c8f25d193c1a1af93d5
Documentation revision: 1cb4aaf851fd4a137427caf4242e6da389dd87c7

Source and verification details are producer-declared evidence.

Report a documentation problem

Destination: https://github.com/boot-industries/treefall-sdk/issues/new

Outgoing title: Documentation: Support matrix

Documentation page: https://docs.treefall.dev/reference/support-matrix/
Document ID: reference.support-matrix
Product version: 0.9.0
Source revision: b8c8b87540fe585b5c7d5c8f25d193c1a1af93d5
Documentation revision: 1cb4aaf851fd4a137427caf4242e6da389dd87c7
Channel: release

Describe your question or documentation problem here.

Continuing sends this page context to GitHub. The destination may be public. Do not include private documentation, credentials, or security reports.

Continue to GitHubOpen without page context
Reviewed: 2026-09-09Source owners: docs/SUPPORT_MATRIX.md · include/orpheus/audio_driver.h · include/orpheus/audio_driver_manager.h

Last updated: