EasyPodcast-Benutzerhandbuch

Mit EasyPodcast verwaltest du einen oder mehrere Podcasts im Browser. Für jeden Podcast werden automatisch eine Website, ein RSS-Feed und eine Sitemap veröffentlicht. Dieses Handbuch beschreibt den täglichen Gebrauch nach der Installation.

Hinweise zur Installation und zu technischen Voraussetzungen findest du in der README.

1. Grundlagen

EasyPodcast hat zwei Bereiche:

• Öffentliche Website: Startseite, veröffentlichte Folgen, Informationsseiten, Suche und Links zu sozialen Netzwerken.
• Adminbereich: Podcast-Einstellungen, neue Folgen, Statistiken und Wartung.

Eine einzelne Podcast-Folge wird im spanischen Panel als capítulo bezeichnet. Sie kann folgende Zustände haben:

• draft: Entwurf, weder auf der Website noch im Feed sichtbar. Ein Titel genügt zum Speichern; den Rest kannst du später ergänzen.
• scheduled: geplant; wird zum angegebenen Datum und Zeitpunkt veröffentlicht.
• published: veröffentlicht; auf der Website und im RSS-Feed sichtbar.

Geplante Veröffentlichungen benötigen keinen Cronjob. Nach Erreichen des Zeitpunkts veröffentlicht EasyPodcast ausstehende Folgen beim nächsten Besuch der Website oder des Adminbereichs. Maßgeblich ist die in PHP eingestellte Ortszeit.

2. Erste Anmeldung

1. Öffne https://deine-domain.de/admin.php.
2. Falls noch kein Administrator existiert, gib einen Benutzernamen und ein Passwort ein und wiederhole das Passwort zur Bestätigung.
3. Klicke auf Benutzer erstellen und anmelden.
4. Öffne Podcast und vervollständige die Kanaldaten vor der ersten Veröffentlichung.

Später kannst du dich mit Benutzername oder E-Mail-Adresse anmelden. Nutze Abmelden, besonders an gemeinsam verwendeten Computern.

3. Podcast einrichten

Öffne Verwaltung > Podcast. Diese Angaben werden für Website und RSS-Feed verwendet.

Grunddaten

• Titel: öffentlicher Podcast-Name.
• Haupt-URL: öffentliche Installationsadresse, etwa https://podcast.beispiel.de.
• Beschreibung: allgemeine Vorstellung der Sendung.
• Sprache: im RSS-Feed angegebene Sprache.
• Sprache des Adminbereichs: Sprache der Verwaltung und der öffentlichen Seiten.
• Autor, Eigentümer und E-Mail: redaktionelle Angaben im Feed.
• Kategorien: bis zu drei mit Apple Podcasts kompatible Kategorien.
• Explizit: ob der Podcast allgemein explizite Inhalte enthält.
• iTunes-Typ: episodischer oder fortlaufender Podcast.
• Copyright: rechtlicher Text im Feed.

Veröffentlichung und Darstellung

• Anzahl der RSS-Feed-Einträge: begrenzt die Folgen im Feed; 0 bedeutet unbegrenzt.
• Anzahl der Startseiten-Einträge: Folgen pro Seite.
• ID3-Metadaten schreiben: ergänzt beim Hochladen Titel, Künstler, Album, Datum, Kommentar und Titelnummer im MP3.
• Podcast-Bild: quadratisches Cover als URL oder vom Gerät hochgeladen.
• Hero-Bild: optionales breites Kopfbereichsbild. Hochgeladene Bilder werden automatisch zugeschnitten und optimiert.
• Darstellung: wähle im Hauptbereich das Design und ob es dem hellen oder dunklen Systemmodus folgt.

Klicke auf Podcast speichern. Öffentliche Änderungen leeren automatisch den Cache und erstellen Feed und Sitemap bei Bedarf neu.

4. Eine Folge veröffentlichen

Öffne Verwaltung > Hinzufügen.

Empfohlener Ablauf

1. Gib den Titel ein.
2. Behalte während der Vorbereitung draft bei.
3. Ergänze eine Kurzbeschreibung für die Startseite und den vollständigen Inhalt für Folgenseite und Feed.
4. Füge Audio per URL, Datei-Upload oder Mikrofonaufnahme hinzu.
5. Prüfe Bild, Autor, explizite Inhalte, Staffel, Folgennummer und Typ.
6. Wähle published zur sofortigen Veröffentlichung oder scheduled für einen späteren Zeitpunkt.
7. Klicke auf Folge speichern.
8. Prüfe die Vorschau und die öffentliche Startseite.

Wichtige Felder

• GUID: eindeutige Kennung für RSS-Reader; wird erzeugt, wenn das Feld leer bleibt.
• Folgen-URL: wird aus dem Titel erzeugt. Du kannst auch URL erzeugen nutzen oder eine gültige URL angeben.
• Beschreibung (nur Text): optionaler Auszug mit höchstens 4.000 Zeichen; ersetzt auf der Startseite den vollständigen Inhalt, sofern vorhanden.
• Inhalt: vollständiger Text im visuellen Editor; höchstens 10.000 Zeichen einschließlich HTML-Tags.
• Veröffentlichungsdatum: bei sofortiger Veröffentlichung ohne Datum gilt das aktuelle Datum; bei geplanten Folgen ist es Pflicht.
• Audio: beim Hochladen werden URL, MIME-Typ und Größe ergänzt. Prüfe diese Daten bei externen URLs manuell.
• Dauer: Format HH:MM:SS. Ohne Angabe versucht EasyPodcast, sie aus einer lokalen Audiodatei zu ermitteln.
• Explizit: übernimmt die allgemeine Einstellung oder wird für die Folge festgelegt.
• Typ: full für normale Folgen, trailer für Vorschauen und bonus für Zusatzinhalte.
• Bild und Autor: leere Felder übernehmen die Podcast-Standardwerte.

Veröffentlichen oder Planen erfordert Inhalt und gültige Audiodaten. Ein Entwurf benötigt nur einen Titel.

Im Browser aufnehmen

1. Klappe Vom Mikrofon aufnehmen auf.
2. Erlaube den Mikrofonzugriff.
3. Klicke auf Aufnehmen, am Ende auf Stoppen.
4. Prüfe die Aufnahme mit Aufnahme anhören.
5. Klicke auf Diese Aufnahme verwenden und warte auf die Upload-Bestätigung.
6. Speichere die Folge.

Schließe die Seite nicht, während die Aufnahme kodiert oder hochgeladen wird.

MP3-Metadaten

Bei aktivierter automatischer ID3-Ausgabe werden Metadaten beim Hochladen aktualisiert. Bei vorhandenen Folgen kannst du sie mit Metadaten des aktuellen MP3 aktualisieren erneut schreiben.

5. Folgen verwalten

Öffne Verwaltung > Folgen. Veröffentlichte Folgen, Entwürfe und geplante Folgen sind getrennt aufgeführt.

Du kannst:

• nach Titel oder Inhalt suchen;
• eine Folge bearbeiten;
• auch Entwürfe und geplante Folgen in der Vorschau öffnen;
• eine Folge löschen.

Beim Löschen wird der Datenbankeintrag entfernt. Audio und Bild werden nur vom Server gelöscht, wenn keine andere Folge und kein Podcast-Cover sie verwendet. Erstelle trotzdem vor größeren Aufräumarbeiten eine Sicherung.

Änderungen an veröffentlichten Folgen aktualisieren Feed, Sitemap und öffentlichen Cache.

6. Einen anderen Podcast importieren

RSS-Feed importieren kopiert Folgen aus einem externen Feed und lädt Audio und Bilder lokal herunter.

1. Öffne Verwaltung > RSS-Feed importieren.
2. Füge die vollständige URL ein und klicke auf Vorschau.
3. Vergleiche vorhandene Metadaten mit dem Feed und markiere nur zu überschreibende Felder.
4. Wähle die zu importierenden Folgen.
5. Lasse den Import doppelter GUIDs deaktiviert, sofern du Duplikate nicht ausdrücklich brauchst.
6. Klicke auf Import starten und halte die Seite bis zum Abschluss offen.
7. Prüfe importierte Folgen, Startseite und Feed.

Die Haupt-URL wird nicht durch die des importierten Feeds ersetzt. Große Importe können Minuten dauern und hängen von Upload-, Speicher- und Laufzeitgrenzen des Servers ab.

7. Seiten und soziale Netzwerke

Statische Seiten

Erstelle unter Verwaltung > Seiten Inhalte wie „Über uns“, „Kontakt“ oder „Impressum“.

1. Klicke auf Seite hinzufügen.
2. Gib Titel und Inhalt ein.
3. Prüfe den Slug: nur Kleinbuchstaben, Zahlen und Bindestriche.
4. Wähle draft oder published.
5. Wähle optional eine übergeordnete Seite für eine Hierarchie mit zwei Ebenen.
6. Lege die Reihenfolge fest; kleinere Zahlen erscheinen zuerst.
7. Speichere und prüfe die Vorschau.

Soziale Netzwerke

Unter Verwaltung > Soziale Netzwerke kannst du vollständige URLs für Blog, LinkedIn, Mastodon, X, Pixelfed, Instagram, YouTube, GitHub und Bluesky hinzufügen. Nur eingerichtete Netzwerke erscheinen als Symbole im öffentlichen Kopfbereich.

8. Statistiken ansehen

Öffne Verwaltung > Statistiken für:

• veröffentlichte Folgen, Entwürfe und gespeicherte Gesamtzahl;
• Gesamtgröße der Audiodateien laut Datenbank;
• zuletzt veröffentlichte Folge;
• Status, Seitenzahl und Größe des Caches;
• Downloads und Wiedergaben.

Die Aktivität gliedert sich in:

• Täglich: Ereignisse aus bis zu sieben Tagen mit Datum, Folge, Typ und IP.
• Monatlich: Monatssummen, nach Jahr filterbar.
• Jährlich: Jahressummen.
• Übersicht: Downloads und Wiedergaben je Folge.

Klicke auf Tabellenüberschriften zum Sortieren. HEAD-Prüfanfragen von Readern zählen nicht als Downloads.

9. Sicherungen

Öffne Verwaltung > Backups. Datenbank und Mediendateien werden getrennt gesichert.

Vollständige Sicherung erstellen

1. Klicke auf Datenbank exportieren und speichere die SQLite-Datei.
2. Lade alle Teile unter Bilder exportieren herunter.
3. Lade alle Teile unter Audio exportieren herunter.
4. Überschreitet eine Datei die ZIP-Grenze, lade sie über den angezeigten Link manuell herunter.
5. Bewahre alle Dateien gemeinsam mit Datum und EasyPodcast-Version auf.

ZIP-Dateien werden in Teile bis 127 MB aufgeteilt. Erzeugte Bilder sind ausgenommen, da sie neu erstellt werden können.

Wiederherstellen

• Datenbank importieren stellt Inhalte und Einstellungen aus einer gültigen SQLite-Datei wieder her. Sichere zuerst den aktuellen Stand: die aktive Datenbank wird ersetzt.
• Dateien importieren akzeptiert ein oder mehrere ZIP-Archive und einzelne Audiodateien. Lade alle benötigten Teile hoch.

Prüfe danach Startseite, mehrere Folgen, Feed und Bilder. Fehlen Vorschaubilder, nutze Cache > Bilder neu erzeugen.

10. Cache und Wartung

Cache

Der öffentliche Cache speichert das HTML von Startseite und Folgen sowie Feed und Sitemap für schnellere Antworten.

• Öffentlichen Cache aktivieren: im Produktivbetrieb empfohlen.
• Webcache leeren: entfernt nur zwischengespeicherte HTML-Antworten; weitere Besuche erzeugen sie neu.
• Bilder neu erzeugen: erstellt Varianten mit 80, 144 und 220 Pixeln für Podcast- und Folgenbilder.

Normale öffentliche Änderungen machen den Cache bereits automatisch ungültig. Leere ihn manuell, wenn nach Wiederherstellung oder Störung alte Inhalte angezeigt werden.

.htaccess neu erzeugen

Erzeugte .htaccess stellt die Datei mit EasyPodcast-Standardregeln wieder her. Dabei werden eigene Regeln entfernt und die IP-Sperre für admin.php deaktiviert. Nutze dies nur, um zur ursprünglichen Konfiguration zurückzukehren.

Verwaiste Dateien

Bei Multipodcast kann der globale Administrator mit Aufräumen Audio und Bilder suchen, die keine Folge verwendet. Prüfe die Auswahl vor Auswahl löschen: das Löschen lässt sich nicht rückgängig machen.

11. Benutzer, Passwort und 2FA

Passwort ändern

Öffne Passwort und gib das aktuelle und neue Passwort gemäß den Hinweisen ein. Erstelle in Multipodcast separate Benutzer, statt Konten zu teilen.

Zwei-Faktor-Authentifizierung aktivieren

1. Öffne 2FA und klicke auf 2FA aktivieren.
2. Scanne den QR-Code mit einer TOTP-App wie Google Authenticator oder Aegis oder gib den Schlüssel manuell ein.
3. Bestätige mit dem sechsstelligen Code.
4. Bewahre die acht Wiederherstellungscodes sofort sicher auf.

Jeder Wiederherstellungscode ist nur einmal verwendbar. Neue Codes oder die Deaktivierung von 2FA bestätigst du mit deinem Passwort. Bei der Anmeldung kannst du ein Gerät sieben Tage lang merken lassen.

Zugriff auf admin.php nach IP beschränken

Der globale Administrator kann unter Multipodcast > Sicherheit nur bestimmte IPv4-, IPv6-Adressen oder CIDR-Bereiche zulassen. Die Sperre ist standardmäßig deaktiviert und muss ausdrücklich in zwei Schritten aktiviert werden. Trage vorher immer deine Verwaltungs-IP ein: eine falsche Einstellung kann dich aussperren.

Die Aktivierung ist freiwillig und liegt in der Verantwortung des Benutzers. Lies nach Sperre aktivieren den roten Hinweis und klicke erst nach Prüfung der Liste auf Ich bin sicher.

Zugriff nach versehentlichem Aussperren wiederherstellen

Wenn admin.php nicht mehr erreichbar ist, greife per SSH, SFTP oder Hosting-Dateimanager auf den Server zu. Öffne .htaccess im EasyPodcast-Hauptverzeichnis und entferne ausschließlich den vollständigen Block von # BEGIN bis # END, einschließlich beider Zeilen:

# 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

Speichere ohne andere Regeln zu verändern und öffne admin.php erneut. Das Entfernen des Blocks deaktiviert die IP-Beschränkung. Mehrere Allow from-Zeilen musst du ebenfalls vollständig als Teil dieses Blocks entfernen.

Podcast-Benutzer

In Multipodcast erstellt der globale Administrator unter Benutzer Konten und weist ihnen Podcasts zu. Eingeschränkte Benutzer sehen und verwalten nur zugewiesene Podcasts, ohne Zugriff auf globale Werkzeuge.

Du kannst ein Konto vorübergehend deaktivieren, Podcast-Zuweisungen ändern oder ein neues Passwort setzen. Beim Löschen werden auch seine API-Tokens gelöscht.

12. Mehrere Podcasts verwalten

Multipodcast betreibt mehrere Kanäle in einer Installation und trennt Folgen, Seiten, soziale Netzwerke, Statistiken und Tokens.

Aktivieren

1. Öffne Multipodcast > Multipodcast-Einstellungen.
2. Wähle Multipodcast aktivieren.
3. Wähle das Verzeichnis des bestehenden Podcasts, etwa mein-podcast: nur Kleinbuchstaben, Zahlen und Bindestriche.
4. Entscheide, ob die Website-Wurzel eine Übersicht aller Podcasts oder die Startseite eines ausgewählten Podcasts zeigt.
5. Stelle für die Übersicht Sprache, Design, Titel, Untertitel und Kopfbereichsbild ein.
6. Speichere die Einstellungen.

Mediendateien behalten bei der Aktivierung ihre URLs.

Podcasts erstellen und verwalten

1. Öffne Podcasts.
2. Gib einen Titel und ein freies Verzeichnis ein.
3. Klicke auf Podcast erstellen.
4. Nutze Podcast verwalten, um Einstellungen zu vervollständigen und Inhalte zu veröffentlichen.

Die obere Auswahl wechselt zwischen globalem Bereich und verfügbaren Podcasts. Jeder hat eigene Pfade unter https://deine-domain.de/verzeichnis/.

Du kannst einen Podcast als Hauptpodcast markieren. Dieser bleibt beim Deaktivieren von Multipodcast erhalten.

Vorgänge, die URLs ändern oder Inhalte löschen

• Verzeichnis ändern ändert öffentliche URLs von Podcast, Seiten, Feed und Folgen. Tu dies nur, wenn du externe Links aktualisieren kannst.
• Podcast löschen erstellt zunächst ein ZIP-Backup und löscht dann Podcast, Folgen, Statistiken und ausschließlich zugehörige Medien. Bestätige mit dem Titel. Lade das ZIP herunter und bewahre es auf.
• Multipodcast deaktivieren behält den Hauptpodcast, sichert die übrigen Podcasts und löscht sie anschließend. Erforderlich sind eine ausdrückliche Bestätigung und der genaue Titel des Hauptpodcasts.

13. API und Automatisierung

Der Bereich API verbindet EasyPodcast mit Skripten, n8n oder anderen Anwendungen.

1. Öffne API Tokens.
2. Gib einen erkennbaren Namen und optional ein Ablaufdatum ein.
3. Wähle den Geltungsbereich: content für übliche Inhaltsautomatisierungen, admin nur für sensible Verwaltungsaufgaben.
4. Erzeuge und kopiere das Token sofort: es wird nicht erneut vollständig angezeigt.
5. Öffne API-Dokumentation für Endpunkte und Beispiele.

Widerrufe ungenutzte oder möglicherweise offengelegte Tokens sofort. Eingeschränkte Benutzer können nur ihre zugewiesenen Podcasts bearbeiten.

14. EasyPodcast aktualisieren

1. Sichere mindestens die Datenbank, möglichst auch die Medien.
2. Öffne Aktualisieren.
3. Vergleiche installierte und neueste verfügbare Version.
4. Klicke bei einer neuen Version auf Auf v… aktualisieren und warte bis zum Abschluss.
5. Lies die Neuerungen und prüfe Startseite, Adminbereich, eine Folge, Feed und Sitemap.

Der Updater lädt von GitHub Releases, prüft die Integrität und ersetzt Anwendungsdateien. Er verändert Datenbank, Audio und Bilder nicht direkt; notwendige Migrationen laufen automatisch beim Laden der Anwendung.

15. Was EasyPodcast veröffentlicht

Übliche Pfade bei einem einzelnen Podcast:

In Multipodcast nutzt jeder Kanal sein Verzeichnis, etwa /mein-podcast/, /mein-podcast/feed.xml und /mein-podcast/sitemap.xml. Die Wurzel zeigt die Gesamtübersicht oder den hervorgehobenen Podcast.

Gib zur Anmeldung bei einer Verbreitungsplattform die öffentliche URL der passenden feed.xml an. Prüfe nach der Veröffentlichung, ob die Folge sowohl auf der Website als auch im Feed erscheint.

16. Empfohlene Routine

Vor der Veröffentlichung

• Prüfe Titel, Kurzbeschreibung, Inhalt, Audio und Bild.
• Höre Anfang und Ende der Datei an.
• Prüfe die Einstellung für explizite Inhalte und die Nummerierung.
• Behalte draft, bis alles fertig ist.

Nach der Veröffentlichung

• Öffne Startseite und Folgenseite.
• Spiele das Audio ab oder lade es herunter.
• Prüfe feed.xml.
• Prüfe Titel, Bild und Beschreibung beim Teilen der URL.

Regelmäßige Wartung

• Exportiere die Datenbank häufig und vor jedem Update.
• Bewahre regelmäßige Audio- und Bildsicherungen außerhalb des Servers auf.
• Prüfe Statistiken und Speicherverbrauch.
• Widerrufe Tokens und deaktiviere Benutzer ohne weiteren Zugriffsbedarf.
• Suche nach Updates und sichere vor dem Anwenden.

17. Häufige Probleme

Eine Folge ist nicht öffentlich sichtbar

• Prüfe den Zustand published.
• Bei geplanter Veröffentlichung prüfe Datum, Zeit und Server-Zeitzone.
• Besuche die Website, um die Veröffentlichung auszulösen.
• Leere bei anhaltenden Problemen den Webcache.

Audio wird nicht abgespielt

• Prüfe, ob die Audio-URL erreichbar ist.
• Prüfe MIME-Typ, Größe und Dateiformat.
• Bei Upload über den Adminbereich: warte vor dem Speichern auf dessen Abschluss.

Der Feed zeigt eine Änderung nicht

• Speichere Podcast oder Folge erneut.
• Vergleiche feed.php und feed.xml.
• Leere den Webcache.
• Prüfe Schreibrechte für feed.xml und cache/.

Ein Bild oder Vorschaubild fehlt

• Prüfe die ursprüngliche URL.
• Öffne Cache > Bilder neu erzeugen.
• Prüfe Schreibrechte für images/ und images/generated/.

Ein Feed lässt sich nicht importieren

• Prüfe, ob die URL öffentlich ist und gültiges RSS liefert.
• Prüfe, ob PHPs cURL-Erweiterung aktiviert ist.
• Versuche bei strengen Servergrenzen weniger Folgen.
• Schließe den Tab nicht während des Downloads.

Inhalte lassen sich nicht speichern oder hochladen

Meist liegt es an PHP-Grenzen oder Serverrechten. Der Hosting-Administrator muss maximale Upload-Größe, Laufzeit und Schreibrechte für podcast.sqlite, audios/, images/, cache/, feed.xml und favicon.ico prüfen.