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]

Clé	Requis	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]

Clé	Requis	Description
`post_message`	Oui	Booléen activant (True) ou désactivant (False) la publication automatique sur Discord.

3. [facebook_details]

Clé	Requis	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]

Clé	Requis	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]

Clé	Requis	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]

Clé	Requis	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]

Clé	Requis	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]

Clé	Requis	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.

Clé	Requis	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]

Clé	Requis	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.