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é |
Description |
podcast_id |
Identifiant unique de votre podcast (hosté sur Spotify). |
podcast_url |
L'URL du 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). |
2. [discord_details]
| Clé |
Description |
post_message |
Booléen activant (True) ou désactivant (False) la publication automatique sur Discord. |
3. [facebook_details]
| Clé |
Description |
default_tags |
Liste de hashtags séparés par des virgules, inclus systématiquement dans vos publications Facebook. |
post_message |
Booléen activant ou désactivant la publication automatique sur 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. |
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. |
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éo. La liste des 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.
