📝 Document usage

README.md

@@ -1,20 +1,28 @@
 `delarte`
 =========
 
-Du code a mettre au propre
+🚧 Du code a mettre au propre, dans le seul but de faire du python
 
-Notes
------
 
-2 dépendances:
+💡 Mais c’est quoi?
+-------------------
 
-* `m3u8`
-* `webvtt`
+Récupérer un flux vidéo dans un fichier local avec sous titres.
 
-Editer `PATH to ffmpeg`
 
-```python
-python ./delarte.py https://www.arte.tv/fr/videos/093644-001-A/l-incroyable-periple-de-magellan-1-4/
+🚀 Chauffe Marcel!
+------------------
+
+_(pour distribution de famille Debian, adapter les commandes sinon)_
+
+```bash
+git clone https://git.afpy.org/fcode/delarte.git && cd delarte
+sudo apt install ffmpeg
+mkdir ~/.venvs && python3 -m venv ~/.venvs/delarte
+source ~/.venvs/delarte/bin/activate
+pip install -r requirements.txt
+export PATH_FFMPEG=$(which ffmpeg)
+./delarte.py https://www.arte.tv/fr/videos/093644-001-A/meaningless_strings_but_mandatory/
 L'incroyable périple de Magellan (1/4)
         VF : Français
         VO-STF : Version originale - ST français
@@ -25,12 +33,26 @@ L'incroyable périple de Magellan (1/4)
         VAAUD : Allemand (audiodescription)
 ```
 
-liste les versions avec les codes
+Rajouter le code sous-titre en paramètre:
 
-rajouter le code à la ligne de commande:
+```python
+./delarte.py https://www.arte.tv/fr/videos/093644-001-A/meaningless_strings_but_mandatory/ VO-STF
+```
 
-`python ./delarte.py https://www.arte.tv/fr/videos/093644-001-A/l-incroyable-periple-de-magellan-1-4/ VO-STF`
+🔧 Tripoter sous le capot
+-------------------------
 
-et c'est partit
 
-ca créé le fichier .mp4 et le(s) fichiers srt dans le directory en cours
+### 🚀 Chauffe Marcel!
+
+- `Python 3.10` à été utilisé
+
+### 📌 Dépendances
+
+Voir [`requirements.txt`](requirements.txt)
+
+
+### 🤝 Filer un coup de main
+
+- Question, suggestion ➡️ [_ticket du projet_](https://git.afpy.org/fcode/delarte/issues/new)
+- Balance ton code ➡️ [_demande de fusion_](https://git.afpy.org/fcode/delarte/compare/devel)

delarte.py

@@ -5,6 +5,7 @@ import io
 import subprocess
 
 from http import HTTPStatus
+from os import environ
 from typing import cast
 from urllib.parse import urlparse
 from urllib.request import urlopen
@@ -12,7 +13,7 @@ from urllib.request import urlopen
 import m3u8
 import webvtt
 
-FFMPEG = 'ffmpeg.exe'
+FFMPEG = environ.get("PATH_FFMPEG", "ffmpeg path not found")
 
 def call_api(api_url):
     http_response = urlopen(api_url)

requirements.txt

@@ -0,0 +1,2 @@
+m3u8
+webvtt-py