YouTube-Videos zu Podcasts umwandeln – Podsync Tutorial

Du möchtest YouTube Video Playlists in Podcasts umwandeln?

Hier ist der Guide, wie Du das am besten mit Podsync durchführen kannst.

Starten wir!

Warum brauche ich Podsync?

Podsync hilft Dir dabei, YouTube-Videos systematisch und automatisch herunterzuladen und diese sortiert in ein Podcast-Format (MP3) umzuwandeln. Die Vorteile sind …

• kein manuelles Herunterladen von neuen Folgen Deiner Serie mehr
• viele Shows sind nur als Video-Podcast verfügbar oder Du willst / brauchst die visuelle Komponente nicht
• Tracking zum Abhörstand für alle Folgen (AntennaPod)
• weiterhin verfügbar, wenn YouTube (Videos) nicht mehr verfügbar ist
• Blitz schneller Download von Deiner eigenen Cloud
• automatische Füllung Deiner Warteschlange der Podcasts mit neuen Inhalten

Was ist Podsync

Podsync ist eine Open Source Project (Golang), welches die YouTube MP4-Dateien über die YouTube-API (und anderen Plattformen) herunterlädt und zu einer MP3-Audiodatei umwandelt.

Zusätzlich verwaltet die Software die Metadaten und nutzt das Vorschaubild und die Videobeschreibungen für einen ansprechenden Podcast. Die Daten werden auf einen Server zwischen geladen, welche Du zu Hause oder in der Cloud steht.

Warum YouTube-Videos nicht direkt importieren?

YouTube unterbindet das Abgreifen von Videos systematisch.

Sie möchten wissen, wer sich das Video herunterlädt. Deshalb bietet die Google Plattform eine einheitliche Schnittstelle an, die Podsync nutzt.

Für die Nutzung der Schnittstelle braucht man einen YouTube / Google Account, um einen API-Token zu erhalten. Mit diesem Token kann man eine begrenzte Anzahl von Videos pro Tag herunterladen. Google möchte verhindern, dass sich jemand über Nacht die ganze YouTube Bibliothek abluchst.

Wie funktionieren die XMLs und MP3s?

Für Podcasts brauchen wir mehr als nur ein MP4-Video, welches wir von YouTube geladen haben. Das Audioformat braucht keine Videoinformationen und kann deshalb zu dem leichtgewichtigeren MP3-Format umgewandelt werden.

Die Metadaten von dem Webvideo landen bei Podsync formatiert in eine XML-Datei. Die Exentsible Markup Language (XML) ermöglicht es strukturiert Daten abzulegen. Das Podsync-XML definiert Titel <title>, Bilder ` und Beschreibung in ausgewählten Tags.

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
  <channel>
    <title>Pen &amp; Paper</title>
    <link>https://youtube.com/playlist?list=PLsd79E9zE98c0l29-WmyUaNA7uGdjbyc-</link>
    <description>Pen &amp; Paper (2025-02-07 11:55:13.232082 +0000 UTC)</description>
    <category>TV &amp; Film</category>
    <generator>Podsync generator (support us at https://github.com/mxpv/podsync)</generator>
    <language>en-us</language>
    <lastBuildDate>Tue, 19 May 2026 12:10:03 +0000</lastBuildDate>
    <pubDate>Fri, 07 Feb 2025 11:55:13 +0000</pubDate>
    <image>
      <url>https://i.ytimg.com/vi/-qTA9_KYHk4/hqdefault.jpg?sqp=-oaymwEXCNACELwBSFryq4qpAwkIARUAAIhCGAE=&amp;rs=AOn4CLCnR2SWXpg1vzcgVzguKxSFje_qvQ</url>
      <title>Pen &amp; Paper</title>
      <link>https://youtube.com/playlist?list=PLsd79E9zE98c0l29-WmyUaNA7uGdjbyc-</link>
    </image>
    <itunes:author>ARD Gaming</itunes:author>
...
    <item>
      <guid>-qTA9_KYHk4</guid>
      <title>Pen &amp; Paper: Letzte Beute mit Uke Bosse | Kapitel 6  - Letzte Beute</title>
      <link>https://youtube.com/watch?v=-qTA9_KYHk4</link>
      <description>...</description>
      <pubDate>Thu, 09 Apr 2026 16:00:00 +0000</pubDate>
      <enclosure url="https://podsync.xxxxx.de/ardpnp/qTA9_KYHk4.mp3" length="42059133" type="audio/mpeg"></enclosure>
...

Wie Podsync einrichten?

Für Podsync brauchen wir eine Docker Installation. Lese dazu das Docker Tutorial, um Docker zu installieren. Die Docker Rootless Version reicht aus, um den Container ohne Adminrechten auszuführen.

Die Konfigurationen Deiner Podsync Installation geht am einfachsten mit einer Docker-Compose-Datei.

services:
  podsync:
    image: ghcr.io/mxpv/podsync:nightly
    restart: always
    container_name: podsync
    volumes:
      - podsyncfiles:/app/data/
      - podsyncdatabase:/app/db/
      - /home/yourhome/podsyncconfig.toml:/app/config.toml
    ports:
      - 60001:8080

volumes:
  podsyncfiles:
  podsyncdatabase:

und starte es mit

docker compose up -f podsync.yml

Der Service startet auf dem Port 60001. Wenn Du den Service mit TLS Zertifikat usw. publizieren willst, solltest Du einen NGINX (Proxy Manager) davor schalten. Im Heimnetzwerk ist eine unverschlüsselte Verbindung nur in diesem Fall akzeptabel, weil Podsync nur öffentlich nutzbare Daten speichert.

Die Config, in der die YouTube Playlists stehen, ist die Folgende. Diese importierst Du durch das Docker Volume in den Container /home/yourhome/podsyncconfig.toml:/app/config.toml. Die podsyncconfig.toml musst Du in Deinem Home-Verzeichnis anlegen.

[server]
port = 8080
hostname = "https://podsync.xxxx.de"
[storage]
  [storage.local]
  # Don't change if you run podsync via docker
  data_dir = "/app/data/"

[tokens]
youtube = "yourtoken"

[feeds]
    [feeds.somepodcast]
    url = "https://www.youtube.com/playlist?list=PLURnsdfdsf"
    quality = "high"
    format = "audio"
    cron_schedule = "0 12 * * *"
    [feeds.otherpodcast]
    url = "https://www.youtube.com/playlist?list=PLssfsd-"
    quality = "high"
    format = "audio"
    cron_schedule = "0 12 * * *"

Einen API-Schlüssel gibt es in der Google Developer Console https://console.developers.google.com/projectcreate

1. Stimme den Google Nutzungsbestimmungen zu
2. Namen auswählen und Projekt erstellen
3. Klicke auf die Anmeldedaten
4. Klicke auf: Anmeldedaten erstellen
5. Kopiere den API-Schlüssel
6. Füge den API-Schlüssel in die TOML in den Parameter [tokens] youtube = "yourtoken" ein

Wie Playlists abonnieren?

YouTube-Videos solltest Du möglichst als Playlist importieren. Podsync kann neue Videos in der Playlist automatisch finden und herunterladen.

1. Besuche die Videoplattform YouTube
2. Suche nach der Playlist mit der Suchleiste
3. Klicke auf die Playlist (nicht auf ein einzelnes Video aus der Playlist)
4. Wähle nochmal den Namen der Playlist oben rechts aus
5. Jetzt sollte in der URL Deines Browsers ein Parameter &list=PL... erscheinen

&list=PLsmjZYZs1as2Yc-GjlaMeXG-spYK6L2amf

6. Schreibe diesen Parameter um zu

https://www.youtube.com/playlist?list=PL….

7. Einfügen in die TOML podsyncconfig.toml unter dem Parameter url = "https://www.youtube.com/playlist?list=PLssfsd-"
8. Starte den Podsync Container neu
9. Warte bis zu 24h – bis der Sync fertig ist. Wenn Du einen Cron Job um 12:00 cron_schedule = "0 12 * * * definiert hast, findet der Download um 12:00 statt. Beim ersten Lauf kann das Laden bei langen und vielen Videos Stunden dauern.

Wie Podsync abonnieren?

1. Warte bis zu 24h bis alle Podcasts heruntergeladen wurden
2. Besuche die Webseite von Podsync unter der Nginx-Domain hostname = "https://podsync.xxxx.de", die Du vergeben hast oder über den Port 60001:8080, der in der Docker Compose steht: z. B. https://podsync.meinserver.de oder http://localhost:60001
3. Klicke auf den Podcast (XML), den Du abonnieren willst
4. Kopiere die URL in Deine Podcast-Player (AntennaPod) und abonniere diesen.
5. Lade Dir zur Offline-Nutzung Podcasts vor, weil Du je nach Standort des Servers nur im Heimnetz Podcasts streamen kannst.