]> git.immae.eu Git - perso/Immae/Projets/Python/MusicSampler.git/blame_incremental - documentation_fr.md
Add load_all_musics flag and corresponding actions
[perso/Immae/Projets/Python/MusicSampler.git] / documentation_fr.md
... / ...
CommitLineData
1[TOC]
2
3# Music Sampler
4
5## Description
6
7Music Sampler est un lecteur de musique qui permet de pré-programmer des
8transitions musicales, qui peuvent ensuite être lancées à l'aide d'un simple
9appui sur une touche.
10
11## Pré-requis et installation
12
13- Il faut avoir ffmpeg d'installé. Pour cela, il faut installer le paquet `libav-tools` (debian) :
14
15 sudo apt-get install libav-tools
16
17Si vous utilisez la version compilée de Music Sampler (cf. plus bas pour un lien
18de téléchargement), il n'y a rien d'autre à installer.
19
20- Pour utiliser les sources directement, les modules suivants sont requis:
21
22| module | version minimale | commentaire |
23| ----------- | ---------------- | ----------------------------------------------------------------------------- |
24| Cython | 0.24 | pour compiler Kivy |
25| Kivy | 1.9.1 | certaines fonctionnalités nécessitent de compiler/installer avec `USE_SDL2=1` |
26| Markdown | 2.6.6 | pour la documentation uniquement |
27| pydub | 0.16.4 | |
28| Pygame | 1.9.2.dev1 | utilisée par Kivy |
29| Pygments | 2.1.3 | pour la documentation uniquement |
30| sounddevice | 0.3.3 | |
31| transitions | 0.4.1 | |
32| PyYAML | 3.11 | |
33
34Le projet est également disponible via `pip`:
35
36 pip install music_sampler
37
38Le programme utilise les polices `Symbola` et `Ubuntu` (Regular / Bold), qui
39doivent être disponibles, et la librairie `portaudio`:
40
41 sudo apt-get install ttf-ancient-fonts ttf-ubuntu-font-family portaudio
42
43Pour compiler kivy avec la librairie SDL2, il faut certains paquets installés:
44
45 sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev
46
47cf [Installation
48Kivy](https://kivy.org/docs/installation/installation-linux.html)
49
50## Version compilée
51
52Une version compilée peut être créée avec pyinstaller:
53
54 :::bash
55 pyinstaller music_sampler.spec
56
57## Téléchargements
58
59- Un exemple de configuration ainsi que des musiques associées à l'exemple
60 peuvent être trouvées sur
61 [owncloud](https://outils.immae.eu/owncloud/index.php/s/kSrIe15G1AiZ9YF)
62- Une version précompilée de `music_sampler` peut également être téléchargée
63 [dans le même
64 dossier](https://outils.immae.eu/owncloud/index.php/s/kSrIe15G1AiZ9YF/download?path=%2F&files=music_sampler)
65 (attention, elle n'est pas toujours forcément à jour, lancer le programme avec
66 `-V` pour voir la version compilée)
67
68## Utilisation
69
70Tout le travail consiste à préparer les transitions dans le fichier de
71configuration `config.yml`.
72
73Lancer ensuite le programme dans le dossier où se situe le fichier de
74configuration (voir plus bas pour une utilisation avancée). Une fenêtre
75représentant un clavier apparaît. Le rond orange dans le coin du clavier devient
76vert lorsque tout est chargé, ou rouge en cas de problème. Une touche grisée et
77barrée représente une touche non-utilisable pour le moment : soit parce que la
78musique est en cours de chargement (au lancement du programme, cela peut prendre
79un peu de temps sur certaines machines), soit parce qu'il y a une action en
80cours.
81
82Un exemple de fichier de configuration est fourni, avec un certain nombre de
83touches et de transitions programmées (pour les trois musiques fournies), la
84syntaxe du fichier (expliquée plus bas) se comprend aisément en le regardant. De
85plus, certaines touches (par exemple 'ÉCHAP' pour tout arrêter) peuvent être
86gardées d'une fois sur l'autre.
87
88### Actions possibles
89
90 - Cliquer sur une touche : affiche les actions associées à cette touche (dans
91 le cadre en bas à gauche).
92 - Appuyer sur une touche : déclenche les actions associées à cette touche
93 (affichées également dans le cadre en bas à gauche). Lorsqu'une touche a des
94 actions en cours, son cadre est noir. Notez qu'une action de type "jouer une
95 musique" est considérée comme terminée quand ladite musique est lancée. En
96 cas d'appui répété sur une touche, music_sampler ne relance pas les actions
97 associées à cette touche si ces actions ne sont pas terminées ; cela pour
98 éviter les "accidents".
99 - Ctrl+C ou Ctrl+Q : quitte le programme (possible aussi en cliquant
100 simplement sur la croix en haut à droite).
101 - Ctrl+R : recharge le fichier de configuration.
102
103### Options disponibles au lancement
104
105Toutes les options au lancement sont facultatives ; la plupart du temps lancer
106le programme dans le bon dossier suffit. La plupart d'entre elles peuvent être
107définies également dans le fichier de config (à part `--config` bien sûr). Les
108arguments en ligne de commande ont toujours la priorité.
109
110 * `-h, --help` : affiche une liste des options disponibles.
111 * `-c CONFIG, --config CONFIG` : précise le fichier de configuration à charger
112 (par défaut, config.yml qui se trouve dans le dossier où est lancé
113 music_sampler).
114 * `-p MUSIC_PATH, --music-path MUSIC_PATH` : précise le chemin des musiques
115 (par défaut, le dossier courant).
116 * `--no-debug, --debug` : Affiche les informations de déboggage (désactivé par
117 défaut)
118 * `-V, --version` : affiche la version courante et quitte (utilisable
119 uniquement pour la version compilée).
120 * `-L, --language` : change la langue de l'application. Actuellement: fr, en
121 (par défaut 'fr')
122 * `--focus-warning, --no-focus-warning`: Afficher / Ne pas afficher
123 d'avertissement lorsque l'application perd le focus (activé par défaut).
124
125Les options suivantes sont plutôt réservées à un usage avancé de music_sampler,
126ou en cas de problème avec la configuration standard :
127
128 * `--no-builtin-mixing, --builtin-mixing` Effectue en interne le mixage des
129 sons. Par défaut, music_sampler confie le mixage au système : n'activer
130 cette option que si le système n'y parvient pas.
131 * `-l LATENCY, --latency LATENCY` : latence. Préciser "low", "high" ou un
132 nombre de secondes (par défaut, "high")
133 * `-b BLOCKSIZE, --blocksize BLOCKSIZE` : taille des blocs. Nombre de frames
134 pour chaque étape du mixeur. 0 (par défaut) signifie que le programme
135 choisit lui-même le nombre qui lui convient.
136 * `-f FRAME_RATE, --frame-rate FRAME_RATE` : fréquence d'échantillonnage pour
137 jouer les musiques. Par défaut : 44100
138 * `-x CHANNELS, --channels CHANNELS` : nombre de canaux par musique (2 par
139 défaut, pour une écoute stéréo)
140 * `-s SAMPLE_WIDTH, --sample-width SAMPLE_WIDTH` : largeur d'échantillonnage
141 (nombre d'octets pour chaque frame). Par défaut : 2.
142 * `--device DEVICE` : sélectionne le périphérique de son.
143 * `--list-devices` : Affiche la liste des périphériques de son disponibles.
144 * `-- ARGS` : Arguments à passer à la librairie Kivy.
145
146## Configurer les touches
147
148**ATTENTION : le format du fichier de configuration est susceptible d'évoluer,
149sans garantie de rétrocompatibilité.**
150
151Le fichier config.yml utilise la syntaxe yaml. Les catégories et sous-catégories
152sont gérées par l'indentation par des espaces (mais PAS par des tabulations !).
153le `#` est un symbole de commentaire : tout ce qui suit ce symbole sur une ligne
154est ignoré.
155
156En cas d'erreur dans le fichier de configuration, un message d'erreur s'affiche
157dans le terminal. Selon la "gravité" de l'erreur, music_sampler se lance en
158ignorant les actions erronées (en colorant éventuellement la touche en noir), ou
159ne se lance pas du tout.
160
161Le fichier contient plusieurs sections :
162
163 :::yaml
164 config:
165 ...
166
167 aliases:
168 ...
169
170 music_properties:
171 ...
172
173 key_properties:
174 ...
175
176 keys:
177 ...
178
179
180### `config`
181
182La section config permet d'enregistrer les paramètres habituellement donnés en
183ligne de commande. Les '-' dans le nom du paramètre long doivent être remplacés
184par des '_' (par exemple '--music-path' -> 'music_path'). Pour les switches
185(`debug`, `focus_warning`, `builtin_mixing`), utilisez la version sans le 'no-'
186et spécifiez `true` / `false` en valeur. Notez que les arguments donnés en ligne
187de commande sont toujours prioritaires sur les valeurs du fichier.
188
189### `music_properties` : propriétés des musiques
190
191Cette section sert à définir des propriétés globales des musiques.
192
193#### Exemples
194
195 :::yaml
196 "music1.mp3":
197 name: My favorite music
198 gain: 1.4
199La musique "music1.mp3" est désignée par le nom "My favorite music". Elle est
200chargée à 140% de son volume normal.
201
202 :::yaml
203 "music2.mp3":
204 gain: 0.7
205
206La musique "music2.mp3" est chargée à 70% de son volume normal.
207
208#### Liste des options possibles
209- `name: My music` La musique sera désignée (dans les actions, dans le
210 terminal) comme "My music" au lieu du chemin du fichier. Par exemple le cadre
211 des actions affichera "starting « My music » at volume 100%". Attention, cela
212 ne fait pas office d'alias dans le fichier de configuration (voir la section
213 *aliases*).
214- `gain: x` Charge la musique avec un gain de x (multiplicatif). Utiliser la
215 commande "volume" pour changer ponctuellement le volume (0 à 100%) au cours de
216 l'écoute.
217
218### `key_properties` : affichage et propriétés des touches
219
220Cette section sert à décrire l'affichage à l'écran des touches : couleur et
221texte. Par défaut, une touche "attribuée" à une ou plusieurs actions s'affiche
222en vert.
223
224#### Exemples
225
226 :::yaml
227 'ESC':
228 description:
229 -
230 - STOP !
231 color: [255, 0, 0]
232 repeat_delay: 2
233
234La touche échap est de couleur rouge, et le texte "STOP !" est affiché sur la
235deuxième ligne. Si on appuie deux fois sur la même touche à moins de deux
236secondes d'intervalle, le second appui est ignoré.
237
238#### Liste des options possibles
239- `description` : le texte qui s'affiche, à côté du "nom" de la touche. Il faut
240 mettre un tiret pour une ligne de texte (pas de retour à la ligne
241 automatique). La première ligne correspond à celle de la lettre associée à la
242 touche, aussi il vaut mieux souvent la laisser vide, ou ne mettre que très peu
243 de texte (voir l'exemple ci-dessus). Sur un écran de taille raisonnable, on
244 peut compter 3 lignes (incluant la première) pour une touche "standard".
245- `color: [r, g, b]` : la couleur de la touche. r, g et b sont les proportions
246 de rouge, vert et bleu, et doivent être des entiers entre 0 et 255.
247- `repeat_delay: x` (par défaut : 0) : délai de "sécurité" en cas d'appuis
248 successifs sur la touche. La touche est désactivée (grisée et barrée) pendant
249 toute la durée des actions puis le délai de x secondes.
250
251### Propriété `common`
252
253Une entrée spéciale `common` s'applique à toutes les touches. Les propriétés
254définies dans cette entrée peuvent être modifiées individuellement.
255
256### `keys` : actions sur les touches
257
258Cette section sert à décrire, pour chaque touche, la liste des actions
259successives. Notez que la plupart des actions (hors `wait` et quelques cas
260particuliers, voir plus bas) sont quasi-instantanées.
261
262
263#### Exemples
264
265 :::yaml
266 'a':
267 - play:
268 file: "music1.mp3"
269 volume: 70
270 start_at: 10
271 - wait:
272 duration: 5
273 - stop:
274 file: "music1.mp3"
275 fade_out: 2
276
277Lance la musique "music1.mp3" à 70% de son volume max, à 10 secondes du début,
278puis au bout de 5 secondes coupe la musique avec un fondu de 2 secondes.
279
280 :::yaml
281 'b':
282 - stop:
283 file: "music1.mp3"
284 fade_out: 5
285 wait: false
286 - play:
287 file: "music2.mp3"
288 fade_in: 5
289
290Effectue un fondu enchaîné de 5 secondes entre "music1.mp3" et "music2.mp3"
291
292 :::yaml
293 'c':
294 - stop:
295 file: "music1.mp3"
296 fade_out: 5
297 wait: true
298 - wait:
299 duration: 2
300 - play:
301 file: "music2.mp3"
302 - seek:
303 file: "music2.mp3"
304 delta: false
305 value: 60
306Coupe la musique "music1.mp3" avec un fondu de 5 secondes, attend la fin du
307fondu, puis attend encore deux secondes et lance la musique "music2.mp3", au
308temps d'une minute.
309
310 :::yaml
311 'd':
312 - volume:
313 file: "music1.mp3"
314 value: 50
315 - play:
316 file: "noise.mp3"
317 loop: 1
318 - wait:
319 file: "noise.mp3"
320 - volume:
321 file: "music1.mp3"
322 value: 100
323
324Baisse le volume de "music1.mp3" pendant que le son "noise.mp3" est joué par
325dessus (deux fois). Le volume revient à la normale une fois que les deux écoutes
326du son "noise" sont terminées.
327
328 :::yaml
329 'e':
330 - pause:
331 file: "music1.mp3"
332 - wait:
333 duration: 10
334 - unpause:
335 file: "music1.mp3"
336 - seek:
337 file: "music1.mp3"
338 delta: true
339 value: 5
340
341Met en pause la musique "music1.mp3" pour 10 secondes et la relance après, en
342avançant de 5 secondes dans la musique.
343
344#### Liste des actions possibles:
345- `play` : joue une musique. music_sampler ne joue qu'une musique à la fois : si
346 la musique demandée est déjà en train d'être jouée, elle n'est pas relancée ou
347 jouée "par dessus". Paramètres :
348 * `file: "music.mp3"` précise la musique jouée (chemin relatif).
349 * `fade_in: x` (facultatif) lance la musique avec un fondu au départ de x
350 secondes.
351 * `volume: x` (facultatif, défaut : 100) la musique doit être jouée à x% de
352 son volume max.
353 * `loop: x` (facultatif, défaut : 0) la musique doit être répétée x fois.
354 Indiquer -1 pour la répéter indéfiniment. Attention, x est le nombre de
355 répétitions, donc pour lire trois fois la musique, mettre `loop: 2`.
356 * `start_at: x` (facultatif, défaut : 0) la musique démarre à x secondes du
357 début.
358 * `restart_if_running: true/false` (facultatif, défaut : false) la musique
359 est éventuellement stoppée et redémarrée si nécessaire
360- `stop` : arrête une musique donnée. Paramètres :
361 * `file: "music.mp3"` (facultatif) précise la musique à stopper. Si aucune
362 musique n'est précisée, le `stop` s'applique à toutes les musiques.
363 * `fade_out: x` (facultatif) stoppe la musique avec un fondu de x secondes.
364 * `wait: true/false` (facultatif, par défaut : false) dans le cas d'un
365 fondu, attendre la durée du fondu pour faire les actions suivantes. Si la
366 musique s'arrêtait naturellement avant la fin du fondu, l'attente se
367 termine lorsque la musique se termine naturellement. Lorsque plusieurs
368 musiques sont stoppées en fondu, le `wait` n'attend que la dernière
369 musique de la playlist (qui peut se terminer naturellement avant les
370 autres).
371 * `set_wait_id: name` (facultatif, inutile lorsque `wait` est à false) donne
372 l'identifiant `name` à l'attente de fin du fondu (voir `interrupt_wait`).
373 L'identifiant peut être n'importe quelle chaîne de caractère.
374- `volume` : change le volume d'une musique donnée. Paramètres :
375 * `file: "music.mp3"` (facultatif) précise la musique. Si aucune musique
376 n'est précisée, la modification s'applique au volume global.
377 * `delta: true/false` (facultatif, par défaut : false) le volume doit il
378 être précisé en absolu (false), ou en relatif (true), voir plus bas.
379 * `value: x` Si delta est à false, met le volume à x% du volume max (x doit
380 être entre 0 et 100). Ce facteur est appliqué à la musique déjà chargée en
381 mémoire (voir section "propriétés"), donc le 100% fait référence au volume
382 de chargement.
383Si delta est à true, applique un modificateur de x% au volume (x doit être un
384entier signé). Notez qu'une action "+10%" relative ne correspond pas à un
385pourcentage du volume actuel, mais du volume "de référence" 100%. Ainsi,
386effectuer +10% et -10% en relatif revient bien à 100%.
387 * `fade: x` (facultatif) le changement de volume est appliqué en fondu sur x
388 secondes. Il n'y a pas d'attente de la fin du fondu pour lancer les
389 actions suivantes : au besoin, rajouter un `wait` à la main.
390- `pause` : met en pause une musique. Paramètres :
391 * `file: "music.mp3"` (facultatif) précise la musique à mettre en pause. Si
392 non précisé, s'applique à toutes les musiques.
393- `unpause` : relance une musique mise en pause (là où elle en était).
394 Paramètres :
395 * `file: "music.mp3"` (facultatif) précise la musique à relancer. Si non
396 précisé, s'applique à toutes les musiques.
397- `wait` : attend un temps donné. Paramètres :
398 * `file: "music.mp3"` (facultatif) attend la fin de la musique "music.mp3"
399 * `duration: x` (facultatif) attend x secondes. Si `file` et `duration` sont
400 précisés, l'attente dure jusqu'à la fin de la musique PUIS la durée donnée
401 par `duration`.
402 * `set_wait_id: name` (facultatif) donne l'identifiant `name` à l'attente
403 (voir `interrupt_wait`). L'identifiant peut être n'importe quelle chaîne
404 de caractère.
405Notez une fois encore que `wait` est quasiment la seule action qui attend
406d'avoir terminé pour lancer la commande suivante, toutes les autres sont lancées
407successivement mais sans attendre (donc presque simultanément) : ne pas hésiter
408à rajouter des commandes d'attente partout où c'est nécessaire.
409- `seek` : permet d'aller à un endroit précis dans une musique. Paramètres :
410 * `file: "music.mp3"` (facultatif) précise la musique. Si aucune musique
411 n'est précisée, l'action s'applique à toutes les musiques.
412 * `delta: true/false` (facultatif, défaut : false) Si `delta` est true, le
413 temps est relatif. Si delta est false, le temps est absolu, voir plus bas.
414 * `value: x` Si `delta` est true, alors fait avancer de x secondes dans la
415 musique (reculer si x est négatif). Si delta est false, alors la lecture
416 se place à x secondes à partir du début. Si la musique est en train de
417 faire un fondu (au départ, ou changement de volume), le fondu se "termine
418 automatiquement" : et la musique est immédiatement au volume final voulu.
419 Si la musique est en train de se terminer en fondu, le "seek" est ignoré
420 (un fondu de fin considère la musique comme déjà terminée). En cas de
421 `loop`, si le déplacement est relatif la musique peut éventuellement
422 passer à la répétition suivante / précédente; sinon, le déplacement se
423 fait dans la répétition courante.
424- `stop_all_actions:` Interrompt toutes les actions en cours et à faire. Notez
425 qu'une musique lancée (y compris avec une option `loop`) est considérée comme
426 une action "déjà terminée", et ne sera donc pas interrompue (utiliser `stop`
427 sans arguments pour stopper toutes les musiques en écoute). Paramètre :
428 * `other_only: true/false` (facultatif, défaut : false) : si `other_only`
429 est true, la commande interrompt uniquement les actions des *autres*
430 touches. Sinon, cette commande interrompt également les actions de la
431 touche actuelle ; dans ce cas il est inutile de mettre des actions à la
432 suite de celle-ci puisqu'elles seront systématiquement interrompues.
433- `interrupt_wait`: interrompt l'attente (de `wait` ou fin d'un fondu avec
434 attente) et passe directement à l'action suivante. Paramètre :
435 * `wait_id: name` (facultatif) précise l'identifiant du `wait` à stopper
436 (défini par `set_wait_id`, voir les actions `wait` et `stop`). Si absent,
437 interrompt toutes les attentes.
438- `pause_wait`: met une attente en pause (uniquement pour une attente ayant une
439 durée définie). La touche qui attend cet événement ne continuera pas tant que
440 l'attente n'est pas reprise. Paramètres :
441 * `wait_id: name` (facultatif) précise l'identifiant du `wait` à mettre en
442 pause. Si absent, met en pause toutes les attentes compatibles.
443- `unpause_wait`: reprend une attente en pause (uniquement pour une attente
444 ayant une durée définie). Le compte à rebours reprendra pour la touche
445 correspondante en train d'attendre. Paramètres:
446 * `wait_id: name` (facultatif) précise l'identifiant du `wait` à reprendre.
447 Si absent, reprend toutes les attentes compatibles.
448- `reset_wait`: réinitialise une attente (uniquement pour une attente ayant une
449 durée définie). Si l'attente est en pause, le compte à rebours ne recommencera
450 au début que lorsque l'attente sera reprise. Paramètres:
451 * `wait_id: name` (facultatif) précise l'identifiant du `wait` à
452 réinitialiser. Si absent, réinitialise toutes les attentes compatibles.
453- `run_command` : lance une commande. Paramètres :
454 * `command: my_command` : précise la commande à lancer.
455 * `wait: true/false` (facultatif, défaut : false) : si `wait` est true,
456 attend que la commande ait fini de s'exécuter.
457
458### `aliases` : définir des alias
459
460Il est possible de définir des alias pour les différents paramètres. Ces alias
461sont internes au fichier de configuration ; pour afficher un "joli" nom d'une
462musique, voir plutôt "music_properties".
463
464La syntaxe est la suivante:
465
466 :::yaml
467 aliases:
468 alias1:
469 param: value
470 alias2:
471 param1: value1
472 param2: value2
473
474On utilise ensuite, dans le fichier de configuration, `include: alias1` ou
475`include: [alias1, alias2]` à la place de `param: value`. Dans le cas de
476plusieurs aliases inclus contenant des éléments identiques, seul le dernier est
477pris en compte. Dans tous les cas, les alias ne sont *pas* prioritaires par
478rapport aux éventuels paramètres définis là où ils sont inclus. Voir les
479exemples ci-dessous.
480
481#### Exemples
482
483 :::yaml
484 aliases:
485 music1:
486 file: "path/to/my/favourite/music.mp3"
487
488 keys:
489 'a':
490 play:
491 include: music1
492
493`music1` est désormais un alias pour `"path/to/my/favourite/music.mp3"`. À
494chaque fois qu'on veut écrire `file: "path/to/my/favourite/music.mp3"`, on peut
495écrire à la place `include: music1`. Attention, dans la section
496"music_properties", les alias ne fonctionnent pas, et il faut écrire le nom du
497fichier complet.
498
499 :::yaml
500 aliases:
501 blue:
502 color: [0, 0, 255]
503
504 keys_properties:
505 'a':
506 description:
507 -
508 - blue key
509 include: blue
510
511`blue` est un alias pour la couleur `[0, 0, 255]`. À chaque fois qu'on veut
512écrire `color: [0, 0, 255]`, on peut écrire `include: blue` à la place.
513
514 :::yaml
515 aliases:
516 long_time:
517 duration: 42
518
519 keys:
520 'b':
521 wait:
522 include: long_time
523 play:
524 file: "music1.mp3"
525
526`long_time` est un alias pour la durée 42 secondes. Au lieu d'écrire `duration:
52742`, on peut écrire `include: long_time`.
528
529## Problèmes possibles
530
531Sont listés ci-dessous une liste de problèmes rencontrés, avec des solutions
532proposées. Si vous en découvrez d'autre, contactez l'auteur pour les ajouter à
533la liste.
534
535* Le programme se lance et s'arrête tout de suite.
536
537Il s'agit généralement d'une erreur de syntaxe dans le fichier de config. Dans
538ce cas, le terminal doit afficher quelques détails sur l'erreur en question (au
539moins la ligne correspondante).
540
541* La musique "grésille" affreusement.
542
543Il peut s'agir d'un problème de latence (avec certains ordinateurs un peu
544lents). Essayez de changer la latence (par exemple, 0.1 seconde)
545
546* Impossible de jouer plus d'une musique à la fois.
547
548Le système n'arrive pas à mixer les musiques par lui-même. Vous pouvez essayer
549de regarder la liste des périphériques de son (`--list-devices`) puis en
550sélectionner un autre si disponible. Vous pouvez aussi essayer le mixeur intégré
551à music_sampler, mais les résultats ne sont pas toujours très fluides (ne pas
552hésiter à jouer avec les paramètres avancés comme latency et blocksize).
553
554Si votre système utilise PulseAudio, il peut s'agir d'un problème de
555configuration du plugin ALSA. Dans ce cas, essayez de mettre la configuration
556suivante dans `/etc/asound.conf`, puis redémarrer la machine (solution empirique
557qui semble avoir fonctionné, sans garantie !):
558
559 pcm.!default {
560 type pulse
561 fallback "sysdefault"
562 hint {
563 show on
564 description "Default ALSA Output (currently PulseAudio Sound Server)"
565 }
566 }
567
568 ctl.!default {
569 type pulse
570 fallback "sysdefault"
571 }
572
573* La console affiche une erreur :
574
575 Exception in thread Thread-1:
576 Traceback (most recent call last):
577 File "threading.py", line 914, in _bootstrap_inner
578 File "threading.py", line 862, in run
579 File "kivy/input/providers/mtdev.py", line 219, in _thread_run
580 File "kivy/lib/mtdev.py", line 131, in __init__
581 PermissionError: [Errno 13] Permission denied: '/dev/input/event6'
582
583C'est une erreur de permission d'accès à un périphérique, généré par la
584librairie kivy. Elle peut être ignorée et n'aura pas d'incidence.
585
586* Pour d'autres problèmes ou bugs à reporter, voir le [Bug
587 Tracker](https://git.immae.eu/mantisbt/view_all_bug_page.php?project_id=1&sort=status%2Clast_updated&dir=ASC%2CDESC)
588
589## Divers
590
591Les extraits de musiques proposés en exemples proviennent de
592[Jamendo](https://jamendo.com). Les musiques (complètes) sont disponibles en
593libre téléchargement pour un usage non commercial :
594
595[Short Blues](https://www.jamendo.com/track/340173/short-blues)
596
597[To the Fantasy war](https://www.jamendo.com/track/778560/to-the-fantasy-war)
598
599Le bruit de crocodile provient de
600[Universal-Soundbank](http://www.universal-soundbank.com/).
601
602Cet outil a été développé à l'origine pour faciliter la gestion du son pour les
603spectacles de la compagnie circassienne [Les pieds
604jaloux](http://piedsjaloux.fr/). N'ayant pas d'ingénieur son, les artistes
605eux-mêmes peuvent alors gérer leur musique lorsqu'ils ne sont pas sur scène :
606d'où la nécessité de préparer les transitions à l'avance et, au moment de la
607représentation, de réduire l'interaction avec la machine au minimum (une
608touche).