SERMAN RSS Feed Generator - Lokale Version

Ein Python-Tool zum Erstellen von RSS-Feeds aus lokalen MP3-Dateien für Podcast-Apps.

Features

• 🎵 Scannt automatisch das _audio/ Verzeichnis nach MP3-Dateien
• 📱 Erstellt Podcast-kompatible RSS-Feeds
• 🏷️ Liest ID3-Tags automatisch aus MP3-Dateien
• 🌐 Integrierter HTTP-Server zum Hosten der Dateien
• ⚡ Einfache Bedienung über Kommandozeile

Installation

1. Abhängigkeiten installieren:

uv sync

2. MP3-Dateien in das _audio/ Verzeichnis legen

Verwendung

Einfache Nutzung

uv run python main.py

Mit HTTP-Server

uv run python main.py --serve

Erweiterte Optionen

uv run python main.py --audio-dir _audio --output my_podcast.xml --base-url https://meinserver.de --serve --port 8080

Parameter

• --audio-dir: Verzeichnis mit MP3-Dateien (Standard: _audio)
• --output: Name der RSS-Feed-Datei (Standard: serman_podcast.xml)
• --base-url: Basis-URL für Audio-Links (Standard: http://localhost:8000)
• --serve: Startet automatisch einen HTTP-Server
• --port: Port für den HTTP-Server (Standard: 8000)

RSS-Feed URLs

Nach dem Start des Servers ist der Feed verfügbar unter:

• Lokal: http://localhost:8000/serman_podcast.xml
• Mit eigener Basis-URL: [DEINE_URL]/serman_podcast.xml

Podcast-App Integration

1. RSS-Feed generieren und Server starten
2. RSS-URL in Podcast-App hinzufügen
3. Neue MP3-Dateien im _audio/ Verzeichnis ablegen
4. Feed neu generieren für Updates

Dateiformat

Das Tool liest automatisch folgende ID3-Tags:

• TIT2: Titel (Fallback: Dateiname)
• TPE1: Künstler (Fallback: "SERMAN")
• TALB: Album (optional)
• Dauer: Automatisch erkannt

Verzeichnisstruktur

rss-feeder/
├── _audio/                   # MP3-Dateien hier ablegen
│   ├── mix1.mp3
│   ├── mix2.mp3
│   └── README.md
├── main.py                   # Hauptprogramm
├── local_podcast_generator.py # RSS-Generator
├── serman_podcast.xml        # Generierter RSS-Feed
└── requirements.txt          # Python-Abhängigkeiten

Deployment

Für produktive Nutzung:

1. Server bereitstellen (z.B. VPS, Cloud-Instance)
2. Dateien hochladen und Dependencies installieren
3. Permanenten Webserver konfigurieren (nginx, Apache)
4. RSS-Feed URL an Hörer verteilen

Automatisierung

Für automatische Updates bei neuen MP3-Dateien:

# Beispiel-Script für cron job
#!/bin/bash
cd /pfad/zu/rss-feeder
uv run python main.py --base-url https://meinserver.de/podcast

---

Legacy: Mixcloud-Version

Die ursprünglichen Mixcloud-Skripte sind noch vorhanden:

• mixcloud_rss_pro.py - Mixcloud RSS mit Audio-Extraktion
• mixcloud_rss.py - Einfache Mixcloud RSS-Generierung

Siehe Git-Historie für die ursprüngliche Mixcloud-basierte README.