Argo, una app para crear chapters de Podcasting 2.0 en el Mac
Los chapters permiten dividir un episodio de podcast en diferentes secciones identificadas mediante un título y un código de tiempo. Para el oyente son una forma de conocer la estructura del programa, localizar un tema concreto y desplazarse directamente hasta él sin tener que recorrer el audio a ciegas.
No son precisamente una novedad. Yo ya utilizaba chapters cuando empecé a publicar podcasts en 2006. GarageBand permitía incorporarlos si exportaba el episodio como un archivo M4A, aunque aquello reducía bastante la compatibilidad con los reproductores de la época. En mi caso no suponía un problema importante porque prácticamente toda mi audiencia me escuchaba desde un iPod o un Mac.
Los chapters también pueden incorporarse dentro de un MP3 mediante sus etiquetas ID3. Sin embargo, tanto en el MP3 como en el M4A existe una limitación evidente: la información queda incrustada dentro del propio archivo de audio. Si hay que corregir un título, cambiar un enlace o añadir un capítulo, es necesario modificar y sustituir el archivo.
Podcasting 2.0 propone un planteamiento diferente. Los chapters se guardan en un pequeño archivo JSON independiente, que se publica en Internet y se enlaza desde el feed RSS del episodio. Los reproductores compatibles consultan ese archivo y muestran sus títulos, códigos de tiempo, enlaces e imágenes.
Separar los chapters del audio permite modificarlos después de publicar el episodio sin tener que volver a exportar ni subir el MP3. También facilita su uso en reproductores web, que normalmente no tienen acceso a las etiquetas internas del archivo, y evita aumentar el tamaño del audio al incorporar imágenes.
El concepto es sencillo. La preparación del archivo, no tanto.
Una herramienta para generar el chapters.json
Para publicar chapters de Podcasting 2.0 hay que crear un archivo con una estructura determinada. Cada capítulo debe incluir, como mínimo, el momento en el que comienza y su título. Opcionalmente puede tener también una dirección web o una imagen asociada.
El archivo no es especialmente complejo, pero escribir JSON a mano resulta incómodo y facilita la aparición de errores. Además, mi proceso no terminaba al generar el archivo: después tenía que nombrarlo correctamente, preparar las imágenes, subirlo todo al servidor y comprobar que las direcciones incluidas eran las adecuadas.
Para resolver ese proceso he creado Argo, una aplicación para macOS destinada específicamente a generar archivos de chapters compatibles con Podcasting 2.0: recoge la información de los capítulos, la convierte en un archivo JSON válido y ayudar a publicarlo.
Tres formas de introducir los capítulos
Los chapters se pueden escribir directamente en Argo, indicando el código de tiempo y el título de cada uno. La aplicación los presenta mediante tarjetas editables que se pueden corregir y reordenar. También es posible añadir a cada capítulo un enlace o una imagen.
La segunda opción consiste en abrir un archivo JSON existente. Esto permite recuperar los chapters de un episodio anterior, corregirlos o utilizarlos como punto de partida para uno nuevo.
La tercera es la que más agiliza mi proceso: importar los capítulos desde una captura de pantalla.
Muchas aplicaciones de edición de audio, documentos de trabajo y sistemas de notas ya muestran una lista con los códigos de tiempo y los títulos de las secciones. En lugar de volver a escribirlos, puedo hacer una captura y arrastrarla sobre Argo. La aplicación utiliza el reconocimiento de texto de macOS para detectar los tiempos y los títulos y convertirlos en capítulos editables.
Este reconocimiento se realiza íntegramente en el Mac. La captura no se envía a ningún servicio externo ni necesita pasar por una nube de procesamiento.
Edición y validación
Una vez introducidos los capítulos, Argo permite revisar individualmente los títulos y los códigos de tiempo, cambiar su orden y añadir los elementos opcionales.
La aplicación muestra además una vista previa del JSON mientras trabajo. De esta manera puedo ver la estructura exacta del archivo que se va a generar sin tener que abrirlo después en un editor de texto.
Antes de exportarlo, Argo comprueba que el resultado se ajusta al formato de chapters de Podcasting 2.0. Si encuentra algún problema, lo señala antes de guardar o publicar el archivo.
El resultado es un chapters.json que puede ser utilizado por cualquier alojamiento o feed que admita la etiqueta de capítulos de Podcasting 2.0.
Imágenes y enlaces para cada sección
Los capítulos pueden limitarse a un título y un momento del episodio, pero el formato permite añadir también una dirección web y una imagen específica.
El enlace puede dirigir al oyente hacia una página, un artículo, un producto o cualquier recurso relacionado con la sección que está escuchando. La imagen permite que la carátula mostrada por el reproductor cambie conforme avanza el episodio.
Argo permite arrastrar una imagen sobre un capítulo. La aplicación la renombra utilizando el identificador del episodio y prepara su dirección para incorporarla al campo correspondiente del JSON.
Esto recupera, mediante un estándar abierto, parte de la experiencia que ya ofrecían los podcasts mejorados de GarageBand: capítulos acompañados de títulos, imágenes y enlaces. La diferencia es que ahora esos elementos no quedan encerrados dentro de un archivo M4A ni dependen exclusivamente del ecosistema de Apple.
Publicación por FTP y SFTP
Generar el JSON es solo una parte del trabajo. El archivo tiene que estar alojado en una dirección pública para que los reproductores puedan consultarlo.
Argo permite guardar una configuración distinta para cada podcast y subir directamente el archivo JSON y sus imágenes mediante FTP o SFTP. De esta manera no hace falta salir de la aplicación para completar la publicación.
Los datos de acceso no se almacenan dentro de Argo. Las contraseñas se guardan en el Llavero de macOS y solo se recuperan cuando es necesario establecer la conexión con el servidor.
Quien prefiera encargarse manualmente de la subida puede limitarse a exportar el archivo y publicarlo mediante cualquier otro sistema.
Una aplicación local y gratuita
Argo es una aplicación nativa para macOS, desarrollada con SwiftUI y compatible tanto con los Mac con procesadores Apple Silicon como con los modelos Intel. Requiere macOS 13 Ventura o posterior y se adapta automáticamente a los modos claro y oscuro del sistema.
La aplicación es gratuita, no requiere crear una cuenta y no incorpora telemetría. La edición y el reconocimiento de las capturas se realizan localmente. Solo se establece una conexión externa cuando el usuario decide subir el JSON o las imágenes a su propio servidor.
Argo se distribuye directamente, fuera de la Mac App Store, y dispone de un sistema de actualizaciones automáticas.
Del episodio al JSON
Argo nace de mi propio proceso de publicación. Necesitaba una manera más rápida y menos propensa a errores de transformar una lista de tiempos y títulos en un archivo de chapters, añadir las imágenes correspondientes y subir el resultado a su destino.
En lugar de construir una aplicación generalista, he preferido concentrarla en esa tarea concreta. Introducir los capítulos, revisarlos y obtener un JSON válido debería ser una parte menor de la publicación de un podcast, no otro proceso técnico que haya que aprender y repetir cada semana.
Argo se puede descargar gratuitamente desde getargo.app.
