AudioMarker

Vous avez un fichier audio brut. Vous voulez y ajouter des chapitres horodatés, une pochette, des métadonnées propres. Simple, non ?

En réalité, c'est le parcours du combattant.

À l'époque où je produisais des podcasts de musique électronique, GarageBand permettait d'encoder des fichiers M4A/M4B avec chapitrage intégré. C'était fastidieux, mais ça fonctionnait. Apple a depuis abandonné cette fonctionnalité — et personne n'a vraiment pris le relais.

Aujourd'hui, les options sont limitées : des outils en ligne de commande obscurs, des apps payantes peu flexibles, ou des dépendances lourdes comme FFmpeg qu'on ne peut pas embarquer dans une app iOS. Rien de natif, rien de Swift, rien de vraiment conçu pour les développeurs Apple.

AudioMarker comble ce vide.

AudioMarker est une bibliothèque Swift production-ready pour enrichir vos fichiers audio avec métadonnées, chapitres, artwork et paroles synchronisées.

Le coeur de la librairie est en Swift pur sans aucune dépendance externe. Tout le parsing et l'écriture — que ce soit ID3v2 pour les MP3 ou les atomes ISOBMFF/iTunes pour les M4A — se fait au niveau byte, avec un I/O streaming qui ne charge jamais les données audio en mémoire. Même sur un podcast de 3 heures, l'empreinte mémoire reste minimale.

Deux interfaces, une même puissance :

Une librairie Swift — Intégrable dans vos apps iPhone, iPad, Mac et Vision Pro. Zéro dépendance externe, 100% natif, compatible App Store.

Un outil CLI — 17 commandes pour les traitements en ligne de commande, l'automatisation et les pipelines CI/CD.

La liste est longue, et c'est voulu. Quand on travaille avec de l'audio, on veut un outil qui gère tous les cas — pas juste les 80% faciles.

Commençons par le cas le plus simple : lire un fichier audio et afficher ses informations.

AudioMarkerEngine est le point d'entrée unifié. Il auto-détecte le format depuis les magic bytes et l'extension de fichier, puis dispatche vers le reader approprié — vous n'avez pas à vous soucier de savoir si c'est un MP3, un M4A ou un M4B.

AudioMarker supporte 30 champs de métadonnées répartis en 7 catégories. Voici comment écrire les plus courants :

Le format de l'artwork est auto-détecté depuis les magic bytes — pas besoin de spécifier si c'est du JPEG ou du PNG.

Pour les curieux, voici la liste complète organisée par catégorie :

Ces champs couvrent à la fois la spec ID3v2 (frames TXXX, WXXX, PRIV, UFID...) et les atomes iTunes pour M4A. AudioMarker écrit dans le bon format selon le type de fichier.

Les chapitres, c'est ce qui transforme un fichier audio monolithique en une expérience navigable. Podcast, audiobook, mix DJ — tout devient plus accessible avec un bon chapitrage.

AudioMarker gère automatiquement les points IN/OUT : vous n'avez pas besoin de spécifier la fin de chaque chapitre, elle est calculée à partir du début du suivant.

Le format Enhanced Podcast (popularisé par Apple dans les années 2000) permet d'associer un lien et une image à chaque chapitre. Idéal pour les show notes, les sponsors, ou les références visuelles.

Pour les fichiers M4A/M4B, AudioMarker écrit les chapitres dans deux formats simultanément :

Cette double écriture garantit une compatibilité maximale sans effort de votre part.

Vous avez des chapitres dans un format externe ? Ou vous voulez exporter vers un format spécifique ? AudioMarker supporte 7 formats d'échange avec import/export bidirectionnel (sauf Markdown, export uniquement).

Exemple d'export vers Podlove JSON :

Vous pouvez aussi importer directement dans un fichier audio :

Au-delà des chapitres, AudioMarker gère les paroles synchronisées — ces textes horodatés qui s'affichent en temps réel pendant la lecture. Trois niveaux de complexité sont supportés.

Pour le karaoké, chaque mot peut avoir son propre timing. AudioMarker utilise LyricSegment pour découper une ligne en morceaux :

Pour les podcasts avec plusieurs intervenants, ou les pièces de théâtre audio, vous pouvez identifier qui parle à chaque ligne :

Lors de l'écriture en M4A, AudioMarker choisit automatiquement le meilleur format de stockage :

Vous n'avez pas à y penser — le bon choix est fait pour vous.

4 formats sont supportés pour l'échange de paroles :

TTML supporte les round-trips complets — les speakers, styles et régions survivent à l'export/import.

Avant de publier un fichier audio enrichi, mieux vaut vérifier que tout est cohérent. AudioValidator inspecte un AudioFileInfo et remonte les problèmes potentiels :

Vous pouvez créer vos propres règles via le protocole ValidationRule :

Vous pouvez configurer l'engine pour valider automatiquement avant chaque écriture :

Quand vous avez 200 épisodes de podcast à traiter, le faire un par un n'est pas une option. BatchProcessor traite plusieurs fichiers en parallèle avec une concurrence TaskGroup bornée — vous contrôlez combien de fichiers sont traités simultanément.

Pour afficher une barre de progression ou un indicateur, utilisez processWithProgress qui retourne un AsyncStream :

Opérations batch supportées : .read, .write(_:), .strip, .exportChapters(format:outputURL:).

AudioTimestamp est le type utilisé partout dans AudioMarker pour représenter un instant dans le temps. Il offre une précision à la milliseconde et des utilitaires de parsing/formatage :

L'engine accepte plusieurs options de configuration :

Le padding ID3 est une optimisation importante : si vous modifiez souvent les tags d'un fichier, un padding suffisant permet d'éviter de réécrire tout le fichier audio à chaque modification.

audio-marker est l'interface ligne de commande qui expose toutes les fonctionnalités de la librairie. Parfait pour les scripts, l'automatisation et les pipelines CI/CD.

AudioMarker implémente plusieurs standards audio. Voici les références pour les curieux qui veulent comprendre ce qui se passe sous le capot :

Le package est organisé en modules distincts avec une séparation claire des responsabilités :

Le module AudioMarker n'a aucune dépendance externe. Seul le CLI dépend de swift-argument-parser pour le parsing des arguments.

Ajoutez le package à votre Package.swift :

Puis ajoutez la dépendance à votre target :

AudioMarker est en version 0.1.0 avec toutes les fonctionnalités documentées ci-dessus. Voici ce qui est prévu pour les prochaines versions :