Skip to content

Conversation

un33k
Copy link

@un33k un33k commented Jun 21, 2025

Description:

Summary

  • Implements zero-channel BlackHole variant as an audio termination device (/dev/null for audio)
  • Updates installation documentation to separate standard variants from the experimental 0ch variant
  • Removes 0ch from standard installer build loop to prevent accidental distribution
  • Adds dedicated installer script for 0ch variant with proper warnings

Changes

  • Installer/create_installer.sh: Remove 0ch from standard build loop
  • README.md: Add manual build instructions for 0ch variant with clear warnings
  • scripts/create_0ch_installer.sh: New dedicated installer script for 0ch variant
  • Previous commits added the core zero-channel driver implementation

Test plan

  • Verify standard installers (2ch, 16ch, etc.) build correctly without 0ch
  • Test manual 0ch build instructions work as documented
  • Confirm 0ch installer script creates working package
  • Validate 0ch variant appears as audio termination device in Audio MIDI Setup

bitshifterr and others added 3 commits June 20, 2025 20:04
Implements a zero-channel version of BlackHole that acts as an audio
sink (/dev/null equivalent) for applications that need to terminate
audio output. This enables advanced audio routing workflows where
audio data should be discarded rather than looped back.

Key changes:
- Add zero-channel safety validation and buffer allocation handling
- Modify memory operations to handle zero-byte operations safely
- Update build system to include 0-channel variant (BlackHole0ch)
- Maintain compatibility with existing multi-channel versions
- Comprehensive README documentation with use cases and examples
- Updated CHANGELOG.md with feature description
- Added detailed build instructions for developers

The zero-channel device appears as "BlackHole 0ch" in Audio MIDI Setup
and can be selected by applications as an output device that silently
discards all audio data.

Use cases:
- Audio software development and testing
- Automated testing without sound output
- Advanced audio routing and stream termination
- System administration and selective audio muting

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- build_all_variants.sh: Build all BlackHole variants including 0ch
- verify_zero_channel.sh: Verify zero-channel installation and functionality

These scripts help developers and users work with the new zero-channel
audio termination feature.
- Remove 0ch from standard installer build loop
- Add manual build instructions for 0ch variant in README
- Create dedicated installer script for 0ch variant
- Clarify 0ch is for development/testing as audio termination device

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants