X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=documentation_fr.md;h=8ba058d6d2379bcd8107ef0ff6e0f8fb14737b38;hb=35bde798b6cda13579337b0ec5a803fdd5eab19a;hp=f6f8f02b6be4936fed15904339bbfc3fa699f7f8;hpb=201d8411d7e1f70f13ced3fc797a696e6593f3a0;p=perso%2FImmae%2FProjets%2FPython%2FMusicSampler.git

diff --git a/documentation_fr.md b/documentation_fr.md
index f6f8f02..8ba058d 100644
--- a/documentation_fr.md
+++ b/documentation_fr.md
@@ -8,13 +8,40 @@ Music Sampler est un lecteur de musique qui permet de pré-programmer des transi
 
 ## Pré-requis et installation
 
-Il faut avoir ffmpeg d'installé. Pour cela, il faut installer le paquet `libav-tools` :
+- Il faut avoir ffmpeg d'installé. Pour cela, il faut installer le paquet `libav-tools` :
 
-    :::bash
+    ```
     sudo apt-get install libav-tools
+    ```
 
 Si vous utilisez la version compilée de Music Sampler, il n'y a rien d'autre à installer.
 
+- Pour utiliser les sources directement, les modules suivants sont requis:
+
+| module      | version minimale | commentaire                      |
+| ----------- | ---------------- | -------------------------------- |
+| Kivy        | 1.9.1            |                                  |
+| Markdown    | 2.6.6            | pour la documentation uniquement |
+| pydub       | 0.16.4           |                                  |
+| Pygame      | 1.9.2pre         | utilisée par Kivy                |
+| Pygments    | 2.1.3            | pour la documentation uniquement |
+| sounddevice | 0.3.3            |                                  |
+| transitions | 0.4.1            |                                  |
+| PyYAML      | 3.11             |                                  |
+
+- Le programme utilise les polices "Symbola" et "Ubuntu" (Regular / Bold), qui doivent être disponibles.
+
+    ```
+    sudo apt-get install ttf-ancient-fonts ttf-ubuntu-font-family
+    ```
+
+## Version compilée
+
+Une version compilée peut être créée avec pyinstaller:
+
+    :::bash
+    pyinstaller music_sampler.spec
+
 ## Utilisation
 
 Tout le travail consiste à préparer les transitions dans le fichier de configuration config.yml.
@@ -317,6 +344,23 @@ Il peut s'agir d'un problème de latence (avec certains ordinateurs un peu lents
 
 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"
+    }
+
+  * 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)
 ## 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 :