Chordlab V2.0 - initial

This commit is contained in:
lrdlg
2026-07-16 14:37:03 +02:00
commit 5d227c8ac9
7 changed files with 2728 additions and 0 deletions
+236
View File
@@ -0,0 +1,236 @@
# _chordlab v2 — Tutoriel complet d'utilisation
Ce guide couvre l'intégralité de l'application, du premier accord jusqu'aux workflows dawless et DAW. Comptez 10 minutes pour tout lire, 2 minutes pour être opérationnel.
---
## 1. Vue d'ensemble de l'interface
L'écran est organisé comme une face avant de machine hardware :
```
┌─────────────────────────────────────────────────────┐
│ LCD — nom de l'accord, notes, état des modes │
├──────────────┬──────────────────────┬───────────────┤
│ CHORD TYPE │ ROOT │ VOICING │
│ TENSIONS │ (clavier 1 oct.) │ drop/slash │
│ ALTÉRATIONS │ │ BASS / KEY │
├──────────────┴──────────────────────┴───────────────┤
│ PROGRESSION — slots, transport, perf, BPM │
├──────────────────┬──────────────────┬───────────────┤
│ MIDI OUT LIVE │ EXPORT MIDI │ SESSION │
└──────────────────┴──────────────────┴───────────────┘
```
Le **LCD** est votre référence permanente : il affiche le nom de l'accord courant, ses notes réelles (avec octaves), et l'état des modes (voicing, drop, key, perf, MIDI, voice-leading).
---
## 2. Jouer un accord
Le principe fondamental, hérité de l'Orchid : **vous ne jouez jamais les notes de l'accord, vous le décrivez**.
1. **Type** — un seul actif à la fois (LED allumée). MAJ est sélectionné au démarrage.
2. **Fondamentale** — cliquez une touche du clavier, ou utilisez le clavier PC : `A W S E D F T G Y H U J` = C C# D D# E F F# G G# A A# B.
3. L'accord sonne immédiatement et s'affiche sur le LCD.
Les huit types :
| Bouton | Accord | Intervalles |
|---|---|---|
| DIM | diminué | 1 · ♭3 · ♭5 |
| MIN | mineur | 1 · ♭3 · 5 |
| MAJ | majeur | 1 · 3 · 5 |
| AUG | augmenté | 1 · 3 · ♯5 |
| SUS2 | suspendu 2 | 1 · 2 · 5 |
| SUS4 | suspendu 4 | 1 · 4 · 5 |
| 5 | power chord | 1 · 5 |
| m♭6 | mineur sixte bémol | 1 · ♭3 · ♭6 |
---
## 3. Tensions et altérations
Les deux rangées inférieures s'**empilent** librement sur le type (plusieurs LEDs actives simultanément).
**Tensions** — elles *ajoutent* des notes :
| Bouton | Ajoute | Exemple avec MAJ + C |
|---|---|---|
| 6 | sixte majeure | C6 |
| m7 | septième mineure | C7 |
| M7 | septième majeure | Cmaj7 |
| 9 | neuvième | Cadd9 (ou C7(9) si une 7e est là) |
| ♭9 / ♯9 | neuvièmes altérées | C7(♭9), C7(♯9) « Hendrix » |
| 11 / ♯11 | onzièmes | C7(11), Cmaj7(♯11) |
| 13 | treizième | C7(13) |
**Altérations** — elles *modifient ou retirent* des notes :
| Bouton | Effet |
|---|---|
| ♭5 | remplace la quinte juste par une quinte diminuée |
| ♯5 | remplace la quinte juste par une quinte augmentée |
| no3 | retire la tierce (accords ouverts, parfaits pour l'ambient) |
**Combinaisons remarquables** :
- `DIM + 6` → accord de **septième diminuée** (Cdim7)
- `DIM + m7`**demi-diminué** (Cø7)
- `MIN + m7 + 9` → le m9 des nappes deep
- `m7 + M7` ensemble → le LCD affiche `WTF?`. Vous êtes prévenu.
---
## 4. Le voicing
C'est le cœur expressif de la machine. Trois outils indépendants qui se cumulent :
### 4.1 Le knob rotatif (±8)
Chaque cran fait une **rotation** de l'accord : à +1, la note la plus grave remonte d'une octave ; à 1, la plus aiguë descend. Exemple sur Cmaj7 :
```
0 : C4 E4 G4 B4
+1 : E4 G4 B4 C5
+2 : G4 B4 C5 E5
1 : B3 C4 E4 G4
```
Manipulation : glisser verticalement sur le knob, boutons /0/+, flèches ←/→ du clavier, ou double-clic pour revenir à 0. Le même accord à +3 et à 2 raconte deux histoires complètement différentes — c'est l'outil n°1 pour trouver *la* couleur.
### 4.2 Drop voicings
Appliqués après la rotation, ils écartent les voix comme le ferait un pianiste ou un arrangeur :
| Mode | Effet | Usage typique |
|---|---|---|
| close | rien (position serrée) | défaut |
| drop 2 | 2e voix depuis le haut → 1 octave | le voicing jazz standard |
| drop 3 | 3e voix depuis le haut → 1 octave | grands écarts, guitare |
| drop 2+4 | deux voix descendues | très ouvert, cinématique |
| spread | une voix sur deux → +1 octave | nappes larges, ambient |
### 4.3 Accords slash
Le sélecteur **basse /** choisit quelle note de l'accord la basse joue : fondamentale, tierce, quinte ou septième. Le LCD affiche alors `C/E`, `C/G`… La détection est intelligente : sur un accord mineur elle prend la tierce mineure, sur un ♭5 la quinte diminuée.
### 4.4 BASS
Le bouton **BASS** active le moteur basse (1 ou 2 octaves). En MIDI live et à l'export, la basse sort sur son propre canal — c'est elle qui pilote ta TD-3 pendant que les accords vont au Pro-800.
---
## 5. Key Mode — accords diatoniques à un doigt
Activez **KEY**, choisissez une tonique et une gamme parmi les huit disponibles. À partir de là :
- Chaque touche du clavier génère automatiquement **l'accord diatonique du degré correspondant** (en Do majeur : C→C, D→Dm, E→Em, F→F, G→G, A→Am, B→Bdim).
- Les touches hors tonalité sont **grisées** et n'émettent rien (le LCD affiche `hors tonalité`).
- Les tensions 6/7/9/11/13 restent actives et sont harmonisées **dans la gamme** (la 7e de G en Do majeur sera F naturel → G7, pas Gmaj7). Un astérisque dans le nom (`G7*`) signale un accord harmonisé diatoniquement.
Le mineur harmonique vaut le détour : le degré V y devient un vrai accord de dominante avec sensible — la cadence mineure classique à un doigt.
---
## 6. Construire une progression
### 6.1 Manuellement
Jouez un accord, puis **ADD** (ou barre espace). Il apparaît dans un slot avec son nom, ses notes et sa durée.
Sur chaque slot :
- **badge durée** (`4♩`) — cliquer fait tourner 4 → 8 → 2 → 1 temps
- ** ** — déplacer le slot dans la séquence
- **×** — supprimer
- **clic sur le slot** — l'auditionner seul
### 6.2 Avec les presets
Le menu déroulant propose huit cadences classiques (IVviIV, iiVI, cycle des quintes…). **Charger** les génère dans la tonalité et la gamme sélectionnées, avec vos tensions et votre voicing courants. C'est le moyen le plus rapide d'avoir une base à triturer.
### 6.3 Avec la suggestion harmonique
**✦ suggérer** ajoute un accord choisi par une table d'harmonie fonctionnelle (après un I : IV, V, vi… ; après un ii : V ; etc.), dans la tonalité courante. Enchaînez les clics pour laisser la machine dériver, reprenez la main quand ça devient intéressant.
### 6.4 Voice-leading
Deux outils pour des enchaînements fluides :
- **VL AUTO** (transport) — chaque accord ajouté est automatiquement re-voicé pour minimiser le mouvement des voix par rapport au précédent.
- **⇄ voice-leading** — optimise d'un coup toute la progression existante. À utiliser après un chargement de preset : la différence s'entend immédiatement.
---
## 7. Lecture et modes de performance
**PLAY** lance la progression au BPM affiché ; **LOOP** la fait boucler ; le slot en cours s'illumine.
Le sélecteur **perf** transforme la restitution de chaque accord :
| Mode | Rendu |
|---|---|
| block | accord plaqué |
| strum ↑ / ↓ | notes égrenées vers le haut / le bas (façon guitare) |
| harp | balayage rapide (glissando) |
| arp ↑ / ↓ / ↕ / rnd | arpège à la vitesse du sélecteur **rate** (1/8, 1/16, 1/32) |
**HUM** humanise vélocités (±10) et timing (±15 ms) — utile pour que les strums et arps respirent.
> Ces modes s'appliquent partout : à l'audition, en MIDI live, et **dans l'export .mid** (désactivable, voir §9).
---
## 8. MIDI live vers le hardware
1. Branchez votre interface USB-MIDI **avant** d'ouvrir la page (ou rechargez-la après).
2. Le navigateur demande l'autorisation d'accès MIDI — acceptez.
3. Panneau **MIDI out (live)** : sélectionnez le périphérique.
4. Vérifiez les canaux : **accords ch3** (Pro-800), **basse ch5** (TD-3/K-2) par défaut — adaptez à votre routage.
5. Jouez : chaque accord cliqué, chaque slot auditionné et la lecture complète partent en MIDI, avec les modes de performance rendus.
Le LCD affiche `MIDI ON` quand un périphérique est actif. En cas de note bloquée sur une machine, **STOP** envoie un All Notes Off sur les 16 canaux.
> Contexte sécurisé requis : Web MIDI ne fonctionne qu'en `https://` ou sur `localhost`. C'est la raison principale d'héberger l'app (voir le tutoriel Coolify).
---
## 9. Export .mid
Panneau **Export MIDI** :
- **pistes** : `accords + basse` (2 pistes, chacune sur son canal) ou `accords seuls`
- **perf rendue** : `oui` écrit les strums/arps note par note dans le fichier ; `non` exporte des accords plaqués (préférable si vous voulez arpéger dans le DAW ou le Tracker)
Le fichier généré (`chordlab_Cm7-Fm7-Ab-Bb_112bpm.mid`, format 1, PPQ 480, tempo inclus) respecte la durée individuelle de chaque slot.
**Destinations typiques** :
- **DAW** — glisser-déposer sur une piste instrument, c'est tout.
- **Polyend Tracker Mini** — copier le `.mid` sur la carte SD et l'importer ; chaque piste MIDI devient une piste du pattern.
---
## 10. Sessions
**↓ sauver la session** génère un `.json` contenant tous les réglages (type, tensions, voicing, drop, slash, tonalité, perf, BPM…) et la progression complète. **↑ charger une session** restaure tout.
L'application ne stocke rien dans le navigateur : le fichier `.json` est l'unique persistance. Versionnez vos sessions dans Gitea comme n'importe quel fichier de projet.
---
## 11. Raccourcis clavier
| Touche | Action |
|---|---|
| A W S E D F T G Y H U J | fondamentales C → B |
| Espace | ADD (ajouter l'accord courant à la progression) |
| ← / → | voicing 1 / +1 |
| ↑ ↓ ← → (knob focalisé) | voicing fin |
| double-clic sur le knob | voicing = 0 |
---
## 12. Deux workflows de référence
### Workflow dawless (session hardware)
1. KEY ON, tonique et gamme du morceau.
2. Preset ou ✦ suggérer pour poser 48 accords ; ⇄ voice-leading.
3. MIDI live branché : accords ch3 → Pro-800 (nappe lente), basse ch5 → TD-3.
4. LOOP + perf `block`, BPM du morceau : la progression tourne pendant que vous sculptez les sons sur les machines et enregistrez sur le L-12.
5. Session sauvée en `.json` pour reprendre la structure plus tard.
### Workflow DAW / Tracker (composition)
1. Construction libre (KEY OFF) : types + tensions + drop voicings pour chercher des couleurs.
2. VL AUTO activé, on empile au fil de l'inspiration.
3. Export `.mid` avec `perf rendue : non` (accords propres) → import dans le DAW ou le Tracker Mini.
4. L'arpégiation et le sound design se font dans la machine de destination.