Initial release: README.md

README.md

@@ -0,0 +1,72 @@
+---
+license: lgpl-2.1
+library_name: other
+tags:
+- audio
+- dsp
+- spectral
+- granular
+- waveset
+- cdp
+- composers-desktop
+- electroacoustic
+---
+
+# CDP8 binaries — mirrored for MAESTRO
+
+Cross-platform pre-built binaries of the [Composers Desktop Project (CDP) Release 8](https://github.com/ComposersDesktop/CDP8) — Trevor Wishart's classical DSP program suite — packaged for fetch-on-demand installation inside [MAESTRO](https://github.com/AEmotionStudio/maestro).
+
+## What's in this repo
+
+| Platform              | File                          | Status     | Notes |
+|-----------------------|-------------------------------|------------|-------|
+| Linux x86_64          | `cdp8-linux-x86_64.tar.gz`    | ✓ Available | 220 binaries, ~29 MB compressed / ~65 MB extracted |
+| macOS ARM64           | (not yet available)           | —          | Needs a Mac to build |
+| macOS x86_64          | (not yet available)           | —          | Needs a Mac to build |
+| Windows x86_64        | (not yet available)           | —          | MinGW build pending |
+
+Each platform tarball is self-contained: 220 program binaries, the LGPL-2.1
+license text, attribution notes, and a modification disclosure.
+
+## Why this repo exists
+
+CDP's upstream releases ship full installers for macOS and Windows but not for
+Linux (which expects users to build from source). MAESTRO needs the same set
+of binaries on every supported platform, packaged so its CDP panel can
+fetch-on-demand without asking users to install a CMake toolchain. This repo
+is that distribution layer.
+
+We do **not** modify CDP's audio algorithms or behavior — only build
+configuration where needed for non-Clang compilers. See `MODIFICATIONS.md`
+inside each tarball for the exact diff.
+
+## License & attribution
+
+CDP is licensed under the [GNU LGPL-2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html). The binaries in this repo are unmodified builds (apart from documented build-system patches) and are redistributed under the same license.
+
+**Original authors**: Trevor Wishart, Richard Dobson, and contributors to the Composers Desktop Project (1986–present).
+
+**Source code**: https://github.com/ComposersDesktop/CDP8
+
+## How MAESTRO uses these
+
+When a user opens the CDP panel in MAESTRO's AI tab → Design category:
+
+1. MAESTRO checks `~/.maestraea/cdp/bin/` for existing binaries.
+2. If missing, it fetches `cdp8-<platform>.tar.gz` from this repo via
+   `huggingface_hub.hf_hub_download` and extracts to `~/.maestraea/cdp/bin/`.
+3. The panel browser then lists all 200+ programs across 13 categories.
+
+You don't need a HuggingFace account or token to download — this repo is public.
+
+## Contributing builds for other platforms
+
+If you're on macOS or Windows and want to contribute a tarball:
+
+1. Clone https://github.com/ComposersDesktop/CDP8
+2. Apply the patch in `MODIFICATIONS.md` (gates `-stdlib=libc++` behind Clang)
+3. Build per `building.txt` — `cmake -DUSE_LOCAL_PORTAUDIO=OFF .. && make`
+4. Package the `NewRelease/` directory as `cdp8-<platform>.tar.gz` with the
+   layout shown above
+5. Open a PR on https://github.com/AEmotionStudio/maestro (or open an issue
+   and we'll upload the artifact)