================================================================================
                               BOUCLE EN SCÈNE
                     Vos boucles, vos scènes, votre concert
================================================================================

Version 0.5 Bêta - Novembre 2026 - Guillaume (aka BeBeLiOuS) - Logiciel Gratuit

Boucle en Scène lance des boucles MIDI et audio en rythme, pour jouer sur
scène ou s'entraîner : une grille de pistes et de scènes, des boucles qui
partent ensemble au bon moment, un enregistrement au clavier, un éditeur de
notes et un synthétiseur intégré. Il se pilote à la souris, avec un contrôleur
MIDI (AKAI APC, Novation Launchpad…), le clavier de l'ordinateur ou une
application OSC. Pour Windows et Linux, gratuit.

Documentation utilisateur


SOMMAIRE
--------
  1. Présentation
  2. Installation et premier lancement
  3. La fenêtre en un coup d'œil
  4. Les notions : pistes, scènes, slots, boucles
  5. Jouer : lancer les boucles et les scènes
  6. Le tempo, la signature et le métronome
  7. Les pistes
  8. Les boucles
  9. L'éditeur de boucle (piano roll et forme d'onde)
 10. Le panneau Modèles
 11. Jouer en direct et enregistrer
 12. La quantification
 13. Les contrôleurs (MIDI, clavier de l'ordinateur, OSC)
 14. Le Mode Association
 15. Horloge MIDI (synchronisation)
 16. Projets, sauvegarde automatique et récupération
 17. La fenêtre Préférences
 18. Audio, latence et décrochages
 19. Raccourcis clavier
 20. Dossiers et fichiers
 21. Dépannage
 22. Limites connues
 23. Crédits


================================================================================
1. PRÉSENTATION
================================================================================

Boucle en Scène est un lanceur de boucles MIDI et audio pensé pour la scène :
une grille de pistes et de scènes où chaque case contient une boucle que l'on
lance, arrête et enchaîne en rythme.

Points forts :
  - Lancement quantifié des boucles et des scènes (au temps, à la mesure, aux
    2 ou 4 mesures) : tout reste en place, même si l'on appuie un peu tôt.
  - Boucles MIDI jouées par un synthétiseur intégré (SoundFont .sf2) ou
    envoyées à un synthé externe ; boucles audio WAV, MP3, OGG, FLAC qui suivent
    le tempo.
  - Enregistrement de boucles MIDI au clavier, overdub, quantification réglable.
  - Pilotage par contrôleur MIDI (AKAI APC, Novation Launchpad…), par le
    clavier de l'ordinateur ou par une application OSC (téléphone, tablette),
    grâce à des fichiers de configuration.
  - Panneau Modèles : vos dossiers de boucles, avec écoute et glisser-déposer.
  - Sauvegarde automatique et récupération après un plantage.
  - Windows et Linux. Gratuit.


================================================================================
2. INSTALLATION ET PREMIER LANCEMENT
================================================================================

Installation
  Décompressez l'archive de votre système (Windows ou Linux) où vous voulez,
  puis lancez l'exécutable BoucleEnScene (BoucleEnScene.exe sous Windows).
  Rien d'autre n'est à installer : le paquet contient tout ce qu'il faut.

  Windows : le logiciel n'est pas signé. Si Windows affiche « Windows a protégé
  votre ordinateur », cliquez Informations complémentaires › Exécuter quand
  même.
  Linux : rendez le fichier exécutable si besoin (chmod +x BoucleEnScene).

La SoundFont (sons du synthé intégré)
  Les boucles MIDI sont jouées par un synthétiseur qui utilise une « SoundFont »
  (fichier .sf2). Au démarrage, Boucle en Scène cherche une SoundFont General
  MIDI déjà présente (sous Linux : /usr/share/sounds/sf2/, paquet
  fluid-soundfont-gm). Sinon, téléchargez-en une gratuite (GeneralUser GS,
  FluidR3_GM…) et choisissez-la dans Affichage › Préférences › SoundFont, ou
  placez-la dans le dossier Musique/SoundFonts.

Premier lancement
  - Toutes les entrées MIDI présentes sont écoutées.
  - Le projet de démonstration pop-rock s'ouvre : un morceau en sol à 116 BPM,
    sur 8 pistes (batterie, basse, guitare, piano, orgue, cordes, chœurs, solo)
    et 7 scènes à lancer l'une après l'autre. Il se rouvre par Fichier ›
    Projets de démonstration. On y entend :
      - Intro, Couplet : l'orgue des deux scènes est un même clone ;
      - Pré-refrain : joué une fois (×1), il s'arrête sur une cymbale si le
        refrain n'est pas lancé pendant sa dernière mesure ;
      - Refrain : la mélodie en vibrato et en glissés, la dernière note des
        cordes qui se superpose au tour suivant ;
      - Pont : le solo (glissés, vibrato), l'orgue dont le vibrato s'accélère ;
      - Refrain final : les boucles du refrain, clonées et transposées d'un ton ;
      - Fin : jouée deux fois (×2), puis son Temps Final : des coups décalés,
        l'accord tenu sur la pédale, la basse qui plonge, la note du solo
        tenue depuis la boucle.
  - Trois autres morceaux sont dans Fichier › Projets de démonstration :
      - Funk-soul (mi dorien, 104 BPM) : basse slap, guitare grattée,
        Rhodes joué en avance sur le temps, cuivres qui tombent en glissé,
        Break joué deux fois puis tout le groupe sur le 1, Solo sur le groove
        cloné une quarte plus haut ;
      - Électro-house (la mineur, 124 BPM) : Montée jouée une fois avec un
        riser en glissé et modulation, Drop puis Drop 2 cloné trois demi-tons
        plus haut, Fin aux notes décalées sur une basse qui plonge ;
      - Jazz-bossa (do, 132 BPM) : Thème B cloné une quarte plus haut, solo
        de saxophone en glissés et vibrato, une Valse en 3/4 à 150 BPM et une
        Ballade à 72 BPM (le tempo et la mesure propres à une scène), Fin à
        l'accord joué en avance, tenu dans le Temps Final.


================================================================================
3. LA FENÊTRE EN UN COUP D'ŒIL
================================================================================

La fenêtre s'ouvre maximisée. Si vous la réduisez, sa taille dépend de votre
système : sous Linux, le bureau peut lui donner une taille plus petite.
F11, ou Affichage › Plein écran, la passe en plein écran : tout reste accessible,
et F11 revient à l'état d'avant. À droite des menus, deux icônes font de même :
plein écran (quatre coins) et Mode scène (un écran et un triangle, F12).

De haut en bas :

  Menus          Fichier, Pistes, MIDI, Affichage, Aide.
  Contrôles      Barre du haut (à masquer par Affichage › Barre de contrôles).
  Transport      Lecture/arrêt, Stop, enregistrement de session, position
                 (mesure.temps.double-croche), tempo, signature, métronome
                 (« Enreg. seul. » et son volume), quantification du
                 lancement, durée d'enregistrement, décompte, overdub.
  Quantification Réglages de quantification de l'enregistrement, octave du jeu
                 au clavier, Mode Association.
  Grille         Une colonne par piste, une ligne par scène ; à droite, toujours
                 visible, la piste Master (en-tête « Master Scènes ») : les
                 scènes, Tout arrêter, les boutons d'ajout, le volume général,
                 son vumètre, le panoramique général et le bouton « Réglages
                 des pistes ». Ctrl + molette sur la grille l'agrandit ou la
                 réduit (de 50 à 200 %), autour du pointeur ; aussi par
                 Affichage › Zoom de la grille, ou Ctrl et +, − ou 0 du pavé
                 numérique (0 : taille normale). Le Mode scène a sa propre
                 taille, qui remplit l'écran.
  Éditeur        En bas : la boucle sélectionnée (piano roll pour une boucle
                 MIDI, forme d'onde pour une boucle audio). Il prend la hauteur
                 que la grille laisse libre ; la séparation entre les deux se
                 déplace à la souris (Affichage › Éditeur de boucles pour
                 l'afficher ou le masquer).
  Modèles        À droite : vos dossiers de boucles (menu Affichage › Modèles
                 pour l'afficher ou le masquer). La barre à sa gauche, comme
                 celle au-dessus de l'éditeur, se tire pour l'élargir ou le
                 rétrécir.
  Barre d'état   En bas : messages, contrôleurs connectés, dernier message MIDI
                 reçu (moniteur MIDI).

L'éditeur et le panneau Modèles peuvent aussi avoir chacun leur propre fenêtre,
à placer où vous voulez, sur un autre écran par exemple :
  - En haut à droite de l'éditeur et des Modèles, deux petites icônes. La
    première (un carré d'où sort une flèche) détache le panneau dans sa
    fenêtre : l'éditeur s'ouvre de la taille de la fenêtre principale,
    par-dessus elle, prêt à partir sur un autre écran. Dans cette fenêtre, la
    même icône (la flèche y rentre) le rattache à sa place dans la fenêtre
    principale, comme la fermeture de la fenêtre. La croix ferme le panneau, là
    où il est : menu Affichage pour le rouvrir.
  - Dans sa fenêtre, deux icônes s'ajoutent devant : plein écran de cette
    fenêtre (F11 y fait de même, et la remet comme elle était ; dans la fenêtre
    principale, F11 reste pour elle) et Mode scène (F12).
  - Dans ces fenêtres, les raccourcis et les touches marchent comme dans la
    fenêtre principale (Espace, clavier de l'ordinateur, Ctrl+Z…) ; un fichier
    des Modèles se glisse jusqu'à un slot de la grille, dans la fenêtre
    principale ; le Mode association y choisit aussi les boutons.
  - Afficher ou masquer un panneau (menu Affichage) fait de même avec sa
    fenêtre ; le Mode scène les masque, et les rend à sa sortie.

L'espace de travail est enregistré avec le projet : où sont l'éditeur et les
Modèles, affichés ou non, dans la fenêtre principale ou dans leur fenêtre, la
place et la taille de ces fenêtres, la hauteur de l'éditeur, la largeur des
Modèles et le zoom de la grille. Le changer ne compte pas comme une
modification du projet ; il est enregistré à son prochain enregistrement. Une
fenêtre restée sur un écran absent revient près de la fenêtre principale. Un
nouveau projet, ou un projet de démonstration, garde l'espace de travail du
moment.

Le titre de la fenêtre montre le nom du projet ; un astérisque (*) devant le
nom signale des modifications non enregistrées.


================================================================================
4. LES NOTIONS : PISTES, SCÈNES, SLOTS, BOUCLES
================================================================================

  Piste   Une colonne. Une piste MIDI joue des boucles MIDI avec un instrument
          (synthé intégré ou synthé externe) ; une piste audio joue des
          fichiers audio. Une piste ne joue qu'une boucle à la fois.
  Scène   Une ligne. Lancer une scène lance toutes les boucles de la ligne (et
          arrête les pistes dont le slot de cette ligne est vide).
  Slot    Une case de la grille (une piste × une scène). Il est vide ou contient
          une boucle.
  Boucle  Ce que contient un slot : une suite de notes (boucle MIDI) ou un
          fichier son (boucle audio), répétée en continu tant qu'elle joue.

Un nouveau projet a 8 pistes MIDI et 5 scènes, comme les 8 × 5 pads d'un AKAI
APC Key 25 ; ajoutez-en autant que nécessaire.

État d'un slot (couleur et icône) :
  - vide : gris foncé ; « ○ » sur une piste armée (prêt à enregistrer) ;
  - boucle arrêtée : couleur atténuée, icône ▷ ;
  - boucle en attente de lancement ou d'arrêt : elle clignote ;
  - boucle qui joue : couleur vive, barre de progression en bas du slot ;
  - enregistrement : rouge.

État d'une scène, sur le même modèle : ▷ à l'arrêt, ▶ dès qu'une boucle de sa
ligne joue, et elle clignote quand une boucle de sa ligne attend de se lancer ou
de s'arrêter.


================================================================================
5. JOUER : LANCER LES BOUCLES ET LES SCÈNES
================================================================================

  - Bouton ▷ à gauche d'un slot : lance la boucle. Sur une piste armée, un slot
    vide lance un enregistrement ; sur une piste non armée, un slot vide arrête
    la piste.
  - Clic sur le nom de la boucle : la sélectionne (elle s'ouvre dans l'éditeur)
    sans la lancer.
  - Double-clic sur le nom de la boucle : ouvre l'éditeur, même fermé, à sa
    place dans la fenêtre principale ou dans sa propre fenêtre, ramenée devant
    (pas en Mode scène).
  - Bouton ▷ d'une scène (piste Master) : lance toute la ligne.
  - Clic sur le nom de la scène : la sélectionne sans la lancer ; la piste
    sélectionnée reste, et l'éditeur montre son slot dans cette scène.
  - Bouton ■ sous une piste : arrête cette piste.
  - Bouton « Tout arrêter » sous les scènes : arrête toutes les boucles (le
    transport continue).
  - Bouton Stop du transport : arrête tout et revient au début.

Préparer avant de jouer : transport arrêté, le bouton ▷ d'une boucle (ou d'une
scène, ou un pad de contrôleur) ne démarre rien. Il prépare la boucle, qui
clignote ; Play (le bouton ▶, Espace ou le Play d'un contrôleur) fait partir
ensemble, sur la mesure 1, toutes les boucles préparées.
  - Un second clic sur une boucle préparée la retire ; une autre boucle de la
    même piste prend sa place.
  - Une scène prépare toute sa ligne ; son tempo et sa signature s'appliquent
    au départ.
  - Sur une piste armée, ▷ d'un slot vide prépare un enregistrement (il
    clignote en rouge) : Play lance le décompte, puis l'enregistrement.
  - Le ■ d'une piste retire sa préparation ; Stop ou « Tout arrêter » les
    retirent toutes.
  - Le bouton ● d'enregistrement de session démarre tout de suite, sans attendre ;
    Espace, la souris au-dessus de l'éditeur, aussi : il fait écouter la
    boucle éditée (chapitre 9).
  - Avec une horloge MIDI externe, les boucles préparées partent quand
    l'horloge démarre.

Quantification du lancement (liste « Lancement » du transport) :
  Aucune, 1 temps, 1 mesure (par défaut), 2 mesures, 4 mesures. La boucle
  démarre (ou s'arrête) à la prochaine limite choisie : elle clignote en
  attendant.

Nombre de tours : le champ « Tours » de l'éditeur dit combien de fois une boucle
joue avant de s'arrêter seule ; vide (∞), elle joue sans fin. Chaque slot garde
le sien dans le projet, et l'affiche à droite du nom : ×4 à l'arrêt, 2/4 pendant
le jeu.
  - L'arrêt tombe à la fin du dernier tour, sans attendre la quantification, et
    le transport continue.
  - Lancer à nouveau la boucle reprend le compte à 1.
  - Un enregistrement n'est jamais coupé : la boucle s'arrête à la fin du tour
    où il se termine.

Temps Final (F) : une boucle MIDI peut finir sur un coup, un accord, ou toute
une fin, qui commence juste après son dernier temps, au même instant que le
temps 1 de la boucle suivante, et se joue par-dessus ce qui suit, sans
rallonger la boucle ni décaler ce qui suit. Ses notes partent chacune à leur
place, autant qu'on veut, sur au plus autant de mesures que la boucle. Il se
saisit dans la zone F de l'éditeur (chapitre 9).
  - Une boucle à nombre de tours joue F à la fin de son dernier tour : avec la
    boucle suivante si son lancement tombe à ce moment, seul sinon. F ne lance
    rien : la boucle suivante se lance à la main, sur la grille de lancement.
  - Toute boucle joue F à la fin d'un tour, quand un lancement ou un arrêt de
    piste (■, Tout arrêter) tombe à cet instant, y compris une scène dont la
    case est vide sur cette piste : ce tour devient son dernier.
  - F ne joue pas aux tours qui se répètent, ni sur un lancement ou un arrêt de
    piste au milieu d'un tour, ni sur l'arrêt du transport.
  - Une note de la boucle peut finir dans la zone F, au plus une longueur de
    boucle après la fin : aux tours qui se répètent, elle se superpose au début
    du tour suivant (la même note rejouée la coupe) ; quand la boucle se
    termine, elle se prolonge jusqu'à sa fin, comme une note de F.
  - Une note longue déborde sur ce qui suit sans rien décaler. Un F encore en
    cours s'arrête à la boucle lancée ensuite sur sa piste, à l'arrêt de la
    piste (■, Tout arrêter, sur la grille de lancement), à Échap ou à l'arrêt du
    transport.
  - Une même note jouée au même instant par F et par la boucle qui joue
    par-dessus ne donne qu'une frappe, à la vélocité la plus forte et pour la
    durée la plus longue.
  - La pédale de maintien de F agit sur toute la piste : si une boucle y joue en
    même temps, sa pédale s'ajoute à celle de F.

Nom, tempo et signature d'une scène : clic droit sur la scène › Modifier la
scène… Le tempo et la signature (vides par défaut) s'appliquent quand on lance
la scène. Ils durent jusqu'au lancement d'une scène qui n'en a pas, qui revient
au tempo ou à la signature du projet, ou jusqu'à l'arrêt. Les changer pendant
qu'ils s'appliquent les ajuste pour le jeu, sans toucher à ceux du projet (ceux
qui sont enregistrés).

Supprimer une scène : clic droit sur la scène › Supprimer la scène. Sa ligne de
boucles part avec elle : celles qui jouaient s'arrêtent, les autres continuent,
et Ctrl+Z rétablit le tout. Un projet garde toujours au moins une scène. Comme
les scènes sont désignées par leur position, celles qui suivent changent de
numéro, pour les contrôleurs et les associations aussi.

Couleur d'une scène : clic droit sur la scène › Modifier la scène, liste
Couleur. Le bouton prend cette couleur, atténuée à l'arrêt et vive quand la
scène joue. Une scène a toujours une couleur, grise par défaut. Elle est
gardée dans le projet.

Déplacer une scène : glissez les trois points (à droite de la scène) vers le
haut ou le bas ; ou clic droit sur la scène › Monter / Descendre. La
scène et sa ligne de boucles suivent la souris et les autres lignes s'écartent ;
Échap annule. Ce qui joue continue de jouer. Comme pour les pistes, les
contrôleurs désignent les scènes par leur position.

Mode scène (F12, ou Affichage › Mode scène)
  Pour jouer sur scène sans fausse manœuvre : la fenêtre passe en plein écran,
  la grille s'agrandit pour remplir l'écran, et un gros compteur
  mesure.temps.double-croche se lit de loin, avec le nom des scènes qui jouent,
  le tempo et la signature.
  - Les colonnes des pistes se partagent la largeur de l'écran, les rangées
    sa hauteur : moins il y a de pistes ou de scènes, plus les cases sont
    grandes. Avec beaucoup de pistes ou de scènes, les cases gardent une taille
    minimale et toute la grille est dessinée plus petite. Les commandes des
    pistes (■, Rec, M, S, volume, vumètre et panoramique) et celles de la piste
    Master (« Tout arrêter », volume général, vumètre et panoramique général)
    sont tout en bas de l'écran. Volume et panoramique s'y règlent à la souris
    comme d'habitude : leur valeur s'affiche au-dessus du rond, et Ctrl les
    fait aller de 5 en 5. Les boutons d'ajout restent masqués.
  - Les boucles et les scènes se lancent et s'arrêtent comme d'habitude (clic
    sur ▷, contrôleurs, clavier). Le bandeau du haut a ses propres boutons ▶ et
    ■, la barre de transport étant masquée : préparez les boucles à l'arrêt, puis
    ▶ les fait partir ensemble.
  - L'édition est verrouillée : ni glisser-déposer, ni menus (la barre de menus
    est masquée, le clic droit n'ouvre rien), ni double-clic pour créer une
    boucle. L'éditeur, les Modèles (même dans leur propre fenêtre) et les
    barres d'outils sont masqués, et les info-bulles ne s'ouvrent pas.
  - Raccourcis : Espace, Échap (panique), Ctrl+S (enregistrer) et les touches
    des fichiers contrôleurs restent actifs ; les autres (Ctrl+Z, Ctrl+N…)
    sont coupés jusqu'à la sortie du Mode scène.
  - F12, ou l'icône en haut à droite (près de « F12 : quitter le Mode
    scène »), revient à l'affichage d'avant, plein écran de travail compris. F12
    fonctionne même quand un champ texte a le focus, et ne peut pas servir dans
    un fichier contrôleur. F11 n'a pas d'effet en Mode scène.


================================================================================
6. LE TEMPO, LA SIGNATURE ET LE MÉTRONOME
================================================================================

Tempo (de 20 à 300 BPM)
  - Saisie : cliquez dans la case du tempo, tapez la valeur, Entrée.
  - Molette sur la case : ±1 BPM (Maj : ±0,1).
  - Glisser verticalement sur la case.
  - Boutons − et + : ±1 BPM ; /2 et x2 : moitié et double.
  - TAP : tapez au moins trois fois en rythme.
  - Un potentiomètre peut piloter le tempo (Mode Association ou fichier
    contrôleur).

Signature rythmique
  Liste « Mesure » : 2/4, 3/4, 4/4, 5/4, 6/4, 7/4, 3/8, 5/8, 6/8, 7/8, 9/8,
  11/8, 12/8, 15/16… ou case libre à côté (par exemple 13/16, puis Entrée).
  Un changement prend effet à la mesure suivante. Une scène peut avoir sa propre
  signature (chapitre 5) : la case Mesure montre alors la sienne. Le tempo
  compte toujours des noires : une mesure de 6/8 dure trois noires.

Métronome
  Bouton Métronome. Il bat chaque temps du dénominateur, plus fort sur le
  premier temps ; en 6/8, 9/8 et 12/8, il accentue les groupes de trois.
  - « Enreg. seul. » : il ne bat que pendant un enregistrement (nouvelle
    boucle ou overdub d'une piste armée), et pendant le décompte.
  - Le petit curseur à côté règle son volume (indépendant du volume général).
  - Pendant un décompte (chapitre 11), il bat toujours, même éteint.
  Ces réglages sont gardés dans le projet.


================================================================================
7. LES PISTES
================================================================================

Ajouter : menu Pistes › Ajouter une piste MIDI / audio, ou boutons +MIDI et
+AUDIO de la piste Master.

Sélectionner : clic sur l'en-tête de la piste. La scène sélectionnée reste, et
l'éditeur montre le slot de cette piste dans cette scène.

Renommer : clic droit sur l'en-tête de la piste › Renommer la piste…

Déplacer :
  - glissez les trois points (à droite de l'en-tête) vers la gauche ou la
    droite : la piste suit la souris et les autres s'écartent ; Échap annule ;
  - ou clic droit sur l'en-tête › Déplacer vers la gauche / la droite.
  La piste continue de jouer. Les contrôleurs (pads, boutons, associations)
  désignent les pistes par leur position : ils suivent l'ordre affiché.

Supprimer : clic droit sur l'en-tête › Supprimer la piste.

Commandes de la bande de piste (sous les slots) :
  ■        arrêter la piste
  ● Rec    armer la piste (pistes MIDI) : le clavier joue cette piste et un slot
           vide lancé enregistre une nouvelle boucle
  M        mute (coupe le son)
  S        solo (n'entend que les pistes en solo)
  Curseur  volume, puis vumètre, puis panoramique ; au survol ou pendant le
           réglage, la valeur s'affiche au-dessus du rond : volume en %,
           panoramique G 50 (à gauche), C (au centre), D 30 (à droite).
           Avec Ctrl, le curseur va de 5 en 5 (75 %, 80 %... ; G 25, G 20...),
           comme la vélocité. Le volume et le panoramique généraux et le volume
           du métronome font de même, tout comme la force et le swing de
           quantification et le gain des boucles audio. Quand un potentiomètre
           du contrôleur (ou l'OSC) bouge l'un de ces curseurs, sa valeur
           s'affiche aussi pendant un instant.
           Double-clic : un panoramique revient au centre, un volume de piste
           ou le volume général à 80 %.
  Vumètre  niveau de la piste après son volume, en décibels comme sur une
           table de mixage, sur 60 dB : il bouge encore avec un volume de
           quelques %. La barre est pleine à -12 dB, le niveau que le synthé
           intégré atteint à peu près à 100 % (-72 dB tout à gauche). Deux
           barres : en vert vif le niveau du moment (il monte aussitôt et
           redescend de 36 dB par seconde), derrière en vert foncé la
           crête récente, tenue 1,5 s puis redescendant de 12 dB par
           seconde. Celui du Master mesure la sortie, plein à -6 dB.
  Panoramique général (piste Master)
           balance de la sortie : au centre, le mixage ne change pas ; vers un
           côté, l'autre côté baisse jusqu'au silence. Le métronome n'est pas
           concerné, comme pour le volume général. Il est gardé dans le projet.
  Couleur  couleur de la piste et des nouvelles boucles. Les boucles
           existantes gardent leur couleur.

Le bouton « Réglages des pistes » de la piste Master, ou Affichage › Réglages
des pistes, masque ou affiche, sous chaque piste, Synthé externe, l'instrument,
Entrée, Canal et Couleur. Masqués, ils laissent plus de place à la grille : le
choix est gardé d'une session à l'autre.

Instrument d'une piste MIDI :
  - Synthé intégré (par défaut) : choisissez l'instrument de la SoundFont dans
    la liste, y compris les kits de batterie.
  - Synthé externe : cochez « Synthé externe », choisissez le port MIDI et le
    canal (1 à 16). Le programme de la piste est renvoyé au synthé quand il est
    rebranché. Les notes sont retardées de la latence audio pour rester calées
    sur le son (réglable dans les Préférences).
    Le volume et le panoramique de la piste lui sont envoyés sur son canal
    (CC 7 et CC 10), à chaque changement et quand il est rebranché. Muette, ou
    quand une autre piste est en solo, la piste lui envoie un volume 0 : ses
    notes et le jeu en direct se taisent. Le volume et le panoramique généraux
    ne le touchent pas, son son ne passant pas par le logiciel, et le vumètre
    de la piste reste vide.

Entrée d'une piste MIDI (ce qui la joue), listes « Entrée » et « Canal » :
  - Tous, Tous (par défaut) : la piste joue quand elle est armée ou
    sélectionnée, quel que soit le clavier (chapitre 11).
  - Un port (un clavier MIDI, ou le clavier de l'ordinateur), un canal ou les
    deux : tout ce qui vient de là joue cette piste, armée ou non, et ne joue
    plus la piste armée ou sélectionnée. Elle n'écoute plus que cela. Elle
    s'enregistre comme une autre : armez-la et lancez un slot vide.
  - Plusieurs pistes sur la même entrée jouent ensemble.
  - Les ports des pads d'un contrôleur ne sont pas proposés. Le réglage est
    gardé dans le projet ; une entrée débranchée reste choisie dans la liste,
    et la piste reprend dès qu'elle revient.

Menu MIDI › Panique (Échap) : coupe immédiatement toutes les notes (y compris
sur les synthés externes). Échap annule d'abord ce qui est en cours : en Mode
Association, l'élément choisi (chapitre 14) ; dans l'éditeur, les notes
sélectionnées (chapitre 9) ; dans la grille, un déplacement à la souris. Un
second Échap fait alors la panique.


================================================================================
8. LES BOUCLES
================================================================================

Créer une boucle MIDI vide : double-clic sur un slot vide d'une piste MIDI, qui
ouvre aussi l'éditeur, ou clic droit › Nouvelle boucle MIDI. Sa longueur est la
durée d'enregistrement choisie dans le transport (« Enreg. »).

Importer :
  - clic droit sur un slot › Importer un fichier .mid… (piste MIDI) ou
    Importer un fichier audio… (piste audio) ;
  - glisser un fichier depuis l'explorateur de fichiers du système sur un slot ;
  - glisser un fichier depuis le panneau Modèles (chapitre 10).
  Un fichier MIDI devient une boucle de mesures entières. Pour un fichier audio,
  le tempo d'origine est déduit du nom du fichier (par exemple « kick 120bpm »)
  ou de sa durée (nombre entier de mesures).

Déplacer, copier et cloner à la souris :
  - glissez les trois points (à droite d'un slot occupé) vers un autre slot : la
    boucle suit la souris et le slot visé s'encadre de blanc ;
  - maintenez Ctrl en relâchant pour la copier : l'original reste en place ;
  - maintenez Ctrl + Maj pour la cloner (le cadre passe au bleu) : voir Boucles
    clonées, plus bas ;
  - déposée sur une boucle existante, elle échange sa place avec elle : l'autre
    boucle apparaît déjà à la place d'origine ;
  - une copie ou un clone ne va que sur un slot vide : il ne remplace jamais une
    boucle (le cadre passe au rouge, videz d'abord le slot visé) ;
  - Échap annule le geste.
  Une boucle qui reste dans sa piste continue de jouer ; une boucle qui change de
  piste arrête la piste d'origine. Une boucle MIDI ne va que sur une piste MIDI,
  une boucle audio que sur une piste audio (là aussi, le cadre passe au rouge).

Autres actions (clic droit sur un slot) :
  Dupliquer (copie dans le premier slot libre en dessous, une scène est ajoutée
  si besoin), Cloner (de même, en clone), Détacher le clone, Supprimer,
  Exporter en .mid…, Retirer l'association.

Boucles clonées : un clone est la même boucle, MIDI ou audio, dans plusieurs
cases. Ce qui change dans l'une change dans toutes, d'un seul geste : notes,
pédale, Temps Final, nom, couleur, longueur, et pour l'audio le fichier, le
tempo d'origine, le Warp et le gain.
  - Chaque case garde son nombre de tours et, en MIDI, sa transposition : le
    même riff de basse en do ici et à +5 là, modifié une seule fois.
  - Un clone se reconnaît aux deux carrés liés à droite de son nom ; la
    transposition s'y affiche aussi (+5), avant le nombre de tours.
  - Clic droit › Détacher le clone : la case garde le contenu tel qu'il est et
    va désormais son propre chemin. Ce qui joue continue de jouer ; ce geste ne
    s'annule pas (Ctrl + Maj + glisser en refait un clone, de la boucle d'où on
    part).
  - Copier un clone (Ctrl + glisser, Dupliquer) donne une boucle indépendante ;
    supprimer un clone laisse les autres.
  - Le projet garde le contenu complet dans chaque case, avec une marque commune
    qui les relie à l'ouverture.

Annuler et rétablir (Ctrl+Z, Ctrl+Y ou Ctrl+Maj+Z, aussi dans le menu Pistes) :
  - Ctrl+Z annule la dernière modification, qu'elle ait été faite dans la grille
    ou dans l'éditeur de boucle : la plus récente des deux.
  - Dans la grille : boucle supprimée, déplacée, copiée, clonée, remplacée
    (import, glisser d'un fichier) ou enregistrée, piste ajoutée, supprimée ou
    déplacée, scène ajoutée, supprimée ou déplacée (jusqu'à 100 étapes, oubliées
    à l'ouverture d'un projet).
  - Pendant le jeu, une boucle qui revient dans sa piste continue de jouer ;
    une boucle qui quitte sa piste l'arrête, comme au glisser-déposer.
  - Le bouton « annuler » d'un contrôleur (mode Association) fait de même.

Exporter une scène : Fichier › Exporter la scène sélectionnée en .mid… (une
piste MIDI par boucle).


================================================================================
9. L'ÉDITEUR DE BOUCLE
================================================================================

Il montre la boucle sélectionnée. L'icône en haut à droite l'ouvre dans sa
propre fenêtre, dont le titre dit la scène et la piste, et la croix le ferme
(chapitre 3). En haut aussi : Annuler et Rétablir, nom, longueur
(en mesures ou en noires ; tapez puis Entrée), nombre de tours (chapitre 5),
transposition, couleur. Pour un clone, « Clone (3 cases) » suit le titre : ce
que vous changez ici change aussi dans les autres cases (chapitre 8).

  - Transpo (boucles MIDI, sauf sur une piste de batterie, où une note est un
    son) : de -24 à +24 demi-tons, pour cette case seulement ; ses clones gardent
    la leur. L'éditeur montre les notes telles qu'elles sont écrites ; le
    clavier fait entendre ce que la case joue, et une note jouée en direct
    s'allume là où elle s'écrira. Une note enregistrée dans une case transposée
    est écrite d'autant plus bas, pour rejouer telle que jouée. Une note poussée
    hors du clavier (au-delà de 0 à 127) n'est pas jouée. L'export .mid est
    transposé, sauf sur le canal 10.

  - Annuler (Ctrl+Z) défait la dernière modification de la boucle : notes
    ajoutées, déplacées, effacées, quantification, longueur, nombre de tours,
    transposition, nom, couleur, réglages audio. Rétablir (Ctrl+Y ou
    Ctrl+Maj+Z) la refait. Chaque boucle garde son propre historique (jusqu'à
    200 étapes) pendant la session ; des clones partagent le leur.

Boucle MIDI (piano roll)
  - À l'ouverture, une boucle trop longue pour la largeur est réduite pour y
    tenir ; une boucle courte garde le zoom normal. Ctrl + molette change le
    zoom, jusqu'à la boucle suivante.
  - Sur une piste de batterie (un kit du synthé intégré, ou un instrument externe
    sur le canal 10), le clavier de gauche nomme les sons General MIDI : Grosse
    caisse, Caisse claire, Charleston… Les touches et les cases suivent quand
    même les notes noires et blanches, ce qui guide quand on enregistre depuis
    un clavier ; la grille s'arrête aux sons nommés.
  - Case « Percussions utilisées » de la barre de l'éditeur (pistes de batterie,
    le choix est gardé) : le clavier et la grille se réduisent aux sons que la
    boucle utilise, Temps Final compris. Une ligne se ferme quand sa dernière
    note s'en va, et s'ouvre quand une note enregistrée ou collée l'utilise ;
    une boucle sans note montre tous les sons. Pour ajouter un autre son,
    décochez la case.
  - Règle au-dessus du piano roll, et la même sous les bandes : les mesures et
    les temps de la boucle (1, 1.2, 1.3…), puis ceux de la zone F (F, F.2,
    F.3…), alignés avec les notes et les bandes. Quand le zoom manque de
    place, seules les mesures sont écrites.
  - Clic dans une zone vide : ajoute une note (glisser pour sa longueur).
  - Glisser une note : la déplace ; sa position (mesure.temps.double-croche,
    comme le compteur) s'affiche au-dessus d'elle pendant le geste.
  - Glisser le bord droit d'une note : change sa longueur, affichée au-dessus
    de sa fin (1/8, 3/16 pour trois doubles-croches, 1/8 T pour une croche de
    triolet, 1 pour une ronde ; ≈ hors de la grille), comme pendant la
    création d'une note.
  - Glisser le bord gauche d'une note : déplace son début, sa fin restant en
    place ; la position du début s'affiche au-dessus d'elle pendant le geste. Une
    note trop courte à l'écran n'offre pas ce bord (zoomez), pour rester
    déplaçable.
  - Maj + glisser verticalement : change la vélocité d'une note (avec Ctrl
    en plus : de 5 en 5) ; sa valeur s'affiche pendant ce temps sur sa
    colonne de la bande Vélocité.
  - Bande « Vélocité » sous le piano roll : une colonne par note, aussi haute
    que sa vélocité (1 à 127) ; les notes d'un accord sont côte à côte, la
    plus grave à gauche. Tirer une colonne vers le haut ou le bas règle sa
    note seule ; glisser à travers la bande règle à la suite toutes les notes
    survolées, comme un pinceau (un crescendo se dessine d'un geste). Avec
    Ctrl, la vélocité va de 5 en 5. La valeur s'affiche au-dessus de la
    colonne survolée ou modifiée ; Ctrl+Z annule.
  - Bandes « Hauteur » et « Modulation », entre Vélocité et Maintien : la
    molette de hauteur et la molette de modulation, une courbe chacune. La
    hauteur se lit de -100 % à +100 % autour de sa ligne centrale (combien de
    demi-tons, c'est le synthé qui le dit : 2 pour le synthé intégré), la
    modulation de 0 à 127.
      Glisser                dessine la courbe, un point par pas de grille (en
                             grille Libre, un point tous les quelques pixels) ;
                             un trait rapide dessine une rampe
      Clic droit             remet la courbe à 0 (le centre pour la
                             hauteur) à cet endroit, jusqu'au point suivant ;
                             en glissant, sur tout le passage
      Ctrl                   de 5 en 5 (5 % pour la hauteur)
    La valeur s'affiche au-dessus du pointeur. Chaque tour repart du centre et
    de zéro, sauf avec un point sur son tout premier tick ; l'arrêt de la
    boucle les y ramène aussi. Une boucle sans courbe ne touche jamais à la roue
    ni à la molette que vous jouez. Ctrl+Z annule.
  - Cases « Vélocité », « Hauteur », « Modulation » et « Maintien » de la
    barre de l'éditeur : afficher ou masquer ces bandes (le choix est gardé).
    Les notes, les colonnes, les courbes et la pédale sont dans la couleur de
    la boucle. Le nom de chaque bande est à gauche, dans la colonne du clavier.
  - Les noms anglais, ceux des autres logiciels et des manuels des claviers :
      Vélocité               velocity
      Hauteur                pitch bend (la molette de hauteur)
      Modulation             modulation (la molette de modulation, CC 1)
      Maintien               sustain (la pédale de maintien, CC 64)
  - Zone F, plus sombre, après le dernier temps : le Temps Final (chapitre 5). On
    y pose, déplace et redimensionne les notes comme dans la boucle, n'importe
    où, sur sa propre grille qui part de son début ; une note ajoutée y fait une
    double-croche (1/16). Glisser une note la fait passer de la boucle à F, ou
    l'inverse ; une note de la boucle peut aussi finir dans la zone F
    (chapitre 5). Rien ne dépasse la fin de F.
    Vide, la zone fait un temps ; elle s'allonge jusqu'à ce qui va le plus loin :
    une note, la pédale ou une courbe de F, ou la fin d'une note de la boucle,
    sans dépasser la longueur de la boucle. Un clic juste après la zone y pose
    une note et l'allonge d'autant ; glisser une note vers la droite l'allonge
    aussi. Raccourcir la boucle masque ce qui dépasse de F, qui ne joue plus mais
    n'est pas perdu : il revient quand la boucle s'allonge. Les bandes Vélocité,
    Hauteur, Modulation et Maintien s'y prolongent, avec les mêmes gestes, et
    la pédale et les courbes peuvent bouger à tout moment de F. Les courbes de
    F passent avant celles de la boucle qui joue ; à la fin de F, celles de la
    boucle reprennent, sinon le centre et zéro. Ctrl+V, la souris sur la zone,
    y pose les notes copiées à partir de cet endroit : un accord ou une phrase
    de la boucle devient la fin.
    Quantifier et Dé-quantifier n'y touchent pas ; F est gardé dans le projet,
    dans les copies et les clones de la boucle (transposé avec chaque case),
    mais perdu à l'export .mid, qui n'a pas d'équivalent.
  - Clic droit ou double-clic sur une note : la supprime.
  - Sélection de plusieurs notes :
      Ctrl + glisser dans le vide  sélectionne les notes du rectangle tracé
      Ctrl + clic sur une note     l'ajoute à la sélection ou l'en retire
      Ctrl+A                       sélectionne toutes les notes
      Ctrl + clic dans le vide     désélectionne tout (Échap aussi)
    Les notes sélectionnées sont encadrées de blanc. Glisser l'une d'elles
    déplace toute la sélection (Ctrl + glisser : en déplace une copie) ;
    tirer le bord droit ou gauche de l'une change toutes les autres d'autant ;
    Maj + glisser change toutes leurs vélocités d'autant. Suppr ou un clic
    droit sur l'une les supprime.
  - Copier, couper, coller : Ctrl+C copie les notes sélectionnées, Ctrl+X
    les coupe, Ctrl+V les colle dans la boucle affichée, qui peut être une
    autre boucle. La souris sur le piano roll, la note la plus à gauche du
    presse-papiers (la plus grave d'un accord) tombe sous la souris, sur sa
    case de grille et sa hauteur ; les autres gardent leur écart avec elle,
    en temps comme en hauteur. Sinon, les notes reviennent à la même place,
    repliées dans une boucle plus courte, ou juste après les notes copiées si
    on recolle dans la même boucle. Les notes collées deviennent la
    sélection, prêtes à être déplacées. Collées par-dessus des notes déjà
    là, elles s'y ajoutent sans les toucher : déplacer ou supprimer le
    collage laisse les notes d'avant en place.
    Dans la bande Vélocité, seules les notes sélectionnées se modifient (les
    autres colonnes sont estompées). Chaque opération s'annule d'un Ctrl+Z,
    qui vide aussi la sélection. Un simple clic sur une note non sélectionnée
    la modifie seule.
  - Espace, le pointeur au-dessus de l'éditeur : lecture et arrêt de cette
    boucle. Seule, elle part et s'arrête aussitôt, et repart de son début ;
    parmi d'autres boucles, elle attend leur prochain lancement et les autres
    continuent. Ailleurs dans la fenêtre, Espace reste la lecture et l'arrêt
    général.
  - Notes jouées en direct : les touches que vous tenez sur le clavier MIDI
    (ou sur celui de l'ordinateur) s'allument sur ce clavier, dans la couleur
    de la boucle, quand elles jouent la piste de la boucle affichée.
  - Nom des notes : survoler une note ou une touche du clavier, ou déplacer,
    allonger ou créer une note, éclaire sa touche avec son nom (D#4 ; C4 est
    le do du milieu, la note 60).
  - Écouter : cliquer sur une touche du clavier ; en gardant le bouton appuyé,
    glisser de haut en bas fait entendre chaque note survolée.
  - Hauteur : l'éditeur prend toute la place que les scènes et les réglages
    laissent libre, sans descendre sous 300 px (au-delà, la grille défile). Dès
    qu'on déplace la barre au-dessus de lui, il garde cette hauteur, enregistrée
    avec l'espace de travail du projet (chapitre 3).
  - Défilement : la barre sous les bandes fait défiler les notes et ces bandes
    ensemble. Le piano roll reste toujours collé aux bandes, et la règle des
    mesures sur lui : moins hauts que la place qu'ils ont, ils laissent le vide
    au-dessus de la règle.
  - Ctrl + molette : zoom horizontal. Ctrl + Maj + molette : zoom vertical ; les
    touches, la grille, les noms de batterie et la hauteur des bandes Vélocité,
    Hauteur, Modulation et Maintien suivent, et il reste d'une boucle à l'autre
    jusqu'à la fermeture du logiciel. La molette zoome aussi au-dessus des
    bandes et des règles des mesures.
  - Grille : pas de l'aimantation des notes (1/4 à 1/32, triolets, ou Libre).
  - Quantifier : applique les réglages de quantification à toutes les notes.
  - Dé-quantifier : remet chaque note à la position jouée.
  - Doubler : double la longueur en recopiant les notes.
  - Effacer : supprime toutes les notes (avec la pédale de maintien et le Temps
    Final).

Boucle audio (forme d'onde)
  - Tempo d'origine : tempo du fichier ; la longueur de la boucle suit.
  - Warp coché : la boucle suit le tempo sans changer de hauteur
    (étirement temporel). Décoché (Repitch) : elle accélère ou ralentit comme
    un disque, la hauteur change avec la vitesse.
  - Gain : volume de la boucle (0 à 2, affiché de 0 à 200 % au-dessus du
    rond au survol ; avec Ctrl, de 5 en 5 %).


================================================================================
10. LE PANNEAU MODÈLES
================================================================================

Le panneau « Modèles », à droite, affiche vos dossiers de boucles et les
fichiers MIDI (.mid) et audio (.wav, .mp3, .ogg, .flac) qu'ils contiennent.
Il contient d'office le dossier « Modeles » (les boucles fournies, ajouté une
seule fois : si vous le retirez, il ne revient pas) et, au premier lancement,
votre dossier Musique.

  +        ajouter un dossier
  −        retirer des Modèles le dossier sélectionné (rien n'est effacé du
           disque)
  ⟳        relire les dossiers (après avoir ajouté des fichiers)

  Clic sur un fichier         le sélectionne (et l'écoute si Auto est actif)
  Double-clic sur un fichier  le charge dans le slot sélectionné
  Glisser un fichier          le dépose sur le slot visé, encadré pendant le
                              geste (en rouge si sa piste prend l'autre sorte
                              de fichier : MIDI ou audio) ; aussi depuis les
                              Modèles détachés, dans leur propre fenêtre

Boucles modèles : le dossier « Modeles » contient 209 boucles MIDI prêtes à
l'emploi, rangées par style :
  Batteries   99 rythmes en 11 styles : Rock, Pop, Funk-Soul, Electro,
              Hip-hop, Jazz-Blues, Latin, Reggae, Divers (valse, country,
              second line, marche, polka), Mesures speciales (6/8, 12/8,
              5/4, 7/8, 9/8) et Breaks et fills (fills, montée, fin,
              décompte)
  Basses      47 lignes en 7 styles : Rock-Pop, Funk-Soul, Jazz-Blues
              (walkings, boogie), Latin (tumbao, bossa, samba…), Reggae,
              Disco-Electro, Country
  Accords     63 grilles en 8 styles : Pop-Rock, Jazz, Blues, Classique,
              Mineur-Epique, Soul-Gospel, Reggae-Latin, Electro, chacune
              sur la rythmique de son style (rondes, croches, skank,
              Charleston, bossa, arpèges…)
Basses et accords sont surtout en do majeur ou en la mineur ; le nom donne la
grille en degrés quand il y en a une (I-V-vi-IV, ii-V-I…). Une fois chargée
dans un slot, une boucle joue au tempo du projet, avec l'instrument de la
piste. Une boucle en 3/4, 6/8, 12/8, 5/4, 7/8 ou 9/8 se joue dans un projet
ou une scène réglés sur la même mesure.

Le mini-lecteur, sous la liste, permet d'écouter un fichier avant de le
charger :
  ▶        écouter le fichier sélectionné
  ■        arrêter l'écoute
  Auto     écoute dès qu'on clique sur un fichier ; désactivé, l'écoute ne
           part qu'avec ▶
  ⟲        écoute en boucle (sinon une seule fois)
  Liste    instrument d'écoute des boucles MIDI (basse, piano, cordes…) ;
           une batterie (canal 10) garde le kit General MIDI, et la liste est
           grisée pour un fichier audio
Une boucle MIDI s'écoute au tempo du projet. Changer d'instrument ou activer
la boucle s'entend tout de suite, pendant l'écoute. Ces réglages sont
mémorisés.

L'écoute passe par la sortie principale et le volume Master. Masquer ou
afficher le panneau : menu Affichage › Modèles, ou sa croix. La barre à sa
gauche se tire pour l'élargir ; l'icône en haut à droite l'ouvre dans sa propre
fenêtre (chapitre 3).


================================================================================
11. JOUER EN DIRECT ET ENREGISTRER
================================================================================

Jouer
  Le clavier MIDI (ou celui de l'ordinateur) joue toujours la piste armée, ou la
  piste sélectionnée si aucune n'est armée, par-dessus les boucles, sans
  enregistrer.

  Plusieurs claviers : donnez à une piste son entrée (listes « Entrée » et
  « Canal » de la piste, chapitre 7), par exemple une batterie électronique
  sur la piste batterie. Ce clavier joue alors cette piste, armée ou non, et
  les autres continuent de jouer la piste armée ou sélectionnée.

  Clavier de l'ordinateur : la rangée du milieu (Q S D F G H J K L M en AZERTY)
  et la rangée du dessus jouent les notes comme un piano (c'est la position des
  touches qui compte, pas la lettre) ; W et X changent d'octave (aussi boutons
  Oct − / Oct +).

Enregistrer une nouvelle boucle
  1. Armez une piste MIDI (● Rec).
  2. Choisissez la durée dans « Enreg. » (1, 2, 4, 8 ou 16 mesures).
  3. Lancez un slot vide de cette piste (▷ ou pad du contrôleur).
  Décompte (liste « Décompte » du transport : Aucun, 1 ou 2 mesures) : quand
  l'enregistrement est lancé alors qu'aucune boucle ne joue (transport arrêté,
  ou qui tourne à vide après « Tout arrêter »), le métronome bat d'abord ces
  mesures, affichées -2 et -1 dans la position, puis l'enregistrement démarre
  à la mesure 1. Tout ce qui attend son lancement démarre avec lui. Quand une
  boucle joue, il n'y a pas de décompte : la musique sert de repère.
  L'enregistrement démarre à la prochaine limite de lancement (le slot clignote
  en rouge en attendant, puis devient rouge fixe), dure le nombre de mesures
  choisi, puis la boucle repart en lecture. Jouez quand le slot est rouge fixe :
  ce qui est joué pendant qu'il clignote n'est pas enregistré, sauf les notes
  jouées juste avant le départ, gardées sur le premier temps.
  Sur une piste de batterie (kit du synthé intégré, ou canal 10 d'un synthé
  externe), une frappe enregistrée dure au moins une double-croche (1/16),
  sans dépasser la frappe suivante du même son : les pads envoient des notes
  très brèves, ainsi visibles et faciles à prendre dans l'éditeur.
  La barre d'état annonce « Enregistrement sur … : jouez », puis « Boucle
  enregistrée : N note(s) ». Si elle signale un enregistrement sans aucune note,
  le clavier ne joue pas la piste armée : regardez le moniteur MIDI (en bas à
  droite), qui montre ce que le clavier envoie.

Overdub
  Bouton Overdub : les pistes armées ajoutent ce que vous jouez à la boucle qui
  joue.

Pédale de maintien (sustain)
  La pédale du clavier (CC 64) est enregistrée avec les notes, en nouvelle
  boucle comme en overdub, et rejouée avec la boucle, sur le synthé intégré
  comme sur un synthé externe. Une pédale déjà appuyée au départ de
  l'enregistrement compte sur le premier temps.
  - En overdub, la pédale s'ajoute comme les notes : elle est enfoncée là où
    l'une des prises l'enfonce, et un relâché ne coupe jamais la prise
    d'avant, ni à l'enregistrement ni au son.
  - Sous le piano roll, la bande « Maintien » montre en couleur où la boucle la
    tient enfoncée ; son étiquette s'allume tant que votre pied l'appuie.
  - Elle se modifie aussi à la souris, comme les notes : glisser dans le vide
    ajoute une plage (un clic seul : un pas de grille), glisser une plage la
    déplace, glisser un de ses bords l'allonge ou la raccourcit, double-clic
    ou clic droit la supprime. Les bords suivent la grille de l'éditeur ;
    pendant le geste, le début et la fin de la plage s'affichent dessus
    (1.1.3 – 1.3.2 : la pédale descend à la mesure 1, temps 1, 3e
    double-croche et remonte au temps 3). Ctrl+Z annule.
  - Chaque tour de boucle repart pédale relevée, et l'arrêt d'une boucle la
    relève : aucune note ne reste tenue.
  - Les fichiers .mid gardent la pédale, à l'export comme à l'import.
  - « Effacer » l'enlève avec les notes, « Doubler » la recopie.
  - Les boucles « Piano arpèges » et « Piano accords » du projet de
    démonstration pop-rock en ont, pour essayer.

Molettes de hauteur et de modulation (pitch bend et modulation)
  - La molette de hauteur et la molette de modulation du clavier s'enregistrent
    comme la pédale : en enregistrant une boucle, et en overdub sur une piste
    armée. Un mouvement s'écrit dans la boucle dès que la roue reste immobile
    un temps (ou à la fin du premier tour, ou à l'arrêt).
  - En overdub, ce que vous jouez remplace la courbe sur le passage joué, au
    lieu de s'y ajouter ; pendant le mouvement, la boucle ne touche pas à la
    roue que vous tenez.
  - Un mouvement qui passe la fin de la boucle reprend à son début là où il en
    était, puisque chaque tour repart du centre et de zéro.
  - Les courbes se voient et se dessinent dans les bandes « Hauteur » et
    « Modulation » (chapitre 9). Les fichiers .mid les gardent, à l'export
    comme à l'import.

Bouton d'enregistrement de session (●, dans le transport)
  Active l'overdub ; les pistes armées qui ne jouent rien commencent une
  nouvelle boucle dans la scène sélectionnée (ou le premier slot libre en
  dessous). Un second appui arrête l'overdub.


================================================================================
12. LA QUANTIFICATION
================================================================================

« Quantifier » (barre d'outils) : les notes enregistrées sont recalées sur la
grille.
  Grille   1/4, 1/8, 1/16, 1/32, 1/8 T et 1/16 T (triolets).
  Force    0 à 100 % : de combien les notes se rapprochent de la grille.
  Swing    retarde une note sur deux (100 % = sensation de triolet).
           Au survol ou pendant le réglage, la valeur de la force et du swing
           s'affiche au-dessus du rond ; avec Ctrl, elle va de 5 en 5.
  Fins     quantifie aussi la fin des notes.

La quantification ne détruit rien : la position jouée est conservée et
« Dé-quantifier » (éditeur) la rétablit. Le bouton « Quantifier » de l'éditeur
applique les réglages actuels à une boucle déjà enregistrée.


================================================================================
13. LES CONTRÔLEURS (MIDI, CLAVIER DE L'ORDINATEUR, OSC)
================================================================================

Chaque contrôleur est décrit par un fichier .json : un appareil MIDI (grille de
pads avec retour lumineux, boutons, potentiomètres), des raccourcis du clavier
de l'ordinateur ou des adresses OSC. Plusieurs contrôleurs fonctionnent en même
temps, chacun avec sa propre « fenêtre » sur la grille.

Presets fournis
  - AKAI APC Key 25 MK2, AKAI APC mini MK2,
  - Novation Launchpad Mini MK3, Novation Launchpad X,
  - Clavier de l'ordinateur (raccourcis, chapitre 19),
  - OSC (exemple), désactivé par défaut.
  Choix du contrôleur : Affichage › Préférences › Contrôleur MIDI. Avec
  « Automatique » (par défaut), le fichier de l'appareil branché est utilisé
  tout seul ; on peut aussi choisir un contrôleur précis, ou « Aucun ». La
  fenêtre dit s'il est branché et affiche sa description.

AKAI APC Key 25 MK2 (exemple)
  40 pads (8 × 5)            lancer la boucle ; slot vide d'une piste armée =
                             enregistrer ; sinon arrêt de la piste
  Shift + pad                sélectionner le slot
  Boutons de scène (droite)  lancer la scène
  Shift + bouton de scène    mode des boutons du bas : Clip Stop (arrêt de la
                             boucle), Solo, Mute, Rec Arm, Select
  Boutons du bas             selon le mode
  Shift + flèches (boutons   déplacer la fenêtre 8 × 5 d'une piste ou d'une
  du bas 1-4)                scène (haut, bas, gauche, droite) : seulement si
                             le projet a plus de 8 pistes ou de 5 scènes
  Shift + Volume / Pan /     pages des potentiomètres : volume des pistes,
  Send / Device (boutons     panoramique des pistes, Send = tempo, Master,
  du bas 5-8)                force et swing de quantification, Device = CC
                             vers l'instrument de la piste jouée (armée, ou
                             sélectionnée) : réverbération, chorus,
                             modulation, expression (aussi sur le synthé
                             intégré), puis brillance, résonance, attaque,
                             relâchement (synthés externes) ; la valeur
                             s'affiche dans la barre d'état
  Potentiomètres             5 crans pour 1 unité : 1 % de volume, 1 sur 100
                             de chaque côté pour le panoramique, 1 BPM, 1 pour
                             un CC. La valeur tombe toujours sur un nombre
                             rond
  En bas de la fenêtre, à côté du nom du contrôleur : les pistes et scènes que
  touchent ses pads (« pistes 1–8, scènes 1–5 ») et la page de ses
  potentiomètres, mises à jour dès qu'elles changent. Une association faite
  sur un potentiomètre (Mode Association) passe avant les pages : ce
  potentiomètre garde son action quelle que soit la page.
  Play / Rec                 lecture-arrêt / enregistrement (Shift + Rec :
                             métronome)
  Stop All Clips             arrêter toutes les boucles (Shift : transport)
  Clavier 25 touches         joue la piste armée ou sélectionnée

Faire écrire le fichier par une IA
  Le fichier GUIDE-IA.md, dans le dossier de vos contrôleurs (Préférences ›
  « Dossier de mes contrôleurs »), est écrit pour un assistant IA : tout le
  format, toutes les actions, les erreurs possibles et des exemples complets.
  Joignez-le à la conversation, donnez le modèle exact de votre appareil et
  votre système, puis posez le fichier obtenu dans ce dossier et cliquez sur
  « Recharger les fichiers ». S'il reste une erreur en rouge dans les
  Préférences, ou un numéro à relever dans le moniteur MIDI, redonnez-les à
  l'IA : elle corrige le fichier.

Modifier un fichier, ou créer le vôtre
  Préférences › « Modifier son fichier JSON… » ouvre le fichier du contrôleur
  choisi dans votre éditeur de texte. Pour un preset fourni, c'est une copie
  dans le dossier de vos contrôleurs, qui remplace le preset (le fichier
  d'origine, à côté du programme, n'est jamais modifié). Après une
  modification : « Recharger les fichiers ». Les erreurs (fichier, champ,
  valeur attendue) s'affichent en rouge dans les Préférences.
  Tant qu'une copie remplace un preset, les Préférences le signalent et proposent
  « Revenir au preset… » : le preset livré s'applique de nouveau, avec ses mises
  à jour, et votre copie reste dans le sous-dossier « sauvegarde » de vos
  contrôleurs. Les associations sont dans le projet : elles ne bougent pas. Si
  votre copie portait un autre nom, celles faites sous ce nom attendent ; MIDI ›
  Associations du projet, « Rattacher à… », les rend au preset.
  « Dossier de mes contrôleurs » ouvre ce dossier : il contient un modèle
  commenté et le guide complet du format (LISEZMOI.md).
  Pour changer l'action d'un pad ou d'une touche, inutile d'éditer le
  fichier : le Mode Association (chapitre 14) le fait, dans le projet.
  Le moniteur MIDI (barre d'état, en bas à droite) montre chaque message reçu :
  c'est le plus simple pour trouver les numéros de notes et de CC de votre
  matériel.

Ports MIDI
  Les ports du contrôleur sont ceux que désigne son fichier ("match") : rien à
  choisir à la main. Tous les autres claviers MIDI branchés sont écoutés
  automatiquement (sauf les ports « Through ») : ils jouent la piste armée ou
  sélectionnée. Sous Windows, un port déjà ouvert par un autre logiciel ne peut
  pas l'être une seconde fois.

Branchement à chaud
  Un appareil débranché puis rebranché est reconnecté en une seconde environ :
  ses ports sont rouverts, un contrôleur reçoit à nouveau son initialisation et
  ses LEDs, un synthé externe son programme. Sous Linux, même un câble
  débranché et rebranché aussitôt est remarqué ; sous Windows, il faut
  qu'il soit resté débranché au moins une seconde. La barre d'état annonce
  « MIDI branché / débranché ».

OSC (application de contrôle sur téléphone, tablette ou ordinateur)
  Affichage › Préférences, section OSC, sans fichier à écrire :
    1. Cochez « Recevoir l'OSC ».
    2. Écouter : « Cet ordinateur seulement », ou « Le réseau » pour un téléphone
       ou une tablette. Les Préférences affichent l'adresse et le port à indiquer
       dans l'application. Cliquez « Appliquer ».
    3. Sur le réseau, seuls cet ordinateur et les appareils autorisés sont
       écoutés. Touchez un bouton dans l'application : la barre d'état signale le
       refus, et l'appareil apparaît dans les Préférences. Cliquez « Autoriser »,
       puis « Appliquer ». On peut aussi écrire son adresse (192.168.1.20) ou une
       plage (192.168.1.0/24).
    4. Donnez une action à chaque contrôle avec le Mode Association (chapitre
       14). Ces associations sont enregistrées dans le projet, sous le nom
       « OSC ».
  ATTENTION : OSC n'a ni mot de passe ni chiffrement, et une adresse peut être
  usurpée. En concert, préférez un réseau à vous (routeur de poche, partage de
  connexion).

  Un fichier contrôleur reste utile pour des adresses fixes ou plusieurs ports
  (un fichier nommé « OSC » remplace celui des Préférences). Sa section "osc"
  règle :
    "port"   port UDP d'écoute (8000 par défaut) ;
    "bind"   adresse d'écoute : "127.0.0.1" (par défaut) = applications de cet
             ordinateur seulement ; "0.0.0.0" = tous les réseaux (téléphone,
             tablette) ;
    "allow"  expéditeurs acceptés : adresses ("192.168.1.20") ou plages
             ("192.168.1.0/24") ; vide = tout le monde.
  Exemple fourni : adresses /bes/scene/1 à 8, /bes/stop/1 à 8,
  /bes/volume/1 à 8, /bes/play, /bes/stopall, /bes/record, /bes/tempo,
  /bes/tap. Pour l'activer : copiez osc-exemple.json (dossier
  Controllers à côté du programme) dans le dossier de vos contrôleurs, mettez
  "enabled": true et l'adresse de votre appareil dans "allow", puis
  « Recharger les fichiers ».
  Les adresses de votre propre application n'ont pas besoin d'être écrites :
  un fichier avec seulement "name" et "osc" écoute déjà, et le Mode
  Association (chapitre 14) y ajoute les adresses touchées. Exemple :
    { "name": "Mon téléphone",
      "osc": { "port": 8000, "bind": "0.0.0.0", "allow": ["192.168.1.20"] } }
  ATTENTION : dans un fichier, avec "bind": "0.0.0.0" et sans "allow", n'importe
  qui sur le même réseau (Wi-Fi d'une salle…) peut piloter la session. La barre
  d'état signale les messages refusés et leur expéditeur.


================================================================================
14. LE MODE ASSOCIATION
================================================================================

Tout ce qui se clique ou se règle à l'écran peut être associé à un pad, un
bouton ou un potentiomètre MIDI, à une touche du clavier de l'ordinateur, ou
à un bouton ou un fader d'une application OSC, sans écrire de fichier :
boucles, scènes, lecture, stop, enregistrement, tempo (+, −, /2, x2, TAP),
métronome, overdub, quantification (case, force, swing, fins), octave, volume
et panoramique généraux, et pour chaque piste :
arrêt, armement, mute, solo, volume, panoramique, sélection (en-tête) ; « Tout
arrêter », +MIDI, +AUDIO, +SCÈNE ; les boutons de l'éditeur
(Annuler, Rétablir, Quantifier, Dé-quantifier, Doubler, Effacer).

  1. Activez le Mode Association : bouton « Association » de la barre de
     contrôles, menu MIDI › Mode Association, ou Ctrl+M. Le pointeur devient
     une main au-dessus de tout ce qui peut être associé.
  2. Cliquez l'élément : il s'encadre en violet (le clic ne le déclenche pas).
  3. Appuyez sur le pad, le bouton ou la touche du clavier — ou tournez le
     potentiomètre pour un curseur (volume, panoramique, tempo, force, swing,
     volume général : ceux-là demandent un potentiomètre ou un fader, MIDI ou
     OSC). Dans une application OSC, touchez le bouton ou bougez le fader.
     La barre d'état confirme l'association.
  4. Recommencez avec d'autres éléments, puis désactivez le mode pour jouer.

  Tant que le mode est actif, chaque élément associé porte une étiquette
  violette dans son coin, qui dit avec quoi : N36 (note 36), CC48 (contrôle 48),
  CC7 c2 (sur le canal 2), F7 (touche du clavier), /1/fader3 (adresse OSC). Elle
  montre vos associations, pas ce que fait déjà le preset du contrôleur.

  Échap         annule la sélection de l'élément
  Suppr         retire les associations de l'élément sélectionné
  Clic droit sur une boucle ou une scène › Retirer l'association

Les associations appartiennent au projet
  Une association est enregistrée avec le projet, comme tout le reste (Ctrl+S).
  Chaque projet a donc les siennes, et les emporte sur un autre ordinateur.
  L'astérisque (*) du titre signale qu'il y a du nouveau à enregistrer.

  Elle fonctionne tout de suite, et désigne son appareil par le nom de son
  contrôleur : celui de l'APC pour un pad de l'APC, « Clavier de l'ordinateur »
  pour une touche, celui de l'OSC pour une adresse OSC. Un appareil sans fichier
  contrôleur (un clavier MIDI quelconque), ou dont le contrôleur n'est pas celui
  choisi dans les Préférences, est désigné par le nom de son port. Aucun fichier
  contrôleur n'est modifié. Si l'appareil n'est pas là, ses associations
  attendent son retour. Les pistes et les scènes sont désignées par leur
  position (« mute de la piste 3 » reste la 3e piste si vous les réordonnez).

  Une association passe avant le preset : un pad de l'APC associé à la main
  fait ce que vous avez choisi, et non ce que dit son preset ; il garde son
  action avec Shift et sa LED (un pad de la grille s'allume en blanc quand
  l'action est active : piste muette, métronome en marche…). Associer à
  nouveau la même action la déplace ; associer à nouveau le même pad remplace
  son action. Les potentiomètres sans fin (qui envoient des pas, comme ceux de
  l'APC Key 25 MK2) sont reconnus automatiquement.

  Pour retirer une association : Suppr en Mode Association, clic droit ›
  Retirer l'association, ou la liste ci-dessous, puis enregistrez le projet.

La liste des associations
  MIDI › Associations du projet… montre toutes les associations de ce projet,
  par appareil, avec ce que fait chaque élément. Un changement s'applique tout
  de suite et s'enregistre avec le projet (Ctrl+S).

  Retirer       retire cette ligne.
  Rattacher à…  donne toutes les associations de l'appareil à un autre, avec les
                mêmes numéros de notes et de CC : un port qui a changé de nom sur
                un autre ordinateur, ou un appareil équivalent. Si l'appareil
                choisi faisait déjà autre chose de ces éléments, ou avait déjà ces
                actions sur d'autres éléments, cela est remplacé (la question
                posée avant de rattacher le dit).

  En orange : un appareil absent ou désactivé, dont les associations attendent
  le retour, et « Même action », quand un autre élément déclenche aussi cette
  action. Ce que fait le fichier d'un contrôleur n'est pas dans cette liste.

Les associations par défaut
  Un nouveau projet part des associations par défaut.

  MIDI › Enregistrer comme associations par défaut
      les associations de ce projet deviennent celles des nouveaux projets.
  MIDI › Reprendre les associations par défaut
      elles remplacent celles de ce projet.

  Les autres projets déjà enregistrés gardent les leurs.

Avec une application OSC
  Il suffit d'activer l'OSC dans les Préférences (chapitre 13), ou d'un fichier
  contrôleur avec une section "osc", sans aucune adresse. En Mode Association, le
  premier message reçu d'un appareil autorisé donne son adresse
  (/1/fader3, /1/push5…) à l'élément choisi ; inutile de la chercher dans
  l'éditeur de l'application. Les messages /ping et /accxyz (accéléromètre)
  que certaines applications envoient d'elles-mêmes sont ignorés ; coupez les
  autres envois automatiques de l'application pendant les associations. Un
  bouton OSC envoie 1 à l'appui et 0 au relâchement, un fader une valeur de 0
  à 1.


================================================================================
15. HORLOGE MIDI (SYNCHRONISATION)
================================================================================

Dans Affichage › Préférences › Horloge MIDI :
  - Tempo : « Interne » (par défaut), Boucle en Scène donne le tempo ; ou
    « Suivre l'horloge de … » une entrée MIDI (esclave). Le tempo est alors
    mesuré ; Start, Stop, Continue et Song Position sont suivis ; la position
    est recalée en cas de dérive. Le bouton lecture n'agit plus : c'est
    l'horloge externe qui commande.
  - Envoyer l'horloge à : une sortie MIDI qui reçoit Start/Stop/Clock (maître) ;
    l'appareil qui y est branché suit le tempo de Boucle en Scène.
  - Décalage MIDI (ms) : les sorties MIDI sont déjà retardées de la
    latence audio ; ajustez si un synthé externe est en avance (valeur
    positive) ou en retard (valeur négative).


================================================================================
16. PROJETS, SAUVEGARDE AUTOMATIQUE ET RÉCUPÉRATION
================================================================================

Fichier › Nouveau projet (Ctrl+N), Projets de démonstration, Ouvrir… (Ctrl+O),
Enregistrer (Ctrl+S), Enregistrer sous… (Ctrl+Maj+S), Fermer (Ctrl+Q).

  - Les projets ont l'extension .bes. Les chemins des fichiers audio y sont
    enregistrés relativement au projet : gardez vos sons dans un dossier proche
    du projet pour le déplacer facilement.
  - Un astérisque (*) devant le nom du projet, dans le titre de la fenêtre,
    signale des modifications non enregistrées.
  - Le projet garde aussi l'espace de travail : où sont l'éditeur et les
    Modèles, leurs fenêtres, leurs tailles et le zoom de la grille (chapitre
    3).
  - Nouveau, Ouvrir et la fermeture (Fermer ou la croix de la fenêtre)
    proposent d'enregistrer : Enregistrer, Ne pas enregistrer, Annuler. Les
    associations font partie du projet (chapitre 14).
  - Sauvegarde automatique : tant qu'il y a des modifications non enregistrées,
    une copie du projet est faite au plus toutes les 30 secondes. Si le logiciel
    se ferme mal (plantage, coupure de courant), il propose au démarrage suivant
    de récupérer le projet tel qu'il était. Un projet récupéré garde son nom de
    fichier : enregistrez-le pour garder les modifications.
  - Un projet endommagé ou modifié à la main est réparé à l'ouverture ; la barre
    d'état dit ce qui a été corrigé et le projet apparaît modifié : enregistrez
    pour réparer le fichier. Un fichier de plus de 64 Mo, de plus de 256 pistes
    ou de plus de 1024 scènes est refusé.


================================================================================
17. LA FENÊTRE PRÉFÉRENCES (Affichage › Préférences…, Ctrl+L)
================================================================================

Une seule fenêtre, quatre blocs.

Contrôleur MIDI
  - Liste des contrôleurs (fichiers JSON) : « Automatique (selon l'appareil
    branché) », « Aucun », ou un contrôleur précis. Dessous : s'il est branché
    (et sur quels ports) et sa description.
  - « Modifier son fichier JSON… », « Dossier de mes contrôleurs »,
    « Recharger les fichiers », « Revenir au preset… » : voir chapitre 13.
  - Tous les claviers MIDI branchés sont écoutés, sans rien cocher.

OSC
  Recevoir l'OSC, écouter cet ordinateur ou le réseau, port, appareils autorisés :
  voir chapitre 13.

Audio
  - Description de la sortie (pilote, fréquence, réserve) et latence estimée.
  - Réserve audio en échantillons (512 à 2048 ; 768 par défaut, environ 16 ms) :
    quantité de son calculée d'avance (voir chapitre 18). Prise en compte au
    prochain démarrage.
  - SoundFont du synthé intégré (.sf2) : Parcourir… pour en choisir une.

Horloge MIDI
  Tempo interne ou suivi d'une entrée, sortie de l'horloge, décalage MIDI :
  voir chapitre 15.

« Appliquer » enregistre et applique les réglages ; « Annuler » les abandonne.


================================================================================
18. AUDIO, LATENCE ET DÉCROCHAGES
================================================================================

Boucle en Scène calcule le son un peu en avance : c'est la « réserve audio ».
Elle permet de ne jamais interrompre le son quand l'ordinateur ou le logiciel
marque une courte pause. Plus elle est grande, plus le son est sûr, mais plus
la latence (délai entre une touche jouée et le son) augmente.

  - Si le son manque malgré tout (« décrochage », entendu comme un petit
    accroc dans le rythme), la barre d'état l'annonce et la réserve grandit
    automatiquement pour la suite de la session. Les sorties MIDI externes sont
    décalées d'autant pour rester calées.
  - Linux avec PulseAudio : la réserve règle aussi la quantité de son confiée
    d'avance à PulseAudio (environ 11 ms avec 768). Trop peu, et un ordinateur
    occupé fait grésiller le son par moments, sans que le logiciel puisse le
    voir ni l'annoncer : augmentez alors la réserve.
  - Si une source produit des valeurs audio invalides, elle est remplacée par du
    silence (sans couper les autres pistes) et la barre d'état indique la piste
    en cause.
  - Juste après l'ouverture d'un projet ou d'une SoundFont, le logiciel fait le
    ménage dans sa mémoire pendant que rien ne joue, pour ne pas le faire en
    pleine musique.


================================================================================
19. RACCOURCIS CLAVIER
================================================================================

Généraux
  Espace                 lecture / arrêt ; au-dessus de l'éditeur d'une boucle
                         MIDI : lecture / arrêt de cette boucle
  Ctrl+N                 nouveau projet
  Ctrl+O                 ouvrir
  Ctrl+S                 enregistrer
  Ctrl+Maj+S             enregistrer sous
  Ctrl+Q                 fermer le logiciel
  Ctrl+L                 préférences
  Ctrl+M                 Mode Association (activer / désactiver)
  Ctrl+Z / Ctrl+Y        annuler / rétablir (grille ou éditeur de boucle)
  Ctrl+A                 éditeur : sélectionner toutes les notes
  Ctrl+C / X / V         éditeur : copier / couper / coller des notes
  Suppr                  éditeur : supprimer les notes sélectionnées
  Échap                  panique (couper toutes les notes) ; d'abord,
                         annule la sélection de notes ou d'association, ou un
                         déplacement à la souris
  F1                     aide-mémoire des raccourcis
  F11                    plein écran de la fenêtre de travail, ou de la
                         fenêtre détachée où vous êtes
  F12                    Mode scène (plein écran, édition verrouillée)
  Ctrl + molette         éditeur : zoom horizontal ; grille : zoom
  Ctrl + Maj + molette   éditeur : zoom vertical
  Ctrl + + / − / 0       zoom de la grille (pavé numérique ; 0 : normal)
  Ctrl + curseur         volume, panoramique, force, swing, gain : de 5 en 5
  Q S D F G H J K L M    notes (rangée du milieu, AZERTY) ; rangée du dessus =
                         dièses
  W / X                  octave − / +

Preset « Clavier de l'ordinateur » (modifiable dans son fichier contrôleur)
  Arrêt défil            lancer la scène 1
  F2 à F8                lancer les scènes 2 à 8 (si elles existent)
  F9                     arrêter toutes les boucles
  F10                    métronome
  Fin                    tap tempo
  Début                  enregistrement
  Page préc. / Page suiv. scène sélectionnée précédente / suivante
  Inser                  lancer le slot sélectionné
  + / − du pavé numérique tempo +1 / −1
  Pause                  lecture / arrêt

Les raccourcis ne fonctionnent pas quand un champ texte a le focus (Entrée ou un
clic ailleurs dans la fenêtre pour en sortir), sauf F1, F11 et F12.


================================================================================
20. DOSSIERS ET FICHIERS
================================================================================

Dossier de données de Boucle en Scène :
  Linux    ~/.config/BoucleEnScene/
  Windows  %APPDATA%\BoucleEnScene\

Il contient :
  settings.json          réglages de l'ordinateur (contrôleur choisi, horloge
                         MIDI, SoundFont, dossiers des Modèles…)
  controllers/           vos fichiers contrôleurs, le modèle et les guides
                         LISEZMOI.md et GUIDE-IA.md
  associations-par-defaut.json
                         ce dont partent les nouveaux projets (chapitre 14)
  autosave/              la sauvegarde automatique (vide après une fermeture
                         normale)
  boucle-en-scene.log    journal des erreurs inattendues (à joindre à un
                         signalement de problème)
  boucle-en-scene.lock   empêche d'ouvrir Boucle en Scène deux fois

À côté de l'exécutable :
  Controllers/           presets fournis
  Loops/Modeles/         boucles modèles fournies (dossier « Modeles » du
                         panneau Modèles)
  LISEZMOI.txt           ce document (aussi menu Aide ›
                         Documentation)
  Images/icon.ico        l'icône du logiciel (pour un raccourci, par exemple)


================================================================================
21. DÉPANNAGE
================================================================================

Pas de son
  - Vérifiez le volume Master et celui des pistes, et qu'aucune piste n'est en
    solo par erreur.
  - Les boucles MIDI muettes : pas de SoundFont chargée (message dans la barre
    d'état) ; choisissez un fichier .sf2 dans les Préférences.
  - La barre d'état et Préférences › Audio indiquent la sortie audio utilisée.

Le rythme accroche par moments, ou le son grésille
  La réserve audio grandit d'elle-même après un décrochage. Si cela se répète,
  ou si le son grésille sans message dans la barre d'état (Linux, PulseAudio),
  augmentez la réserve dans les Préférences (1024 ou plus) et redémarrez.
  Fermez les logiciels lourds qui tournent en même temps.

Un contrôleur n'est pas reconnu
  - Préférences › Contrôleur MIDI : choisissez-le dans la liste. S'il reste
    « non branché », aucun port ne correspond au "match" de son fichier :
    « Modifier son fichier JSON… » et corrigez le nom du port (le moniteur MIDI
    montre les noms des ports qui envoient).
  - Regardez le moniteur MIDI (en bas à droite) en touchant un pad : si rien
    n'arrive, le port n'est pas écouté ou le câble est en cause.
  - Les numéros des presets suivent la documentation des fabricants ; corrigez
    le fichier si votre matériel envoie d'autres messages (par exemple
    "encoding": "relative" si les potentiomètres sautent).

Toutes les notes jouées au clavier sonnent aussi fort
  Le logiciel garde la vélocité de chaque note jouée, l'enregistre et la
  rejoue ; le synthé intégré y est sensible (une note jouée doucement sonne
  bien plus bas). Regardez le moniteur MIDI (en bas à droite) en jouant
  doucement puis fort : si « vel » reste le même, c'est le clavier qui
  envoie une vélocité fixe (réglage de l'appareil, ou clavier sans
  vélocité). Le clavier de l'ordinateur joue toujours à 100.

Une association faite sur un autre ordinateur ne fonctionne pas
  Un appareil sans fichier contrôleur est reconnu par le nom exact de son port,
  qui change d'un système à l'autre (Linux, Windows). Refaites l'association en
  Mode Association, ou donnez un fichier contrôleur à l'appareil : un contrôleur
  se reconnaît par son nom, sur tous les systèmes.

Une application OSC ne répond pas
  La barre d'état affiche « messages de … refusés » : autorisez l'appareil dans
  Préférences › OSC ou, si l'OSC vient d'un fichier contrôleur, ajoutez l'adresse
  indiquée dans "allow" et vérifiez "bind" (chapitre 13). Vérifiez aussi l'adresse
  et le port réglés dans l'application : les Préférences les affichent.
  Si rien n'est signalé, le message n'arrive pas : les deux appareils doivent être
  sur le même réseau, et le pare-feu de l'ordinateur doit laisser passer ce port
  UDP.

Un appareil MIDI USB débranché ne revient qu'au redémarrage (Linux)
  C'est un défaut du noyau Ubuntu 5.15.0-198 (Ubuntu 22.04, Linux Mint 21), pas
  de Boucle en Scène : un appareil USB qui a envoyé des messages MIDI ne peut
  plus être retiré proprement, et son débranchement bloque l'USB jusqu'au
  redémarrage, quel que soit le logiciel ouvert. La commande uname -r donne le
  noyau utilisé. Démarrez sur un noyau plus récent, installé par les mises à
  jour du système : le défaut est corrigé à partir du 5.15.0-202.

Le logiciel s'est fermé brutalement
  Au redémarrage, acceptez la récupération du projet. Le fichier
  boucle-en-scene.log du dossier de données décrit l'erreur.


================================================================================
22. LIMITES CONNUES (VERSION 0.5)
================================================================================

  - Testé surtout sous Linux (ALSA, PulseAudio/PipeWire) ; la version Windows a
    été moins essayée. Pas de version macOS pour l'instant.
  - Linux, noyau Ubuntu 5.15.0-198 : un appareil MIDI USB débranché ne revient
    qu'au redémarrage, à cause du noyau (chapitre 21).
  - Pas d'enregistrement audio (micro), pas d'effets ni de plugins
    d'instruments.
  - OSC : réception seulement (pas de retour d'état vers l'application).
  - Seuls les notes, la pédale de maintien et les molettes de hauteur et de
    modulation sont enregistrés (pas les autres CC).
  - Le mode Warp traite le fichier entier comme la boucle ; l'étirement d'un
    long fichier prend quelques secondes.
  - L'annulation de la grille ne reprend pas les réglages des pistes (nom,
    volume, instrument...) ni les notes ajoutées par l'overdub.


================================================================================
23. CRÉDITS
================================================================================

Boucle en Scène - Vos boucles, vos scènes, votre concert
Version 0.5 Bêta - Novembre 2026 - Guillaume (aka BeBeLiOuS) - Logiciel Gratuit

Réalisé en C# / .NET 10 avec Avalonia UI. Bibliothèques utilisées : MeltySynth
(synthé SoundFont), DryWetMidi (MIDI sous Windows, fichiers MIDI),
SDL3 (sortie audio), NVorbis, NLayer (décodage OGG et MP3), SoundTouch
(étirement temporel), CommunityToolkit.Mvvm.
