+ :::yaml
+ aliases:
+ music1:
+ file: "path/to/my/favourite/music.mp3"
+
+ keys:
+ 'a':
+ play:
+ include: music1
+
+`music1` est désormais un alias pour `"path/to/my/favourite/music.mp3"`. À chaque fois qu'on veut écrire `file: "path/to/my/favourite/music.mp3"`, on peut écrire à la place `include: music1`. Attention, dans la section "music_properties", les alias ne fonctionnent pas, et il faut écrire le nom du fichier complet.
+
+ :::yaml
+ aliases:
+ blue:
+ color: [0, 0, 255]
+
+ keys_properties:
+ 'a':
+ description:
+ -
+ - blue key
+ include: blue
+
+`blue` est un alias pour la couleur `[0, 0, 255]`. À chaque fois qu'on veut écrire `color: [0, 0, 255]`, on peut écrire `include: blue` à la place.
+
+ :::yaml
+ aliases:
+ long_time:
+ duration: 42
+
+ keys:
+ 'b':
+ wait:
+ include: long_time
+ play:
+ file: "music1.mp3"
+
+`long_time` est un alias pour la durée 42 secondes. Au lieu d'écrire `duration: 42`, on peut écrire `include: long_time`.
+
+## Problèmes possibles
+
+Sont listés ci-dessous une liste de problèmes rencontrés, avec des solutions proposées. Si vous en découvrez d'autre, contactez l'auteur pour les ajouter à la liste.
+
+* Le programme se lance et s'arrête tout de suite.
+
+Il s'agit généralement d'une erreur de syntaxe dans le fichier de config. Dans ce cas, le terminal doit afficher quelques détails sur l'erreur en question (au moins la ligne correspondante).
+
+* La musique "grésille" affreusement.
+
+Il peut s'agir d'un problème de latence (avec certains ordinateurs un peu lents). Essayez de changer la latence (par exemple, 0.1 seconde)
+
+* Impossible de jouer plus d'une musique à la fois.
+
+Le système n'arrive pas à mixer les musiques par lui-même. Vous pouvez essayer de regarder la liste des périphériques de son (`--list-devices`) puis en sélectionner un autre si disponible. Vous pouvez aussi essayer le mixeur intégré à music_sampler, mais les résultats ne sont pas toujours très fluides (ne pas hésiter à jouer avec les paramètres avancés comme latency et blocksize).
+
+Si votre système utilise PulseAudio, il peut s'agir d'un problème de configuration du plugin ALSA. Dans ce cas, essayez de mettre la configuration suivante dans `/etc/asound.conf`, puis redémarrer la machine (solution empirique qui semble avoir fonctionné, sans garantie !):
+
+ pcm.!default {
+ type pulse
+ fallback "sysdefault"
+ hint {
+ show on
+ description "Default ALSA Output (currently PulseAudio Sound Server)"
+ }
+ }
+
+ ctl.!default {
+ type pulse
+ fallback "sysdefault"
+ }
+
+* La console affiche une erreur :
+
+ Exception in thread Thread-1:
+ Traceback (most recent call last):
+ File "threading.py", line 914, in _bootstrap_inner
+ File "threading.py", line 862, in run
+ File "kivy/input/providers/mtdev.py", line 219, in _thread_run
+ File "kivy/lib/mtdev.py", line 131, in __init__
+ PermissionError: [Errno 13] Permission denied: '/dev/input/event6'
+
+C'est une erreur de permission d'accès à un périphérique, généré par la librairie kivy. Elle peut être ignorée et n'aura pas d'incidence.
+
+* Pour d'autres problèmes ou bugs à reporter, voir le [Bug Tracker](https://git.immae.eu/mantisbt/view_all_bug_page.php?project_id=1&sort=status%2Clast_updated&dir=ASC%2CDESC)
+## Divers
+
+Les extraits de musiques proposés en exemples proviennent de [Jamendo](https://jamendo.com). Les musiques (complètes) sont disponibles en libre téléchargement pour un usage non commercial :
+
+[Short Blues](https://www.jamendo.com/track/340173/short-blues)
+
+[To the Fantasy war](https://www.jamendo.com/track/778560/to-the-fantasy-war)
+
+Le bruit de crocodile provient de [Universal-Soundbank](http://www.universal-soundbank.com/).
+
+Cet outil a été développé à l'origine pour faciliter la gestion du son pour les spectacles de la compagnie circassienne [Les pieds jaloux](http://piedsjaloux.fr/). N'ayant pas d'ingénieur son, les artistes eux-mêmes peuvent alors gérer leur musique lorsqu'ils ne sont pas sur scène : d'où la nécessité de préparer les transitions à l'avance et, au moment de la représentation, de réduire l'interaction avec la machine au minimum (une touche).