Skip to content
SynthHub

Open Synth Descriptors

The MIDI standards say how messages travel; they say little about a given synth, and nothing about the sounds and firmwares people share. Open Synth Descriptors (OSD) describe the rest, in plain JSON checked by JSON Schema, free for any tool to read and write (CC0, public domain).

Descriptor What it says
Device How it is recognised, its controls (CC, NRPN, RPN, SysEx), its messages and checksums, programs and banks, drum notes, and where each piece of data comes from
Maker profile What a maker's devices share, extended by each
Sound A shared sound, kit, pattern or clip: its data, device, firmware, author, licence and origin
Fingerprint What was seen of a device plugged in (port names, its answer, the controls its knobs sent) and the model the person confirmed: recognises devices that do not say who they are, and starts the description of one the catalogue lacks
Firmware A firmware or mod: author, repository, licence, what it changes to the MIDI, how to install and revert it

Every one of the 973 devices of the catalogue is a valid OSD device descriptor: each device page links to its file. Each shared sound downloads as an OSD sound descriptor, and Which devices are plugged in? recognises a device by its fingerprint. The catalogue's device files are kept in OSD 0.5, the published version: a device file written in 0.4 is converted to 0.5 when it is written. Sounds are exported in OSD 0.5.

The format, examples, a checker and how to propose changes: github.com/roomi-fields/open-synth-descriptors. Version 0.5 is a draft (0.1, 0.2, 0.3 and 0.4 stay at osd/0.1/, osd/0.2/, osd/0.3/ and osd/0.4/); a published version never changes, later ones live beside it. Each version also has a permanent address, independent of this site: https://w3id.org/osd/<version>/<name>.schema.json, for example w3id.org/osd/0.5/device.schema.json.