haybale-audio 0.4.0__tar.gz

haybale_audio-0.4.0/.gitignore

@@ -0,0 +1,228 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# The MANIFEST/*.manifest packaging-artifact rules above are unanchored and
+# (on a case-insensitive filesystem) also match our real, tracked
+# haywire_studio/share/manifest/ package — un-ignore it explicitly.
+!packages/haywire-studio/src/haywire_studio/share/manifest/
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+**/.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the enitre vscode folder
+.vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+.DS_Store
+saves/*.*
+
+# Dev-mode graphs (local testing only, not part of the repo)
+graphs/*.json
+# MkDocs build output
+site/
+
+# Baked docs for the haywire-core wheel (generated by scripts/bake_docs.py;
+# force-included into the wheel at build time). The *contents* are never
+# committed, but the directory itself is kept via a committed .gitkeep so the
+# hatchling force-include target exists in a fresh checkout — otherwise every
+# editable install (`uv sync`) fails the build on a missing force-include path.
+packages/haywire-core/src/haywire/_baked_docs/*
+!packages/haywire-core/src/haywire/_baked_docs/.gitkeep
+
+# Local git worktrees (claude-code workflow)
+.worktrees/
+
+# Haywire project config (user-local, not repo state)
+.haywire/
+
+# Local symlinks to external dev projects (machine-specific paths)
+barn/haybale-visiongraph
+barn/haybale-spandrel
+barn/haybale-stream
+
+assets/*

haybale_audio-0.4.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.5
+Name: haybale-audio
+Version: 0.4.0
+Summary: Audio blocks, events and routing shared by speech and streaming libraries
+License: MIT
+Keywords: audio
+Requires-Python: >=3.12
+Requires-Dist: haybale-core>=0.4.0
+Requires-Dist: haywire-core>=0.4.0
+Requires-Dist: numpy
+Requires-Dist: samplerate>=0.2.4
+Requires-Dist: sounddevice>=0.5
+Requires-Dist: soundfile>=0.12

haybale_audio-0.4.0/README.md

@@ -0,0 +1,26 @@
+# Audio
+
+<!-- marketstall:share-url:start -->
+*Subscribe URL not yet published — run `uv run --frozen haywire share --bump patch`.*
+<!-- marketstall:share-url:end -->
+
+Audio blocks, events and routing shared by speech and streaming libraries
+
+## Nodes
+### Audio
+- **Audio Clock** — Emits a silent audio block at a steady rate
+- **Audio Event** — Triggered for each audio block a connected audio emitter delivers
+- **Audio Mixer** — Sums several audio sources into one block per clock tick
+- **Channel Merge** — Stacks audio blocks into one block with all their channels
+- **Channel Select** — Picks, reorders or repeats the channels of an audio block
+- **Channel Split** — Gives each channel of an audio block its own output
+- **Device Out** — Plays audio blocks on a sound device
+- **File Player** — Plays an audio file as audio blocks, in real time
+- **Mix to Mono** — Averages all channels of an audio block into one
+- **Reblock** — Re-cuts audio blocks to a fixed size and delivers them to Audio Event nodes
+- **Recorder** — Writes audio blocks to a file
+- **Resample** — Converts audio blocks to another sample rate and delivers them to Audio Event nodes
+
+## Types
+- **Audio** — A block of audio samples. Never saved with the graph.
+- **Callback Audio** — Subscription for emitters that deliver audio blocks

haybale_audio-0.4.0/haybale_audio/OVERVIEW.md

@@ -0,0 +1,22 @@
+# Audio
+
+Audio blocks, events and routing shared by speech and streaming libraries
+
+## Nodes
+### Audio
+- **Audio Clock** — Emits a silent audio block at a steady rate
+- **Audio Event** — Triggered for each audio block a connected audio emitter delivers
+- **Audio Mixer** — Sums several audio sources into one block per clock tick
+- **Channel Merge** — Stacks audio blocks into one block with all their channels
+- **Channel Select** — Picks, reorders or repeats the channels of an audio block
+- **Channel Split** — Gives each channel of an audio block its own output
+- **Device Out** — Plays audio blocks on a sound device
+- **File Player** — Plays an audio file as audio blocks, in real time
+- **Mix to Mono** — Averages all channels of an audio block into one
+- **Reblock** — Re-cuts audio blocks to a fixed size and delivers them to Audio Event nodes
+- **Recorder** — Writes audio blocks to a file
+- **Resample** — Converts audio blocks to another sample rate and delivers them to Audio Event nodes
+
+## Types
+- **Audio** — A block of audio samples. Never saved with the graph.
+- **Callback Audio** — Subscription for emitters that deliver audio blocks

haybale_audio-0.4.0/haybale_audio/QUICKREF.md

@@ -0,0 +1,19 @@
+# haybale-audio — component index (v0.4.0)
+
+## node
+- `haybale-audio:node:AudioClockNode` — Audio Clock — Emits a silent audio block at a steady rate  _tags: audio, clock, tick, timer, master, pace, emit_
+- `haybale-audio:node:AudioEventNode` — Audio Event — Triggered for each audio block a connected audio emitter delivers  _tags: audio, block, event, callback, receive, stream, microphone_
+- `haybale-audio:node:AudioMixerNode` — Audio Mixer — Sums several audio sources into one block per clock tick  _tags: audio, mixer, mix, sum, gain, mute, combine, bus_
+- `haybale-audio:node:ChannelMergeNode` — Channel Merge — Stacks audio blocks into one block with all their channels  _tags: audio, channel, merge, combine, stack, join, multichannel_
+- `haybale-audio:node:ChannelSelectNode` — Channel Select — Picks, reorders or repeats the channels of an audio block  _tags: audio, channel, select, route, map, left, right, stereo, mono_
+- `haybale-audio:node:ChannelSplitNode` — Channel Split — Gives each channel of an audio block its own output  _tags: audio, channel, split, separate, left, right, mono, multichannel_
+- `haybale-audio:node:DeviceOutNode` — Device Out — Plays audio blocks on a sound device  _tags: audio, play, speaker, output, device, sound_
+- `haybale-audio:node:FilePlayerNode` — File Player — Plays an audio file as audio blocks, in real time  _tags: audio, file, play, wav, flac, ogg, read, emit_
+- `haybale-audio:node:MixToMonoNode` — Mix to Mono — Averages all channels of an audio block into one  _tags: audio, mono, mix, downmix, average, stereo_
+- `haybale-audio:node:ReblockNode` — Reblock — Re-cuts audio blocks to a fixed size and delivers them to Audio Event nodes  _tags: audio, reblock, block, size, buffer, chunk_
+- `haybale-audio:node:RecorderNode` — Recorder — Writes audio blocks to a file  _tags: audio, record, write, save, file, wav, flac, ogg_
+- `haybale-audio:node:ResampleNode` — Resample — Converts audio blocks to another sample rate and delivers them to Audio Event nodes  _tags: audio, resample, sample rate, convert, 44100, 48000, 16000_
+
+## type
+- `haybale-audio:type:AUDIO` — Audio — A block of audio samples. Never saved with the graph.
+- `haybale-audio:type:CALLBACK_AUDIO` — Callback Audio — Subscription for emitters that deliver audio blocks

haybale_audio-0.4.0/haybale_audio/__init__.py

@@ -0,0 +1,33 @@
+"""Haybale-Audio: audio blocks shared by speech, streaming and device libraries.
+
+Provides:
+  - AudioBlock (``haybale_audio.value``): one block of planar float32 samples with its
+    sample rate, passed between nodes by reference and never mutated.
+
+Component folders (registered in ``register_components``):
+  - ``types``, ``nodes``: the AUDIO and CALLBACK_AUDIO types and the Audio Event node.
+"""
+
+from pathlib import Path
+
+from haywire.core.library.base import BaseLibrary
+from haywire.core.library.decorator import library
+from haywire.core.node.registry import NodeRegistry
+from haywire.core.types.registry import TypeRegistry
+
+
+@library(
+    file_watcher=True,
+)
+class Library(BaseLibrary):
+    """Audio library — audio block value, types and events."""
+
+    def register_components(self):
+        """Register the component folders with their registries."""
+        base_path = Path(__file__).parent
+
+        self.add_folder_to_registry(folder_path=str(base_path / "types"), registry_cls=TypeRegistry)
+        self.add_folder_to_registry(folder_path=str(base_path / "nodes"), registry_cls=NodeRegistry)
+
+    def validate(self) -> bool:
+        return True

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.AudioClockNode.md

@@ -0,0 +1,36 @@
+# Audio Clock
+
+`haybale-audio:node:AudioClockNode` · kind: node
+
+Emits a silent audio block at a steady rate
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `start` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `stop` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `callbacks` | inlet | `haybale-core:type:PooledType` | Connect to an Audio Event node. |
+| `status` | config | `haywire-core:type:STRING` | Text data |
+| `started` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `stopped` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+
+## Settings
+
+| name | bag | default | description |
+|---|---|---|---|
+| `sample_rate` | clock | `48000` | Samples per second of the blocks. |
+| `block_size` | clock | `256` | Samples per block. 256 at 48 kHz is a block every 5.3 ms. |
+
+## Notes
+
+Paces audio flows: one silent single-channel block per period, to every Audio Event listening.
+
+Wire the Audio Event that triggers a mixer to this node; the mixer then runs once per block.
+
+Inputs:
+    start / stop: Begin or end the ticks
+    callbacks: Pooled CALLBACK_AUDIO subscriptions from Audio Event nodes
+
+Outputs:
+    started / stopped: Control flow after the matching input

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.AudioEventNode.md

@@ -0,0 +1,35 @@
+# Audio Event
+
+`haybale-audio:node:AudioEventNode` · kind: node
+
+Triggered for each audio block a connected audio emitter delivers
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `listen_callback` | outlet | `haybale-audio:type:CALLBACK_AUDIO` | Subscription for emitters that deliver audio blocks |
+| `block_ready` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `audio` | outlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+| `timestamp` | outlet | `haywire-core:type:FLOAT` | Decimal number |
+| `block_number` | outlet | `haywire-core:type:INT` | Whole number |
+
+## Settings
+
+| name | bag | default | description |
+|---|---|---|---|
+| `queue_mode` | dispatch | `'Block (every block)'` | Block queues every block and back-pressures the emitter. Drop keeps only the newest block, so audio is lost whenever the flow runs behind. |
+| `max_queue_size` | dispatch | `100` | How many pending blocks to hold. 100 blocks of 256 samples at 48 kHz are about 0.5 s. |
+
+## Notes
+
+Runs its flow once per audio block from the emitter it is wired to.
+
+Connect `Listen` to the audio-callback inlet of an emitter (a device input, a stream
+receiver, a file player, a clock). The emitter sends
+`{"audio": AudioBlock, "timestamp": float, "block_number": int}`.
+
+Outputs:
+    block_ready: Control flow when a block arrives
+    audio: The block
+    timestamp / block_number: Seconds since the emitter started, and the count

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.AudioMixerNode.md

@@ -0,0 +1,47 @@
+# Audio Mixer
+
+`haybale-audio:node:AudioMixerNode` · kind: node
+
+Sums several audio sources into one block per clock tick
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `tick` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `clock` | inlet | `haybale-audio:type:AUDIO` | Block of the Audio Clock |
+| `in_0` | inlet | `haywire-core:type:ADD` | Grows a new port from whatever connects to it |
+| `status` | config | `haywire-core:type:STRING` | Text data |
+| `next` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `mixed` | outlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+
+## Settings
+
+| name | bag | default | description |
+|---|---|---|---|
+| `prefill` | mixer | `8` | Blocks an input queues before it is mixed. More blocks ride out longer stalls. |
+
+## Notes
+
+Mixes live sources that run on their own flows. Each source has its own input: connect its audio
+output to the open input at the bottom and it gets a `Write` pin, a `Gain` and a `Mute`; a new open
+input appears below.
+
+Wire each source's Audio Event Block Ready to its `Write` pin: the block is queued for that input.
+Wire an Audio Clock's Audio Event to `Tick` and `Clock`: every tick mixes one block per input, in the
+clock's sample rate and block size. Inputs at another sample rate or block size are converted, and
+a source clock that differs slightly from the tick clock is absorbed.
+
+An input is mixed once its prefill is queued, and again after a stall; until then it is silent. The
+sum is not limited, so loud sources can exceed ±1; the output has the most channels of any input, and
+a mono input plays on all of them.
+
+Inputs:
+    tick: Mix one block (wire it to the clock's Block Ready)
+    clock: The clock's block; its sample rate and size set the output
+    in_N / write_N: An input's audio and the pin that queues it
+    gain_N / mute_N: An input's level and mute
+
+Outputs:
+    next: Control flow after a block is mixed
+    mixed: The mixed block

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.ChannelMergeNode.md

@@ -0,0 +1,21 @@
+# Channel Merge
+
+`haybale-audio:node:ChannelMergeNode` · kind: node
+
+Stacks audio blocks into one block with all their channels
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `in_0` | inlet | `haywire-core:type:ADD` | Grows a new port from whatever connects to it |
+| `merged` | outlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+
+## Notes
+
+Joins the blocks on its inputs, in order, into one block. A single-channel input adds one
+channel; a multichannel input adds all of its channels.
+
+Connect an audio output to the open input at the bottom: it becomes an input of its own and a
+new open input appears below. Inputs without a block are skipped. All blocks must have the same
+sample rate and number of samples; an error names the difference.

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.ChannelSelectNode.md

@@ -0,0 +1,21 @@
+# Channel Select
+
+`haybale-audio:node:ChannelSelectNode` · kind: node
+
+Picks, reorders or repeats the channels of an audio block
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `audio` | inlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+| `channels` | config | `haywire-core:type:STRING` | Channel numbers from 0, like 0, 2-3 |
+| `selected` | outlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+
+## Notes
+
+Builds a block from the channels named in `Channels`, in that order.
+
+`Channels` is a list of channel numbers from 0 and inclusive ranges: `0` is the first channel,
+`1, 0` swaps a stereo pair, `0, 0` makes mono into stereo, `2-3` takes the third and fourth.
+An error names a channel the block does not have.

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.ChannelSplitNode.md

@@ -0,0 +1,21 @@
+# Channel Split
+
+`haybale-audio:node:ChannelSplitNode` · kind: node
+
+Gives each channel of an audio block its own output
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `audio` | inlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+| `ch_0` | outlet | `haywire-core:type:ADD` | Grows a new port from whatever connects to it |
+
+## Notes
+
+Outputs single channels of the input block. Output `Channel 0` is the first channel, `Channel 1`
+the second, and so on.
+
+Connect the open output at the bottom to something: it becomes the output for the next channel
+and a new open output appears below. Removing an output leaves the numbers of the others as they
+are. An error names a channel the block does not have.

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.DeviceOutNode.md

@@ -0,0 +1,45 @@
+# Device Out
+
+`haybale-audio:node:DeviceOutNode` · kind: node
+
+Plays audio blocks on a sound device
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `write` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `stop` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `audio` | inlet | `haybale-audio:type:AUDIO` | Block to play |
+| `status` | config | `haywire-core:type:STRING` | Text data |
+| `next` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `depth` | outlet | `haywire-core:type:INT` | Whole number |
+
+## Settings
+
+| name | bag | default | description |
+|---|---|---|---|
+| `device` | output | `'System default'` | Output device to play on. The list is read when the node is shown. |
+| `buffer_ms` | output | `300` | Audio the sound device holds ahead. It keeps playing when the program is busy for less than this, for example while a large graph loads; 0 uses the device's default. |
+| `prefill` | output | `8` | Blocks queued before playback starts and kept queued. More blocks ride out longer stalls of the flow, with more delay. |
+
+## Notes
+
+Plays each block on an output device. The first block opens the device at its own sample rate;
+blocks are converted to it, and a mono block plays on both speakers of a stereo device.
+
+Playback starts once the prefill is queued and restarts after a stall. A producer clock that
+differs slightly from the device clock is absorbed by adjusting the conversion ratio.
+
+Crackling means the computer was too busy to feed the device in time. The status shows two
+counters: `stalls` are times the flow did not deliver blocks fast enough (raise Prefill), `late`
+are times the sound device ran dry because the program was busy longer than the Device Buffer (raise it).
+
+Inputs:
+    write: Queue the block on `audio` (wire it to an Audio Event's Block Ready)
+    stop: Close the device; the next `write` opens it again
+    audio: The block to play
+
+Outputs:
+    next: Control flow after a block is queued
+    depth: Frames queued for the device

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.FilePlayerNode.md

@@ -0,0 +1,38 @@
+# File Player
+
+`haybale-audio:node:FilePlayerNode` · kind: node
+
+Plays an audio file as audio blocks, in real time
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `start` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `stop` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `path` | inlet | `haywire-core:type:FILE_PATH` | Audio file to play |
+| `callbacks` | inlet | `haybale-core:type:PooledType` | Connect to an Audio Event node. |
+| `status` | config | `haywire-core:type:STRING` | Text data |
+| `started` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `stopped` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+
+## Settings
+
+| name | bag | default | description |
+|---|---|---|---|
+| `block_size` | playback | `256` | Samples per block. The file's own sample rate and channels are kept. |
+| `loop` | playback | `False` | Start again at the end of the file instead of stopping. |
+
+## Notes
+
+Reads an audio file from a volume and delivers it, paced at the file's sample rate, to every
+Audio Event listening. The file's own sample rate and channel count are kept: a node that needs
+another format converts it (Reblock/Resample).
+
+Inputs:
+    start / stop: Begin or end playback
+    path: Audio file to play
+    callbacks: Pooled CALLBACK_AUDIO subscriptions from Audio Event nodes
+
+Outputs:
+    started / stopped: Control flow after the matching input

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.MixToMonoNode.md

@@ -0,0 +1,17 @@
+# Mix to Mono
+
+`haybale-audio:node:MixToMonoNode` · kind: node
+
+Averages all channels of an audio block into one
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `audio` | inlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+| `mono` | outlet | `haybale-audio:type:AUDIO` | A block of audio samples. Never saved with the graph. |
+
+## Notes
+
+Outputs one channel that is the average of the input's channels, which keeps the level of a
+stereo pair that carries the same signal on both sides.

haybale_audio-0.4.0/haybale_audio/docs/haybale-audio.node.ReblockNode.md

@@ -0,0 +1,37 @@
+# Reblock
+
+`haybale-audio:node:ReblockNode` · kind: node
+
+Re-cuts audio blocks to a fixed size and delivers them to Audio Event nodes
+
+## Ports
+
+| id | direction | type | description |
+|---|---|---|---|
+| `write` | inlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+| `audio` | inlet | `haybale-audio:type:AUDIO` | Block to add |
+| `callbacks` | inlet | `haybale-core:type:PooledType` | Connect to an Audio Event node. |
+| `status` | config | `haywire-core:type:STRING` | Text data |
+| `next` | outlet | `haywire-core:type:EXEC` | Signal for controlling execution flow between nodes |
+
+## Settings
+
+| name | bag | default | description |
+|---|---|---|---|
+| `block_size` | reblock | `256` | Samples per delivered block. |
+
+## Notes
+
+Collects the blocks that reach `Write` and delivers blocks of exactly `Block Size` samples to
+every Audio Event listening, in order. One input block can give several output blocks or none.
+
+The delivered blocks start a new flow: the Audio Event that receives them is the queue between
+the two rates. A change of channel count or sample rate in the input drops the samples still held.
+
+Inputs:
+    write: Add the block on `audio`
+    audio: The block to add
+    callbacks: Pooled CALLBACK_AUDIO subscriptions from Audio Event nodes
+
+Outputs:
+    next: Control flow after the block is taken in