Plugins `.gfpd`

GrooveForge Plugin Descriptor — un fichier YAML pour les métadonnées, le graphe de signal, les paramètres et l’interface.

Pourquoi ce format

La plupart des effets audio intégrés et tous les MIDI FX fournis sont décrits de façon déclarative. Vous pouvez livrer de nouveaux plugins en écrivant du YAML : pas de code d’interface Flutter ni recompilation pour expérimenter (vous pouvez aussi charger un fichier depuis le disque via Charger un fichier .gfpd… dans la feuille d’ajout de plugin).

Slots du rack : panneaux d’effets générés depuis des descripteurs avec potentiomètres — Les plugins descripteurs apparaissent comme des cartes rack normales — potentiomètres et faders générés depuis le bloc `ui:` de chaque fichier `.gfpd`.

Types de plugins

`type:`	Usage
`effect`	Effet insert / envoi stéréo ; `graph:` avec `audio_in` / `audio_out` et nœuds DSP.
`midi_fx` (ou `midifx`)	Processeur MIDI ; chaîne `midi_nodes:` (transpose, harmonize, arpeggiate, …).
`instrument` / `analyzer`	Réservé aux cas avancés GFPA — voir la doc API dans le dépôt.

Contenu du fichier

spec: "1.0", id unique (DNS inversé), name, version, type.
parameters: — contrôles automatisables avec des entiers paramId stables (ne jamais réutiliser des ID une fois publié).
Audio : graph: avec nodes et connections (Freeverb, delay, EQ, compresseur, chorus, wah, …).
MIDI : midi_nodes: avec type de nœud et params liés à { param: id } ou des constantes.
ui: — potentiomètres, faders, bascules, sélecteurs, vu-mètres ; groups: optionnel pour le responsive.

Guide d’auteur (dépôt)

La référence canonique est assets/plugins/HOW_TO_CREATE_A_PLUGIN.md (en anglais) — catalogue des nœuds, types de contrôles d’interface, recettes (wet/dry, wah synchro BPM) et checklist avant publication.

Télécharger les fichiers `.gfpd` fournis (branche `main`)

Fichier	Type
reverb.gfpd	Audio — réverb à plaque
delay.gfpd	Audio — delay ping-pong
wah.gfpd	Audio — auto-wah
eq.gfpd	Audio — EQ 4 bandes
compressor.gfpd	Audio — dynamique
chorus.gfpd	Audio — chorus / flanger
harmonizer.gfpd	MIDI FX
chord_expand.gfpd	MIDI FX
arpeggiator.gfpd	MIDI FX
transposer.gfpd	MIDI FX
velocity_curve.gfpd	MIDI FX
gate.gfpd	MIDI FX

← .gfdrum · Liste des fonctionnalités →

Plugins .gfpd