Manual de usuario de EasyPodcast

EasyPodcast permite xestionar un ou varios podcasts desde o navegador e publica automaticamente unha web, un feed RSS e un sitemap para cada podcast. Este manual explica o uso diario da aplicación unha vez instalada.

Para instalar EasyPodcast ou consultar os requisitos técnicos, consulta o README.

1. Conceptos básicos

EasyPodcast ten dúas zonas:

• Web pública: mostra a portada, os capítulos publicados, as páxinas informativas, o buscador e as ligazóns sociais.
• Panel de administración: permite configurar o podcast, crear capítulos, consultar estatísticas e realizar mantemento.

No panel, capítulo refírese a cada episodio do podcast. Os estados posibles son:

• draft: borrador. Non aparece na web nin no feed. Pode gardarse só cun título e completarse máis tarde.
• scheduled: programado. Publicarase na data e hora indicadas.
• published: publicado. Aparece na web pública e no feed RSS.

A publicación programada non necesita cron. Cando chega a data, EasyPodcast publica os capítulos pendentes na seguinte visita á web ou ao panel. Utiliza a hora local configurada en PHP.

2. Primeiro acceso

1. Abre https://teu-dominio.com/admin.php.
2. Se aínda non existe un administrador, introduce un nome de usuario e un contrasinal e repíteo para confirmar.
3. Preme Crear usuario e entrar.
4. Entra en Podcast e completa os datos básicos da canle antes de publicar o primeiro capítulo.

Nos accesos posteriores podes identificarte co nome de usuario ou co correo electrónico. Usa Saír para pechar a sesión, especialmente nun equipo compartido.

3. Configurar o podcast

Abre Administración > Podcast. Os datos úsanse na web e no feed RSS.

Datos principais

• Título: nome público do podcast.
• URL principal: enderezo público da instalación, por exemplo https://podcast.exemplo.com.
• Descrición: presentación xeral do programa.
• Idioma: idioma declarado no feed RSS.
• Idioma do panel: idioma da interface administrativa e das páxinas públicas.
• Autor, propietario e correo: información editorial incluída no feed.
• Categorías: ata tres categorías compatibles con Apple Podcasts.
• Explícito: indica se o contido xeral é explícito.
• Tipo iTunes: define se o podcast é episódico ou serial.
• Copyright: texto legal mostrado no feed.

Publicación e aparencia

• Cantidade de elementos do feed RSS: limita os capítulos do feed; 0 significa sen límite.
• Cantidade de elementos da portada: capítulos mostrados por páxina.
• Escribir metadatos ID3: engade ao MP3 título, artista, álbum, data, comentario e número de pista ao subilo.
• Imaxe do podcast: portada cadrada, indicada por URL ou subida desde o dispositivo.
• Imaxe do hero: cabeceira panorámica opcional. As imaxes subidas recórtanse e optimízanse automaticamente.
• Aparencia: escolle o tema no panel principal e se seguirá a preferencia clara ou escura do sistema.

Preme Gardar podcast. Os cambios públicos baleiran automaticamente a caché e rexeneran o feed e o sitemap cando corresponde.

4. Publicar un capítulo

Abre Administración > Engadir.

Fluxo recomendado

1. Escribe o título.
2. Mantén draft mentres preparas o contido.
3. Engade unha descrición breve para a portada e o contido completo para a páxina do capítulo e o feed.
4. Engade o audio por URL, subindo un ficheiro ou gravándoo co micrófono.
5. Revisa imaxe, autor, contido explícito, tempada, número e tipo de episodio.
6. Escolle published para publicar agora ou scheduled para unha data futura.
7. Preme Gardar capítulo.
8. Comproba a Vista previa e a portada pública.

Campos importantes

• GUID: identificador único usado polos lectores RSS; EasyPodcast xérao se queda baleiro.
• URL do capítulo: xérase desde o título. Tamén podes usar Xerar URL ou indicar unha URL válida.
• Descrición (só texto): extracto opcional de ata 4.000 caracteres; substitúe o contido completo na portada se existe.
• Contido: texto completo no editor visual; ata 10.000 caracteres, incluídas as etiquetas HTML.
• Data de publicación: se publicas sen data, úsase a actual; é obrigatoria nos programados.
• Audio: a subida completa URL, MIME e tamaño. Cunha URL externa, revisa os datos manualmente.
• Duración: formato HH:MM:SS. Se falta, EasyPodcast intenta calculala desde un audio local.
• Explícito: pode herdar a configuración xeral ou definirse para o capítulo.
• Tipo: full para un episodio normal, trailer para un avance e bonus para contido extra.
• Imaxe e autor: se quedan baleiros, úsanse os valores xerais do podcast.

Publicar ou programar require contido e datos de audio válidos. Un borrador só necesita título.

Gravar desde o navegador

1. Desprega Gravar desde micrófono.
2. Autoriza o acceso ao micrófono.
3. Preme Gravar e, ao rematar, Parar.
4. Comproba con Escoitar gravación.
5. Preme Usar esta gravación e agarda a confirmación da subida.
6. Garda o capítulo.

Non peches a páxina mentres se codifica ou sobe a gravación.

Metadatos do MP3

Se activaches a escritura automática ID3, actualízanse os metadatos ao subir o audio. Nun capítulo existente, usa Actualizar metadatos do MP3 actual para reescribilos.

5. Xestionar capítulos

Abre Administración > Capítulos. Sepáranse publicados, borradores e programados.

Podes:

• buscar por título ou contido;
• editar un capítulo;
• abrir unha vista previa, mesmo de borradores ou programados;
• borrar un capítulo.

Ao borrar elimínase o rexistro da base de datos. O audio e a imaxe só se borran do servidor se ningún outro capítulo nin a portada do podcast os utiliza. Aínda así, fai unha copia de seguridade antes dunha limpeza importante.

Modificar un capítulo publicado actualiza o feed, o sitemap e a caché pública.

6. Importar outro podcast

Importar feed RSS copia capítulos dun feed externo e descarga localmente audios e imaxes.

1. Abre Administración > Importar feed RSS.
2. Pega a URL completa e preme Vista previa.
3. Compara os metadatos actuais cos do feed e marca só os campos que queiras substituír.
4. Selecciona os capítulos para importar.
5. Deixa desmarcada a importación de GUID duplicados, salvo que os necesites expresamente.
6. Preme Iniciar importación e non peches a páxina ata rematar.
7. Revisa capítulos importados, portada e feed.

A URL principal non se substitúe pola do feed importado. As importacións grandes poden tardar minutos e dependen dos límites de subida, memoria e tempo de execución do servidor.

7. Crear páxinas e engadir redes sociais

Páxinas estáticas

En Administración > Páxinas, crea contido como «Acerca de», «Contacto» ou «Aviso legal».

1. Preme Engadir páxina.
2. Escribe título e contido.
3. Revisa o slug: só letras minúsculas, números e guións.
4. Escolle draft ou published.
5. Opcionalmente, selecciona unha páxina pai para unha xerarquía de dous niveis.
6. Usa Orde para a posición; os números menores aparecen antes.
7. Garda e comproba a vista previa.

Redes sociais

En Administración > Redes sociais, engade as URL completas de blog, LinkedIn, Mastodon, X, Pixelfed, Instagram, YouTube, GitHub e Bluesky. Só as redes configuradas aparecen como iconas na cabeceira pública.

8. Consultar estatísticas

Abre Administración > Estatísticas para consultar:

• capítulos publicados, borradores e total almacenado;
• tamaño total dos audios segundo a base de datos;
• último capítulo publicado;
• estado, número de páxinas e tamaño da caché;
• descargas e reproducións.

A actividade organízase en:

• Diario: eventos recentes de ata sete días, con data, capítulo, tipo e IP.
• Mensual: acumulados mensuais, con filtro por ano.
• Anual: acumulados anuais.
• Resumo: descargas e reproducións por capítulo.

Preme as cabeceiras para ordenar as táboas. As peticións de comprobación HEAD dos lectores non contan como descargas.

9. Copias de seguridade

Abre Administración > Backups. Sepáranse a copia da base de datos e a dos ficheiros multimedia.

Crear unha copia completa

1. Preme Exportar base de datos e garda o SQLite.
2. Descarga todas as partes de Exportar imaxes.
3. Descarga todas as partes de Exportar audios.
4. Se un ficheiro supera o límite ZIP, descárgao manualmente coa ligazón mostrada.
5. Garda todos os ficheiros xuntos, coa data e a versión de EasyPodcast.

Os ZIP divídense en partes de ata 127 MB. Exclúense as imaxes xeradas porque poden rexenerarse.

Restaurar

• Importar base de datos restaura contido e configuración desde un SQLite válido. Copia antes o estado actual: a restauración substitúe a base en uso.
• Importar ficheiros admite un ou varios ZIP e audios soltos. Sobe todas as partes necesarias para recuperar os medios.

Despois revisa portada, varios capítulos, feed e imaxes. Se falta unha miniatura, usa Caché > Rexenerar imaxes.

10. Caché e mantemento

Caché

A caché pública garda o HTML da portada e dos capítulos, o feed e o sitemap para responder máis rápido.

• Habilitar caché pública: recomendado en produción.
• Borrar caché web: elimina só as respostas HTML almacenadas; as visitas volven xerarlas.
• Rexenerar imaxes: recrea as variantes de 80, 144 e 220 píxeles das imaxes do podcast e dos capítulos.

Os cambios públicos normais xa invalidan a caché automaticamente. Bórraa manualmente se ves contido antigo tras unha restauración ou incidencia.

Rexenerar .htaccess

.htaccess xerado restaura o ficheiro coas regras predeterminadas de EasyPodcast. Elimina regras personalizadas e deshabilita o bloqueo por IP de admin.php; úsao só para volver á configuración orixinal.

Ficheiros orfos

En Multipodcast, o administrador global dispón de Limpar, que busca audios e imaxes non usados por ningún capítulo. Revisa a selección antes de Borrar seleccionados: non se pode desfacer.

11. Usuarios, contrasinal e 2FA

Cambiar o contrasinal

Abre Contrasinal, introduce o actual e o novo seguindo as indicacións. En Multipodcast, crea usuarios independentes en vez de compartir contas.

Activar a autenticación en dous pasos

1. Abre 2FA e preme Activar 2FA.
2. Escanea o QR cunha aplicación TOTP, como Google Authenticator ou Aegis, ou introduce a clave manualmente.
3. Confirma co código de seis díxitos.
4. Garda de inmediato os oito códigos de recuperación nun lugar seguro.

Cada código só se usa unha vez. Podes rexeneralos ou desactivar 2FA confirmando co contrasinal. No acceso podes lembrar un dispositivo durante sete días.

Restrinxir o acceso a admin.php por IP

O administrador global pode abrir Multipodcast > Seguridade para permitir só certas IPv4, IPv6 ou rangos CIDR. O bloqueo está deshabilitado por defecto e actívase expresamente en dous pasos. Inclúe sempre a túa IP de administración antes de confirmar: un erro pode deixarche sen acceso.

A activación é voluntaria e responsabilidade do usuario. Despois de Habilitar bloqueo, revisa o aviso vermello e preme Estou seguro só tras comprobar a lista.

Recuperar o acceso tras bloquearte por erro

Se non podes abrir admin.php, accede aos ficheiros por SSH, SFTP ou o xestor do aloxamento. Abre .htaccess no directorio principal de EasyPodcast e elimina unicamente o bloque completo, desde # BEGIN ata # END, ambas as liñas incluídas:

# BEGIN EasyPodcast: bloqueo por IP de admin.php
# Bloqueo al admin.php
<Files "admin.php">
    Order Deny,Allow
    Deny from all
    Allow from x.x.x.x
</Files>
# END EasyPodcast: bloqueo por IP de admin.php

Garda sen modificar as demais regras e volve abrir admin.php. Retirar o bloque deshabilita a restrición por IP. Se hai varias liñas Allow from, elimínaas todas como parte do bloque.

Usuarios de podcast

En Multipodcast, o administrador global abre Usuarios para crear contas e asignar un ou varios podcasts. Un usuario limitado só ve e administra os asignados, sen acceso ás ferramentas globais.

Podes desactivar temporalmente unha conta, cambiar os seus podcasts ou asignarlle un novo contrasinal. Ao eliminala tamén se eliminan os seus tokens API.

12. Xestionar varios podcasts

Multipodcast aloxa varias canles nunha instalación, separando capítulos, páxinas, redes sociais, estatísticas e tokens.

Activalo

1. Abre Multipodcast > Configuración Multipodcast.
2. Marca Activar Multipodcast.
3. Escolle o directorio do podcast actual, como meu-podcast: só minúsculas, números e guións.
4. Decide se a raíz mostra un resumo de todos os podcasts ou a portada dun seleccionado.
5. Para o resumo, configura idioma, tema, título, subtítulo e imaxe de cabeceira.
6. Garda a configuración.

Os ficheiros multimedia conservan as URL ao activar Multipodcast.

Crear e administrar podcasts

1. Abre Podcasts.
2. Escribe un título e un directorio libre.
3. Preme Crear podcast.
4. Usa Administrar podcast para completar a configuración e publicar.

O selector superior cambia entre o panel global e os podcasts dispoñibles. Cada un ten rutas propias baixo https://teu-dominio.com/directorio/.

Podes marcar un como principal: conservarase se desactivas Multipodcast.

Operacións que cambian URL ou eliminan contido

• Cambiar directorio modifica as URL públicas do podcast, páxinas, feed e capítulos. Faino só se podes actualizar as ligazóns externas.
• Borrar podcast crea primeiro unha copia ZIP e despois elimina podcast, capítulos, estatísticas e medios exclusivos. Escribe o título para confirmar. Descarga e conserva o ZIP.
• Desactivar Multipodcast conserva o principal, crea copias dos secundarios e despois elimínaos. Esixe confirmación explícita e o título exacto do principal.

13. API e automatizacións

A sección API integra EasyPodcast con scripts, n8n ou outras aplicacións.

1. Abre API Tokens.
2. Indica un nome recoñecible e, opcionalmente, unha data de caducidade.
3. Escolle o alcance: content para automatizacións habituais de contido; admin só para operacións administrativas sensibles.
4. Xera e copia o token no momento: non volverá mostrarse completo.
5. Consulta Documentación da API para endpoints e exemplos.

Revoga inmediatamente tokens sen uso ou potencialmente expostos. Os usuarios limitados só poden operar nos podcasts asignados.

14. Actualizar EasyPodcast

1. Fai polo menos unha copia da base de datos e, preferiblemente, tamén dos medios.
2. Abre Actualizar.
3. Compara a versión instalada coa última dispoñible.
4. Se hai unha nova, preme Actualizar a v… e agarda a que remate.
5. Le as novidades e comproba portada, panel, un capítulo, feed e sitemap.

O actualizador descarga de GitHub Releases, verifica a integridade e substitúe os ficheiros da aplicación. Non modifica directamente base de datos, audios nin imaxes; as migracións necesarias aplícanse automaticamente ao cargar a aplicación.

15. Que publica EasyPodcast

Rutas habituais nunha instalación cun podcast:

En Multipodcast cada canle usa un directorio, como /meu-podcast/, /meu-podcast/feed.xml e /meu-podcast/sitemap.xml. A raíz pode mostrar o resumo global ou o podcast destacado.

Para enviar o podcast a unha plataforma, proporciona a URL pública do seu feed.xml. Tras publicar, comproba que o capítulo aparece na web e no feed.

16. Rutina recomendada

Antes de publicar

• Revisa título, descrición breve, contido, audio e imaxe.
• Escoita o principio e o final do ficheiro.
• Comproba contido explícito e numeración.
• Usa draft ata que todo estea listo.

Despois de publicar

• Abre a portada e a páxina do capítulo.
• Reproduce ou descarga o audio.
• Comproba feed.xml.
• Revisa título, imaxe e descrición ao compartir a URL.

Mantemento periódico

• Exporta a base con frecuencia e antes de cada actualización.
• Conserva copias periódicas de audios e imaxes fóra do servidor.
• Revisa estatísticas e espazo ocupado.
• Revoga tokens e desactiva usuarios que xa non necesiten acceso.
• Comproba actualizacións e fai unha copia antes de aplicalas.

17. Problemas frecuentes

Un capítulo non aparece publicamente

• Comproba o estado published.
• Se está programado, revisa data, hora e zona horaria do servidor.
• Abre a web para procesar a publicación programada.
• Borra a caché web se continúa.

O audio non se reproduce

• Comproba que a URL sexa accesible.
• Revisa MIME, tamaño e formato.
• Se o subiches desde o panel, confirma que rematou antes de gardar.

O feed non reflicte un cambio

• Garda outra vez o podcast ou capítulo.
• Compara feed.php e feed.xml.
• Borra a caché web.
• Verifica permisos de escritura en feed.xml e cache/.

Falta unha imaxe ou miniatura

• Comproba a URL orixinal.
• Abre Caché > Rexenerar imaxes.
• Verifica permisos de escritura en images/ e images/generated/.

Non se pode importar un feed

• Comproba que a URL sexa pública e devolva RSS válido.
• Verifica que PHP teña a extensión cURL habilitada.
• Proba con menos capítulos se os límites son estritos.
• Non peches a pestana durante a descarga.

Non se pode gardar ou subir contido

Normalmente débese a límites de PHP ou permisos do servidor. O administrador do aloxamento debe revisar o tamaño máximo de subida, o tempo de execución e os permisos de escritura de podcast.sqlite, audios/, images/, cache/, feed.xml e favicon.ico.