bdbarnett · Oct 31, 2026 · Oct 31, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to `audioinstruments` are recorded here.
+
+## 0.5.0
+
+The first release from this repository. It replaces the `audioinstruments`
+that was published from PyDevices/audiocomponents up to 0.4.x: a new set of
+instruments, not an update of the old ones.
+
+- Every instrument is a patch of modules on a virtual rack, rendered a block
+  at a time on [audiodsp](https://github.com/PyDevices/audiodsp), on CPython
+  and on MicroPython-compatible firmware.
+- Create one by name: `audioinstruments.create("poly106", 48000)`.
+  `audioinstruments.ALL`, `MELODIC`, `DRUM_MACHINES` and `SAMPLERS` list them,
+  and each instrument's module holds its macros and patches.
+- Drum machines list their pads in `NOTE_MAP`.
+- The rack is `audioinstruments._rack`, private: instruments are the public
+  surface, and the rack's modules and jacks may change between releases.
+- Published as `omnipython-audioinstruments`; the import name is still
+  `audioinstruments`, and the MIP package is still `audioinstruments`.
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-0.5.0.dev2
+0.5.0
diff --git a/lib/audioinstruments/acid303.py b/lib/audioinstruments/acid303.py
@@ -6,7 +6,7 @@
 NAME = "acid303"
 DISPLAY_NAME = "Acid303"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/bass_pedals.py b/lib/audioinstruments/bass_pedals.py
@@ -6,7 +6,7 @@
 NAME = "bass_pedals"
 DISPLAY_NAME = "Bass Pedals"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/clavichord.py b/lib/audioinstruments/clavichord.py
@@ -6,7 +6,7 @@
 NAME = "clavichord"
 DISPLAY_NAME = "Clavichord"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/combo_organ.py b/lib/audioinstruments/combo_organ.py
@@ -6,7 +6,7 @@
 NAME = "combo_organ"
 DISPLAY_NAME = "ComboOrgan"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/compact_organ.py b/lib/audioinstruments/compact_organ.py
@@ -6,7 +6,7 @@
 NAME = "compact_organ"
 DISPLAY_NAME = "Compact Organ"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/duo20.py b/lib/audioinstruments/duo20.py
@@ -6,7 +6,7 @@
 NAME = "duo20"
 DISPLAY_NAME = "Duo20"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/duosynth.py b/lib/audioinstruments/duosynth.py
@@ -6,7 +6,7 @@
 NAME = "duosynth"
 DISPLAY_NAME = "DuoSynth"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/electric_grand70.py b/lib/audioinstruments/electric_grand70.py
@@ -6,7 +6,7 @@
 NAME = "electric_grand70"
 DISPLAY_NAME = "ElectricGrand70"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/electric_piano.py b/lib/audioinstruments/electric_piano.py
@@ -6,7 +6,7 @@
 NAME = "electric_piano"
 DISPLAY_NAME = "Electric Piano"
 CATEGORIES = ("Piano",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/electronic_drums5.py b/lib/audioinstruments/electronic_drums5.py
@@ -6,7 +6,7 @@
 NAME = "electronic_drums5"
 DISPLAY_NAME = "ElectronicDrums5"
 CATEGORIES = ("Drum",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/hybrid_mono.py b/lib/audioinstruments/hybrid_mono.py
@@ -6,7 +6,7 @@
 NAME = "hybrid_mono"
 DISPLAY_NAME = "HybridMono"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/mono101.py b/lib/audioinstruments/mono101.py
@@ -6,7 +6,7 @@
 NAME = "mono101"
 DISPLAY_NAME = "Mono101"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/mono_one.py b/lib/audioinstruments/mono_one.py
@@ -6,7 +6,7 @@
 NAME = "mono_one"
 DISPLAY_NAME = "MonoOne"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/mono_synth.py b/lib/audioinstruments/mono_synth.py
@@ -6,7 +6,7 @@
 NAME = "mono_synth"
 DISPLAY_NAME = "Mono Synth"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/patch2600.py b/lib/audioinstruments/patch2600.py
@@ -6,7 +6,7 @@
 NAME = "patch2600"
 DISPLAY_NAME = "Patch2600"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/poly106.py b/lib/audioinstruments/poly106.py
@@ -6,7 +6,7 @@
 NAME = "poly106"
 DISPLAY_NAME = "Poly106"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/poly5.py b/lib/audioinstruments/poly5.py
@@ -6,7 +6,7 @@
 NAME = "poly5"
 DISPLAY_NAME = "Poly5"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/poly6.py b/lib/audioinstruments/poly6.py
@@ -6,7 +6,7 @@
 NAME = "poly6"
 DISPLAY_NAME = "Poly6"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/poly8.py b/lib/audioinstruments/poly8.py
@@ -6,7 +6,7 @@
 NAME = "poly8"
 DISPLAY_NAME = "Poly8"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/poly80.py b/lib/audioinstruments/poly80.py
@@ -6,7 +6,7 @@
 NAME = "poly80"
 DISPLAY_NAME = "Poly80"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/polya6.py b/lib/audioinstruments/polya6.py
@@ -6,7 +6,7 @@
 NAME = "polya6"
 DISPLAY_NAME = "PolyA6"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/polyxa.py b/lib/audioinstruments/polyxa.py
@@ -6,7 +6,7 @@
 NAME = "polyxa"
 DISPLAY_NAME = "PolyXa"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/reed_piano.py b/lib/audioinstruments/reed_piano.py
@@ -6,7 +6,7 @@
 NAME = "reed_piano"
 DISPLAY_NAME = "ReedPiano"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/reed_piano200a.py b/lib/audioinstruments/reed_piano200a.py
@@ -6,7 +6,7 @@
 NAME = "reed_piano200a"
 DISPLAY_NAME = "Reed Piano 200A"
 CATEGORIES = ("Piano",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/rhythm606.py b/lib/audioinstruments/rhythm606.py
@@ -6,7 +6,7 @@
 NAME = "rhythm606"
 DISPLAY_NAME = "Rhythm606"
 CATEGORIES = ("Drum",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/rhythm78.py b/lib/audioinstruments/rhythm78.py
@@ -6,7 +6,7 @@
 NAME = "rhythm78"
 DISPLAY_NAME = "Rhythm78"
 CATEGORIES = ("Drum",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/rhythm808.py b/lib/audioinstruments/rhythm808.py
@@ -6,7 +6,7 @@
 NAME = "rhythm808"
 DISPLAY_NAME = "Rhythm808"
 CATEGORIES = ("Drum",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/rhythm909.py b/lib/audioinstruments/rhythm909.py
@@ -6,7 +6,7 @@
 NAME = "rhythm909"
 DISPLAY_NAME = "Rhythm909"
 CATEGORIES = ("Drum",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/soundfont.py b/lib/audioinstruments/soundfont.py
@@ -6,7 +6,7 @@
 NAME = "soundfont"
 DISPLAY_NAME = "SoundFont"
 CATEGORIES = ("Sampler",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/soundfont_drums.py b/lib/audioinstruments/soundfont_drums.py
@@ -6,7 +6,7 @@
 NAME = "soundfont_drums"
 DISPLAY_NAME = "SoundFont Drums"
 CATEGORIES = ("Drum", "Sampler")
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/state_variable_mono.py b/lib/audioinstruments/state_variable_mono.py
@@ -6,7 +6,7 @@
 NAME = "state_variable_mono"
 DISPLAY_NAME = "StateVariableMono"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/string_ensemble.py b/lib/audioinstruments/string_ensemble.py
@@ -6,7 +6,7 @@
 NAME = "string_ensemble"
 DISPLAY_NAME = "String Ensemble"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/tonewheel3.py b/lib/audioinstruments/tonewheel3.py
@@ -6,7 +6,7 @@
 NAME = "tonewheel3"
 DISPLAY_NAME = "Tonewheel3"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/vocoder330.py b/lib/audioinstruments/vocoder330.py
@@ -6,7 +6,7 @@
 NAME = "vocoder330"
 DISPLAY_NAME = "Vocoder330"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (

diff --git a/lib/audioinstruments/west_coast_synth.py b/lib/audioinstruments/west_coast_synth.py
@@ -6,7 +6,7 @@
 NAME = "west_coast_synth"
 DISPLAY_NAME = "WestCoastSynth"
 CATEGORIES = ("Synth",)
-VERSION = "0.5.0.dev2"
+VERSION = "0.5.0"
 VENDOR = "PyDevices"
 
 MACRO_LABELS = (