Werbe-Spot-Manager

MP3-Spots verwalten und automatisch in Liquidsoap einspielen

Werbe-Spot-Manager ist ein Premium-Plugin fuer RadioCMS Community Edition. Damit verwaltest du Werbe-Spots, Jingles und Drops als MP3-Dateien, planst sie zwischen Sendungen, stuendlich oder zu festen Uhrzeiten ein und pushst sie via Liquidsoap-Telnet direkt in deinen Stream.

Was du konkret damit machen kannst

MP3-Spots hochladen und verwalten

Pro Spot: Name, Kategorie (z.B. „Werbung", „Drop", „Jingle"), MP3-Datei (max 20 MB). Audio-Player im Admin zum Vorhoeren.

Schedule pro Spot

4 Schedule-Typen:

• Zwischen Sendungen: Spot laeuft am Anfang/Ende jeder Sendung
• Stuendlich: jede Stunde ein Spot
• Feste Uhrzeit: z.B. taeglich um 14:00
• Zufaellig: gewichtet aus dem Pool gezogen

Plus: Start-/End-Datum fuer den Schedule (Werbung-Kampagnen mit Laufzeit).

Liquidsoap-Push via Telnet

Plugin verbindet sich via Telnet zum Liquidsoap-Server, pushed den Spot in eine request.queue. Liquidsoap spielt den Spot dann auf dem Stream ab.

„Sofort abspielen"-Button

Im Admin auf jedem Spot ein Push-Button: spielt den Spot SOFORT ueber Liquidsoap aus, egal welcher Schedule.

Play-Log mit CSV-Export

Jeder Push wird mit Timestamp + Spot-Name + Trigger geloggt. Export der letzten 5000 als CSV fuer Sponsor-Reporting.

Installation

1. Admin -> Plugins -> Marketplace -> Werbe-Spot-Manager -> Kaufen 49 EUR oder Lizenz eintragen
2. Lizenz aktivieren
3. Plugin aktivieren
4. Sidebar zeigt „Werbe-Spots" mit 4 Tabs (Spots, Schedule, Play-Log, Settings)

Schritt fuer Schritt

Liquidsoap-Setup vorab

Damit der Spot-Push funktioniert, muss deine Liquidsoap-Konfig:

spots = request.queue(id="spots.push")
radio = fallback([spots, main_playlist])
output.icecast(...)

Plus den Telnet-Server aktivieren:

settings.server.telnet := true
settings.server.telnet.bind_addr := "127.0.0.1"
settings.server.telnet.port := 1234

Verbindung testen

1. Tab „Settings" -> Liquidsoap-Host (default 127.0.0.1) + Port (default 1234) eintragen
2. Optional: Auth-Password (wenn Liquidsoap eine Telnet-Auth hat)
3. „Verbindung testen" klicken -> sollte „Liquidsoap erreichbar" zeigen

Spots hochladen

1. Tab „Spots" -> Formular oben
2. Name, Kategorie, MP3-Datei
3. „Hochladen" -> Spot erscheint in der Liste mit Audio-Player

Schedule anlegen

1. Tab „Schedule" -> Formular oben
2. Spot waehlen, Schedule-Typ, Wert (z.B. „14:00" fuer fixed_time)
3. Gewicht (1-10), Aktiv-Toggle, optional Start-/End-Datum
4. Anlegen

Manueller Push

• Tab „Spots" -> bei jedem Spot Button „Push"
• Pusht sofort an Liquidsoap, Liquidsoap spielt im naechsten freien Slot

Play-Log checken

• Tab „Play-Log" -> letzte 100 Plays
• CSV-Export fuer Sponsor-Reporting (z.B. „Spot Bauer Mueller lief 47x im November")

Tipps

• MP3 max 20 MB: groessere Dateien entweder kuerzen oder per FTP nach /uploads/spots/ legen + manuell DB-Eintrag machen
• Keine Endlos-Spots: 30-60 Sekunden ist ueblich fuer Werbe-Spots
• Zwischen-Sendungs-Spots: Liquidsoap-Hook nutzen um genau am Sendungs-Wechsel zu pushen (im aktuellen Plugin: per Cron alle 60 Min auto-push)
• Multi-Spots-Schedule: pro Stunde mehrere Spots, gewichtet → Werbe-Block-Effekt
• A/B-Test: zwei Versionen eines Spots mit Gewicht 5/5 → 50/50 Split, beide loggen, schauen welcher besser laeuft

Was Werbe-Spot-Manager NICHT macht

• Kein automatisches MP3-Schneiden. Spot muss schon fertig produziert sein als MP3.
• Kein Voice-Cloning oder TTS. Das macht DJ-Drops-Generator (kommt in v1.9, nutzt Google Cloud TTS / ElevenLabs).
• Kein eigener Stream-Server. Du brauchst einen funktionierenden Liquidsoap-Setup.
• Kein Royalty-Tracking. GEMA-Pflichten musst du selbst abrechnen.

Beispiel

Schausteller-Radio: 5 lokale Werbe-Spots, je 30 Sek MP3:

• Bauer Mueller: stuendlich, Gewicht 3
• Geschaeft Mayer: stuendlich, Gewicht 2
• Konzert-Hinweis: feste Uhrzeit 18:00, Gewicht 1, Start 1.6., Ende 30.6.
• „Du hoerst Schausteller-Radio"-Drop: zufaellig, Gewicht 5
• Lokal-Brauerei: zwischen Sendungen, Gewicht 4

Liquidsoap pushed alle automatisch zur richtigen Zeit. Play-Log zeigt zum Ende des Monats: 720 Plays Bauer Mueller, 480 Plays Mayer, 30 Plays Konzert (war ja nur 18:00 und nur 1 Monat). Reporting an Sponsoren als CSV.

Kontakt

Fragen oder Wunsch fuer ein neues Feature? me@heikodeutsch.io