Paramétrage du fichier de configuration (.ini)
Ce document détaille l'ensemble des paramètres de fonctionnement de Podcast Utilities via le fichier .ini. Ce fichier est obligatoire.
🎯 Objectif
Le fichier de configuration .ini agit comme le "cerveau" métier de l'application. Il contient tous les réglages de formatage, les chemins locaux vers vos ressources (logos, polices), ainsi que vos préférences d'automatisation.
⚙️ Sections et Paramètres
1. [podcast_details]
Description
podcast_id
Oui
Identifiant unique de votre podcast (hosté sur Spotify).
podcast_url
Oui
L'URL du flux RSS de votre podcast.
use_short_url
Oui
Booléen (True/False) indiquant si les liens générés doivent être raccourcis (via
Bitly).
2. [discord_details]
Description
post_message
Oui
Booléen activant (True) ou désactivant (False) la publication automatique sur
Discord.
3. [facebook_details]
Description
default_tags
Non
Liste de hashtags séparés par des virgules, inclus systématiquement dans vos publications
Facebook.
post_message
Oui
Booléen activant ou désactivant la publication automatique sur
Facebook.
4. [X_details]
Description
default_tags
Non
Liste de hashtags séparés par des virgules, inclus systématiquement dans vos publications X.
max_length
Oui
Nombre entier définissant la limite de caractères du message pour respecter les contraintes de la plateforme (ex: 280).
post_message
Oui
Booléen activant ou désactivant la publication automatique sur
X.
5. [youtube_details]
Description
auto_upload
Oui
Booléen activant ou désactivant le téléversement de la vidéo générée sur
YouTube.
private
Oui
Booléen définissant si la vidéo téléversée doit rester en statut "Privé" (True) ou être publique (False).
notify_subscribers
Oui
Booléen indiquant s'il faut notifier vos abonnés YouTube de cette nouvelle sortie.
category
Oui
Code numérique définissant la catégorie YouTube de votre vidéo. La liste des valeurs possibles est disponible
ici.
playlist_id
Non
Identifiant unique de la playlist YouTube dans laquelle l'épisode sera classé.
default_tags
Non
Liste de mots-clés séparés par des virgules, propres au référencement YouTube.
6. [audio_split_details]
Description
start_at
Non
Horodatage de début si vous souhaitez générer un extrait. Laissez vide pour utiliser l'épisode complet.
duration
Non
Durée exacte de l'extrait audio à conserver. Laissez vide pour garder l'épisode entier.
7. [graphic_details]
Description
color
Oui
Code couleur au format hexadécimal (sans le symbole #) utilisé pour l'habillage de la vidéo.
logo_file_name
Oui
Chemin relatif vers l'image de votre logo à incruster.
8. [text_details]
Description
text_message
Non
Texte fixe permanent à afficher sur le rendu vidéo (ex: l'adresse de votre site web).
text_length_limit
Oui
Nombre entier fixant la limite de caractères pour l'affichage dynamique du titre de l'épisode.
font_file_name
Oui
Chemin relatif vers le fichier de police de caractères (.ttf) à utiliser pour le texte.
9. [mariaDb_details] (Optionnel - pour utilisateurs avancés)
Par défaut, Podcast Utilities gère automatiquement son historique via une base de données locale (SQLite). Vous n'avez donc pas besoin d'inclure cette section.
Si vous êtes un utilisateur avancé et souhaitez utiliser un serveur externe, intégrez les clés ci-dessous.
Description
DBName
Non
Le nom de la base de données dédiée (Elle doit exister).
host
Non
L'adresse IP ou le nom d'hôte de votre serveur MariaDB.
port
Non
Le port de communication du serveur (généralement
3306).
10. [other]
Description
ask_tags
Oui
Booléen (True/False) indiquant si le script doit faire une pause pour vous demander de taper des tags spécifiques lors de la conversion d'un épisode en vidéo Youtube.
export_stats
Oui
Booléen définissant si le système doit exporter/sauvegarder les statistiques de votre podcast.
social_network_template_path
Oui
Chemin relatif vers le fichier modèle (.template) utilisé pour la mise en forme de vos publications textes.
⚠️ Points d'attention
- Persistance des données (Crucial) : Si vous utilisez le fonctionnement par défaut (sans MariaDB), un fichier SQLite sera généré de manière autonome pour stocker vos statistiques. Si vous déployez cette application via Docker, vous devez impérativement configurer un "Volume" pointant vers le dossier contenant cette base de données locale. Dans le cas contraire, votre historique de statistiques sera définitivement supprimé à chaque mise à jour du conteneur.
- Séparation des rôles : Ne placez jamais de données sensibles (jetons d'accès, mots de passe) dans ce fichier
.ini. Contrairement à ce fichier qui peut être partagé, c'est votre fichier .env qui doit rester strictement confidentiel.
