PodcastFeedMaker

Tout a commencé par un besoin simple : générer des flux RSS podcast propres, conformes aux standards, sans bidouiller du XML à la main.

Entre 2006 et 2012, je produisais des podcasts de musique électronique. À l'époque, je gérais tout avec un backoffice maison en PHP — du bricolage qui fonctionnait, mais qui demandait une énergie folle pour rester compatible avec iTunes, les agrégateurs, les validateurs.

Des années plus tard, en travaillant sur des projets audio, le besoin est revenu. Sauf que cette fois, je voulais faire les choses bien : une lib Swift moderne, typée, testée, qui respecte tous les standards actuels — Apple Podcasts, Podcast Namespace, PSP-1.

C'est en développant cette librairie que l'idée de Podcast Maker est née. La lib d'abord, l'app ensuite.

PodcastFeedMaker est une bibliothèque Swift pour générer, parser et valider des flux RSS podcast. Pas un wrapper, pas un générateur de templates — une vraie modélisation complète du format RSS avec tous ses namespaces.

La particularité ? Elle est bidirectionnelle. Vous pouvez construire un feed depuis zéro avec des modèles Swift, générer le XML, mais aussi parser un XML existant et le récupérer sous forme de modèles typés. Round-trip complet, sans perte de données.

Elle couvre les 7 namespaces XML qu'on retrouve dans le monde du podcast : RSS 2.0, iTunes, Podcast Namespace 2.0 (avec les 32 tags), Atom, Dublin Core, Content Module, et Podlove Simple Chapters. Côté validation, cinq plateformes majeures sont supportées : Apple Podcasts, Spotify, Amazon Music, Podcast Index, et le standard PSP-1.

Le tout sans aucune dépendance externe dans la lib core — du Swift pur avec Foundation, compatible Linux dès le départ.

Voici le workflow complet : construire un flux, générer le XML, le re-parser, et le valider.

Le monde du podcast RSS, c'est un empilement de namespaces XML qui se sont ajoutés au fil des années. PodcastFeedMaker les gère tous — chaque tag, chaque attribut est modélisé, généré, parsé et validé.

Le Podcast Namespace porté par Podcast Index apporte 32 nouveaux tags organisés en phases. PodcastFeedMaker les implémente tous :

Chaque plateforme a ses exigences. Apple veut du HTTPS partout et un artwork entre 1400 et 3000px. Spotify préfère le MP3 et limite les fichiers à 200 Mo. PSP-1 exige un GUID sur chaque épisode.

Plutôt que de découvrir ces problèmes au moment de la soumission, FeedValidator vérifie tout en amont :

Construire un feed avec PodcastFeedMaker, c'est chaîner des modifiers de façon fluide. Pas de XML à écrire, pas de strings magiques — tout est typé.

18 modifiers sont disponibles pour le channel (auteur, catégories, image, owner, funding, etc.) et 14 pour les items (description, durée, saison, épisode, personnes, transcripts, soundbites, etc.).

Trois factories définissent le type MIME automatiquement — plus besoin de se souvenir si c'est audio/mpeg ou audio/mp3 :

FeedGenerator produit du XML complet en mode synchrone. Pour les catalogues massifs (10 000+ épisodes), StreamingFeedGenerator génère par chunks asynchrones :

Quatre modes pour gérer les déclarations de namespaces dans le XML généré :

Le parser gère les 7 namespaces avec récupération d'erreur best-effort. Un feed mal formé ne fait pas tout planter — vous récupérez ce qui est lisible avec des diagnostics sur ce qui a posé problème.

Dans la vraie vie, les feeds podcast utilisent des formats de dates... créatifs. Le parser en gère 12 :

Quatre templates pré-configurés selon vos besoins. Chacun active un ensemble de tags et de validations adaptés :

Les templates sont composables avec l'opérateur + et configurables via .requiring(), .recommending(), .targeting().

Parser un feed existant, le modifier et le régénérer — sans perdre les éléments qu'on ne connaît pas. C'est crucial quand on travaille avec des feeds tiers qui utilisent des extensions custom.

FeedDiff détecte les différences entre deux versions d'un feed :

Deux systèmes de chapitres coexistent dans l'écosystème podcast. PodcastFeedMaker supporte les deux :

podcastfeed expose toutes les fonctionnalités de la lib en ligne de commande. Parfait pour l'automatisation et les pipelines CI/CD.

Pour l'intégration CI/CD : 0 = succès, 1 = erreur, 2 = warnings sans erreur. En mode --strict, les warnings deviennent des erreurs.

2655 tests répartis dans 283 suites. Couverture complète des 7 namespaces, des 12 formats de dates, des 5 validateurs. Tous les tests tournent sur macOS et Linux en CI — pas de mocks, que du vrai XMLParser et de vraies Data.

Les specs sur lesquelles s'appuie PodcastFeedMaker :