lav-outils/podcasts/README

= Documentation à lire si besoin =

https://wiki.april.org/w/Proc%C3%A9dure_pour_le_traitement_des_podcasts_de_Libre_%C3%A0_vous_!

= Logiciels à installer pour le traitement des podcasts =

# apt install mediainfo

# apt install eyed3

= Récupérer et traiter le podcast Cause Commune =

- Récupérer le fichier MP3 depuis la page consacrée à l'émission sur https://cause-commune.fm/shows/libre-a-vous/

- Convertir le fichier au format OGG et réduire le bitrate (exemple
  avec l'émission du 21 mai 2019), le nom du fichier OGG doit être au
  format libre-a-vous-AAAAMMJJ.ogg (AAAA pour l'année en chiffres, MM
  pour le mois en chiffres, JJ en chiffres pour le jour de diffusion
  de l'émission) :

 # wget https://cause-commune.fm/podcast-download/10835/modeles-dorganisation-dentreprises-transcriptions-partager-est-bon.mp3

 # ffmpeg -i modeles-dorganisation-dentreprises-transcriptions-partager-est-bon.mp3 -ab 192k -vn libre-a-vous-20190521.ogg

L'option -vn est utile car elle permet d'éviter d'avoir un fichier de
sortie ayant un format Theora. Attention, elle doit être après le
fichier qui est en paramètre de l'option -i et pas avant sinon cela ne
fonctionne pas.

= Comment découper l'enregistrement en podcasts =

* Se positionner dans le dossier contenant l'enregistrement, FFmpeg, le dépot d'outils :
root@raspberrypi:~/lav-outils# ls -l ~/libreavous/
total 357004
drwxr-xr-x 19 root root     4096 janv.  7 11:47 FFmpeg
drwxr-xr-x  5 root root     4096 janv. 16 11:53 lav-outils
-rw-r--r--  1 root root 90081558 janv. 15 17:54 libre-a-vous-20190108.ogg

* Regarder le programme de l'émission et chercher les timestamp de début et de fin des différents podcast

* Décider d'un nom court, qui sera utilisé pour le fichier de podcast

* Écrire la conf json en s'inspirant de example.json (mettre à jour la date), et ne pas hésiter à mettre des centièmes de secondes, par exemple :

{
        "short_date"    : "20190108",
        "long_date"     : "8 janvier 2019",
        "ffmpeg_bin"    : "./FFmpeg/ffmpeg",
        "chapters"      : [
                {
                        "start_timestamp"       : "0:03:09.3",
                        "end_timestamp"         : "0:18:45",
                        "short_chapter_name"    : "chronique-transcriptions"
                        "chapter_title"         : "Chronique transcriptions"
                },
                {
                        "start_timestamp"       : "00:18:45.4",
                        "end_timestamp"         : "01:11:01",
                        "short_chapter_name"    : "dinsic-etalab"
                        "chapter_title"         : "Débat DINSIC Etalab"
                },
                {
                        "start_timestamp"       : "01:11:01",
                        "end_timestamp"         : "01:23:38",
                        "short_chapter_name"    : "logiciel-caisse"
                        "chapter_title"         : "Logiciel de caisse"
                },
                {
                        "start_timestamp"       : "01:23:38",
                        "end_timestamp"         : "01:29:58",
                        "short_chapter_name"    : "annonces"
                        "chapter_title"         : "Annonces"
                }
        ]
}

* Exécuter le script sans génération des MP3 (qui prend du temps) le temps de vérifier que les timestamps de découpe des podcasts sont ok

root@raspberrypi:~/libreavous# lav-outils/podcasts/scripts/make-all-podcasts.pl --config lav-outils/podcasts/config/lav-20190115.json

* Une fois que les timestamps de découpe des podcasts sont ok exécuter le script avec la génération des MP3 

root@raspberrypi:~/libreavous# lav-outils/podcasts/scripts/make-all-podcasts.pl --config lav-outils/podcasts/config/lav-20190115.json --mp3

* Les podcasts se retrouvent dans le dossier courant