+ :::bash
+ pyinstaller music_sampler.spec
+
+## Téléchargements
+
+- Un exemple de configuration ainsi que des musiques associées à l'exemple
+ peuvent être trouvées sur
+ [owncloud](https://outils.immae.eu/owncloud/index.php/s/kSrIe15G1AiZ9YF)
+- Une version précompilée de `music_sampler` peut également être téléchargée
+ [dans le même
+ dossier](https://outils.immae.eu/owncloud/index.php/s/kSrIe15G1AiZ9YF/download?path=%2F&files=music_sampler)
+ (attention, elle n'est pas toujours forcément à jour, lancer le programme avec
+ `-V` pour voir la version compilée)
+
+## Utilisation
+
+Tout le travail consiste à préparer les transitions dans le fichier de
+configuration `config.yml`.
+
+Lancer ensuite le programme dans le dossier où se situe le fichier de
+configuration (voir plus bas pour une utilisation avancée). Une fenêtre
+représentant un clavier apparaît. Le rond orange dans le coin du clavier devient
+vert lorsque tout est chargé, ou rouge en cas de problème. Une touche grisée et
+barrée représente une touche non-utilisable pour le moment : soit parce que la
+musique est en cours de chargement (au lancement du programme, cela peut prendre
+un peu de temps sur certaines machines), soit parce qu'il y a une action en
+cours.
+
+Un exemple de fichier de configuration est fourni, avec un certain nombre de
+touches et de transitions programmées (pour les trois musiques fournies), la
+syntaxe du fichier (expliquée plus bas) se comprend aisément en le regardant. De
+plus, certaines touches (par exemple 'ÉCHAP' pour tout arrêter) peuvent être
+gardées d'une fois sur l'autre.
+
+### Actions possibles
+
+ - Cliquer sur une touche : affiche les actions associées à cette touche (dans
+ le cadre en bas à gauche).
+ - Appuyer sur une touche : déclenche les actions associées à cette touche
+ (affichées également dans le cadre en bas à gauche). Lorsqu'une touche a des
+ actions en cours, son cadre est noir. Notez qu'une action de type "jouer une
+ musique" est considérée comme terminée quand ladite musique est lancée. En
+ cas d'appui répété sur une touche, music_sampler ne relance pas les actions
+ associées à cette touche si ces actions ne sont pas terminées ; cela pour
+ éviter les "accidents".
+ - Ctrl+C ou Ctrl+Q : quitte le programme (possible aussi en cliquant
+ simplement sur la croix en haut à droite).
+ - Ctrl+R : recharge le fichier de configuration.
+
+### Options disponibles au lancement
+
+Toutes les options au lancement sont facultatives ; la plupart du temps lancer
+le programme dans le bon dossier suffit. La plupart d'entre elles peuvent être
+définies également dans le fichier de config (à part `--config` bien sûr). Les
+arguments en ligne de commande ont toujours la priorité.
+
+ * `-h, --help` : affiche une liste des options disponibles.
+ * `-c CONFIG, --config CONFIG` : précise le fichier de configuration à charger
+ (par défaut, config.yml qui se trouve dans le dossier où est lancé
+ music_sampler).
+ * `-p MUSIC_PATH, --music-path MUSIC_PATH` : précise le chemin des musiques
+ (par défaut, le dossier courant).
+ * `--no-debug, --debug` : Affiche les informations de déboggage (désactivé par
+ défaut)
+ * `-V, --version` : affiche la version courante et quitte (utilisable
+ uniquement pour la version compilée).
+ * `-L, --language` : change la langue de l'application. Actuellement: fr, en
+ (par défaut 'fr')
+ * `--focus-warning, --no-focus-warning`: Afficher / Ne pas afficher
+ d'avertissement lorsque l'application perd le focus (activé par défaut).
+
+Les options suivantes sont plutôt réservées à un usage avancé de music_sampler,
+ou en cas de problème avec la configuration standard :
+
+ * `--no-builtin-mixing, --builtin-mixing` Effectue en interne le mixage des
+ sons. Par défaut, music_sampler confie le mixage au système : n'activer
+ cette option que si le système n'y parvient pas.
+ * `-l LATENCY, --latency LATENCY` : latence. Préciser "low", "high" ou un
+ nombre de secondes (par défaut, "high")
+ * `-b BLOCKSIZE, --blocksize BLOCKSIZE` : taille des blocs. Nombre de frames
+ pour chaque étape du mixeur. 0 (par défaut) signifie que le programme
+ choisit lui-même le nombre qui lui convient.
+ * `-f FRAME_RATE, --frame-rate FRAME_RATE` : fréquence d'échantillonnage pour
+ jouer les musiques. Par défaut : 44100
+ * `-x CHANNELS, --channels CHANNELS` : nombre de canaux par musique (2 par
+ défaut, pour une écoute stéréo)
+ * `-s SAMPLE_WIDTH, --sample-width SAMPLE_WIDTH` : largeur d'échantillonnage
+ (nombre d'octets pour chaque frame). Par défaut : 2.
+ * `--device DEVICE` : sélectionne le périphérique de son.
+ * `--list-devices` : Affiche la liste des périphériques de son disponibles.
+ * `--load-all-musics` : Charger toutes les musiques au démarrage (défaut: True)
+ * `-- ARGS` : Arguments à passer à la librairie Kivy.