kxkm 949508c636 docs: rewrite 9 instrument manuals in proper markdown format
All manuals follow openDAW convention: numbered sections, paragraph descriptions,
MIDI behavior documented, backend info, usage examples.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 13:54:35 +01:00
2025-12-12 09:18:48 +01:00
2026-01-09 17:50:52 +01:00
2026-03-13 14:57:24 +01:00
2026-03-19 21:12:19 +01:00
2025-12-23 16:51:41 +01:00
2025-08-11 13:52:50 +02:00
2025-05-31 16:00:49 +02:00
2026-03-13 11:30:59 +01:00
2025-07-11 13:27:47 +02:00
2026-01-20 11:33:03 +01:00
2026-01-24 08:42:01 +01:00
2025-07-11 13:41:58 +02:00
2026-03-20 11:29:30 +01:00
2026-02-16 10:05:09 +01:00
2025-12-29 18:32:28 +01:00

openDIAW.be

Fork performance de openDAW pour le projet 3615 J'ai pété — KXKM

License: AGPLv3 upstream


Pourquoi ce fork ?

openDIAW.be est un fork d'openDAW créé pour le spectacle de clown 3615 J'ai pété de la compagnie KXKM. Il ajoute des instruments et des intégrations AI spécifiques à la performance live, tout en restant compatible avec l'upstream.

Ce que le fork ajoute

Catégorie Ajout
9 instruments Drone, Grain, Glitch, Circus, Honk, Magenta, AceStep, KokoroTTS, Piper
AI Bridge 17 backends audio (TTS, musique IA, synthèse, séparation de stems)
Intégration serveur Proxy API, génération audio via ffmpeg, Ollama, ACE-Step, Kokoro
Branding openDIAW.be (Digital Instrument Audio Workstation)

Instruments DSP temps réel

Ces instruments tournent dans le browser via AudioWorklet — pas de serveur nécessaire.

Instrument Description Paramètres clés
Drone Synthé de pads/drones Waveform, unison (1-7), detune, LP filter, LFO rate/depth, stereo
Grain Synthèse granulaire Position, grain size, density, pitch/pos spread + sample drop
Glitch Générateur de textures glitch Buffer repeat, stutter, bit crush, downsample, reverse, pitch shift
Circus Orgue de barbarie / calliope 4 registres (Flute 8', Flute 4', Principal, Mixture), tremolo, wobble, air
Honk Klaxon / sirène / corne 3 modes (Klaxon, Siren, Horn), sweep paramétrique, harmoniques
Magenta AI MIDI generator Magenta.js browser-side (MelodyRNN, DrumsRNN, ImprovRNN), temperature, steps

Instruments AI-backed

Ces instruments génèrent de l'audio via le serveur AI Bridge (:8301).

Instrument Backend Description
AceStep ACE-Step Génération musicale IA par prompt (style + bpm + durée)
KokoroTTS Kokoro Synthèse vocale rapide — 12 voix (af_heart, am_adam, bf_emma...)
Piper Piper/Chatterbox Synthèse vocale TTS avec personas

AI Bridge

Le AI Bridge (ai-bridge.js) est un serveur Node.js qui orchestre 17 backends :

POST /instrument/drone     — Drone synthétique (ffmpeg)
POST /instrument/grain     — Granulaire (ffmpeg)
POST /instrument/glitch    — Glitch (ffmpeg, acrusher, stutter)
POST /instrument/circus    — Orgue de barbarie (ffmpeg)
POST /instrument/honk      — Klaxon/sirène (ffmpeg)
POST /instrument/drums     — Drums (ffmpeg)
POST /instrument/bass      — Basse (ffmpeg)
POST /instrument/pad       — Pads (ffmpeg)
POST /instrument/choir     — Choeur (TTS + pitch shift)
POST /instrument/fx        — Effets (riser, drop, sweep, impact, stutter)
POST /generate/music       — Musique (ACE-Step → fallback MusicGen)
POST /generate/music-ai    — Musique (ACE-Step direct)
POST /generate/voice       — Voix (Chatterbox/Piper)
POST /generate/voice-fast  — Voix rapide (Kokoro, 12 voix)
POST /generate/noise       — Bruit (white/pink/brown/sine/drone)
POST /separate             — Séparation de stems (Demucs)
POST /master               — Mastering IA (Matchering)

Architecture

┌─────────────────────────────────────────┐
│          openDIAW.be (browser)          │
│  ┌──────────┐  ┌──────────┐            │
│  │ 9 instru │  │ Magenta  │            │
│  │ AudioWork│  │   .js    │            │
│  └──────────┘  └──────────┘            │
└──────────────┬──────────────────────────┘
               │ fetch /api/v2/ai-bridge/*
┌──────────────▼──────────────────────────┐
│        3615-KXKM API (:3333)            │
│        (proxy → AI Bridge)              │
└──────────────┬──────────────────────────┘
               │
┌──────────────▼──────────────────────────┐
│       AI Bridge (:8301)                 │
│  ┌────────┐ ┌────────┐ ┌────────┐      │
│  │ Kokoro │ │ACE-Step│ │ Ollama │      │
│  │ :9201  │ │ :9200  │ │ :11434 │      │
│  └────────┘ └────────┘ └────────┘      │
│  ┌────────┐ ┌────────┐ ┌────────┐      │
│  │ Piper  │ │ ffmpeg │ │ Demucs │      │
│  │ :9100  │ │ (local)│ │        │      │
│  └────────┘ └────────┘ └────────┘      │
└─────────────────────────────────────────┘

Upstream

Ce fork est basé sur openDAW par André Michelle, sous licence AGPL v3.

Les contributions upstream sont les bienvenues. Les instruments et l'AI Bridge sont des ajouts qui ne modifient pas le code upstream existant — ils s'ajoutent via le système de visitor/factory.

Différences avec upstream

  • 9 instruments ajoutés (schema + box + adapter + processor + UI)
  • AI Bridge (ai-bridge.js) pour la génération audio serveur
  • serve-studio.js pour le service HTTPS local
  • Branding renommé en openDIAW.be
  • Workflows CI supprimés (pas pertinents pour le fork)

Installation

git clone https://github.com/electron-rare/openDIAW.be.git && cd openDIAW.be
npm install
npm run build
npm run dev:studio

License

AGPL v3 (or later) © 2025 André Michelle

Fork par KXKM / electron-rare

S
Description
openDIAW.be — AI-powered music instruments (Drone, Grain, Glitch, KokoroTTS, Piper, AceStep)
Readme 45 MiB
Languages
TypeScript 95.3%
Sass 2.6%
JavaScript 1.8%
HTML 0.2%