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 pour dicter au système comment générer les vidéos et communiquer avec les plateformes.obligatoire.

🎯 Objectif

Contrairement au fichier .env qui sécurise vos identifiants secrets, leLe 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é	Description
podcast_id	Identifiant unique de votre podcast (généralementhosté issusur de la plateforme d'hébergement)Spotify).
podcast_url	L'URL absolue vers ledu flux RSS de votre podcast.
use_short_url	Booléen (True/False) indiquant si les liens générés doivent être raccourcis (via Bitly)Bitly).

2. [discord_details]

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

3. [facebook_details]

Clé	Description
default_tags	Liste de hashtags séparés par des virgules, inclus systématiquement dans vos publications Facebook.Facebook.
post_message	Booléen activant ou désactivant la publication automatique sur Facebook.Facebook.

4. [X_details]

Clé	Description
default_tags	Liste de hashtags séparés par des virgules, inclus systématiquement dans vos publications X.
max_length	Nombre entier définissant la limite de caractères du message pour respecter les contraintes de la plateforme (ex: 280).
post_message	Booléen activant ou désactivant la publication automatique sur X.X.

5. [youtube_details]

Clé	Description
auto_upload	Booléen activant ou désactivant le téléversement de la vidéo générée sur YouTube.YouTube.
private	Booléen définissant si la vidéo téléversée doit rester en statut "Privé" (True) ou être publique (False).
notify_subscribers	Booléen indiquant s'il faut notifier vos abonnés YouTube de cette nouvelle sortie.
category	Code numérique définissant la catégorie YouTube de votre vidéovidéo. (ex:La 27liste pourdes l'Éducation)valeurs possibles est disponible ici.
playlist_id	Identifiant unique de la playlist YouTube dans laquelle l'épisode sera classé.
default_tags	Liste de mots-clés séparés par des virgules, propres au référencement YouTube.

6. [audio_split_details]

Clé	Description
start_at	Horodatage de début si vous souhaitez générer un extrait. Laissez vide pour utiliser l'épisode complet.
duration	Durée exacte de l'extrait audio à conserver. Laissez vide pour garder l'épisode entier.

7. [graphic_details]

Clé	Description
color	Code couleur au format hexadécimal (sans le symbole #) utilisé pour l'habillage de la vidéo.
logo_file_name	Chemin relatif vers l'image de votre logo à incruster.

8. [text_details]

Clé	Description
text_message	Texte fixe permanent à afficher sur le rendu vidéo (ex: l'adresse de votre site web).
text_length_limit	Nombre entier fixant la limite de caractères pour l'affichage dynamique du titre de l'épisode.
font_file_name	Chemin relatif vers le fichier de police de caractères (.ttf) à utiliser pour le texte.

9. [mariaDb_details] (Optionnel - Pour utilisateurs avancés)

Rappel important : 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é	Description
DBName	Le nom de la base de données dédiée (ex: podcast_utilities).
host	L'adresse IP ou le nom d'hôte de votre serveur MariaDB.
port	Le port de communication du serveur (généralement 3306).

10. [other]

Clé	Description
ask_tags	Booléen (True/False) indiquant si le script doit faire une pause pour vous demander de taper des tags spécifiques à l'épisode en cours.
export_stats	Booléen définissant si le système doit exporter/sauvegarder les statistiques récupérées.
social_network_template_path	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.