Zum Inhalt springen
TubePress — kostenlos, selbst gehostet & aktiv gepflegt
Inhalte importieren

Feed-Import (MRSS, RSS, CSV, JSON)

Verbinden Sie externe Feeds und rufen Sie neue Videos automatisch nach Zeitplan ab.

Feed-Import (manchmal auch Grabbers genannt) lässt Ihre Bibliothek von selbst wachsen. Sie abonnieren einmalig einen Remote-Feed, und TubePress prüft diesen planmäßig, holt neue Videos herein und überspringt bereits gesehene.

Er befindet sich als Tab im Import-Bildschirm — öffnen Sie /admin/import und wechseln Sie zu Feeds (die URL /admin/feeds leitet dorthin weiter). Im Gegensatz zu einem einmaligen Datei-Upload ergänzt ein Feed Ihre Website kontinuierlich, während die Quelle mehr veröffentlicht.

Was der Feed-Import macht

Jede Quelle ist eine Feed-URL plus einige Einstellungen. Planmäßig ruft TubePress den Feed ab, normalisiert jeden Eintrag und stellt die neuen in die Warteschlange; eine zweite Stufe wandelt diese Einträge dann in Videos um. Sie wählen, wie die Medien gespeichert werden:

  • Einbetten — speichert den Player-Link. Schnell, verbraucht keinen Speicher, und das Video wird von der Quelle gestreamt.
  • Download — lädt die eigentliche Datei in Ihren Speicher oder CDN herunter und transkodiert sie in Ihre Renditions.

Pro Quelle legen Sie außerdem den Videotyp (straight, gay oder hentai) fest und ob neue Videos automatisch veröffentlicht oder zur Überprüfung als Entwürfe zurückgehalten werden.

Unterstützte Feed-Formate

Vier Formate werden unterstützt, automatisch erkannt durch die Schaltfläche Erkennen & Vorschau:

FormatZuordnungHinweise
MRSSAutomatischMedia RSS — die umfangreichste Option; Felder werden automatisch zugeordnet.
RSSAutomatischStandard-RSS-Einträge.
CSVManuellEine CSV-Datei an einer URL; Sie ordnen die Spalten zu.
JSONManuellEin JSON-Array an einer URL; Sie ordnen die Schlüssel zu.
Automatisch vs. manuell. MRSS und RSS werden automatisch erkannt. CSV und JSON sind generisch, daher ordnen Sie deren Spalten einmalig zu — siehe Feld-Zuordnung unten.

Eine Feed-Quelle hinzufügen

  1. Öffnen Sie den Feeds-Tab. Gehen Sie zu /admin/import, wählen Sie Feeds, dann Feed-Quelle hinzufügen.
  2. Geben Sie die Feed-URL ein. Sie muss mit http:// oder https:// beginnen. Klicken Sie auf Erkennen & Vorschau, um das Format automatisch zu erkennen und die ersten Einträge in der Vorschau anzuzeigen.
  3. Benennen und Typ bestätigen. Geben Sie der Quelle einen Namen und überprüfen Sie das erkannte Format (MRSS, RSS, CSV oder JSON) und den Videotyp.
  4. Wählen Sie einen Modus. Einbetten zum Speichern von Player-Links, oder Download zum Abrufen und Transkodieren der Dateien.
  5. Spalten zuordnen, wenn nötig. MRSS und RSS ordnen sich selbst zu; für CSV/JSON ziehen Sie jede Spalte auf das entsprechende Feld.
  6. Zeitplan und Optionen festlegen. Wählen Sie ein Aktualisierungsintervall, die Duplikatregel, automatische Veröffentlichung und wie viele Seiten durchsucht werden sollen.
  7. Speichern. Verwenden Sie Jetzt abrufen, um sofort zu laden, oder lassen Sie den Zeitplan laufen. Warteschlange ausführen verarbeitet ausstehende Einträge auf Abruf.

Feld-Zuordnung

Feeds normalisieren Einträge auf dieselben kanonischen Felder, die der Importer verwendet. Für MRSS/RSS erfolgt dies automatisch; für CSV/JSON ordnen Sie Ihre Spalten zu:

title
Erforderlich. Einträge ohne Titel werden übersprungen.
video_url
Eine direkte, herunterladbare Datei — wird im Download-Modus verwendet.
embed_url
Die Player-URL — wird im Einbetten-Modus verwendet.
guid
Eine eindeutige ID zur Deduplizierung.
thumbnail, description, duration, published_at, views
Optionale Metadaten für das Video.
categories, tags, performers, channels
Kommagetrennte Namen, werden bei Fehlen erstellt.
Eine URL reicht. Im Einbetten-Modus gilt eine einzelne video_url auch als Einbett-Link, wenn Sie embed_url nicht zugeordnet haben. Ein minimaler Feed benötigt also nur einen Titel und eine URL.

Zeitplanung & Automatisierung

Eine Hintergrundaufgabe namens feed_import läuft auf dem pseudo-cron ungefähr alle 30 Sekunden — kein System-Crontab erforderlich. Jede Quelle wird nur abgerufen, wenn ihr eigenes Intervall abgelaufen ist:

  • Nur manuell — wird nie automatisch abgerufen; verwenden Sie „Jetzt abrufen".
  • Alle 15 Minuten, jede Stunde, alle 6 Stunden oder jeden Tag.

Dieselbe Aufgabe leert auch die Import-Warteschlange — Einbettungseinträge mehrere gleichzeitig, Downloads einen nach dem anderen, damit eine große Datei die übrigen nie blockiert. Die Einstellung Max. Seiten (1–50) begrenzt, wie tief ein einzelner Abruf einen paginierten Feed durchsucht.

Der Cron benötigt Traffic. Der pseudo-cron läuft nur, wenn Ihre Website besucht wird. Laden Sie bei einer neuen oder inaktiven Website eine Seite, um ihn auszulösen — oder richten Sie einen echten cron-Job für garantiertes Timing ein (siehe cron & CLI).

Deduplizierung & Filter

Deduplizierung erfolgt automatisch und funktioniert auf zwei Ebenen:

  • Pro Quelle. Die guid jedes Eintrags wird gespeichert, sodass beim erneuten Abrufen nur wirklich neue Einträge in die Warteschlange gestellt werden (bereits gesehene Einträge werden gezählt und übersprungen).
  • Siteübergreifend. Im Download-Modus wird die ID des Eintrags am Video gespeichert, sodass derselbe Clip, der von zwei Feeds kommt, nicht zweimal heruntergeladen wird.

Die Option Bei Duplikat entscheidet, was passiert, wenn ein Eintrag bereits vorhanden ist: Überspringen (empfohlen) oder Vorhandenes aktualisieren.

Kein Stichwortfilter. Feeds haben keinen Einschluss-/Ausschluss-Stichwortfilter — begrenzen Sie einen Feed, indem Sie ihn auf eine kategorie- oder tag-spezifische URL in der Quelle richten, und verwenden Sie Max. Seiten zur Tiefenbegrenzung. Das Löschen der Einträge einer Quelle setzt den Deduplizierungsspeicher zurück, löscht aber niemals Videos, die Sie bereits importiert haben.

Fehlerbehebung bei Feeds

  • „Das Feed-Format konnte nicht erkannt werden." Die URL hat kein gültiges MRSS/RSS/CSV/JSON zurückgegeben. Öffnen Sie sie in einem Browser und vergewissern Sie sich, dass Sie den rohen Feed sehen, keine HTML-Seite.
  • Einträge stecken im „Importieren". Sie erholen sich nach etwa 30 Minuten selbst und werden erneut versucht; vorübergehende Fehler werden bis zu dreimal wiederholt, bevor sie als fehlgeschlagen markiert werden.
  • Fehlgeschlagene Einträge. Verwenden Sie Neu verarbeiten, um alles erneut in die Warteschlange zu stellen, was für eine Quelle fehlgeschlagen ist. Jede Quelle zeigt ihren letzten Status und ihre Meldung.
  • Download-Modus schlägt fehl. Download benötigt eine direkte Video-URL (keine Watch-Seite); private oder interne Hosts sind gesperrt, und es gibt eine Obergrenze von 5 GB pro Datei.
  • Nichts wird importiert. Überprüfen Sie, dass der Zeitplan nicht auf Nur manuell steht, die Quelle aktiviert ist und Ihre Website Traffic erhält, um den Cron anzutreiben.

Nächste Schritte

Noch Hilfe benötigt?

Erstellen Sie ein Ticket in Ihrem Dashboard und unser Team hilft Ihnen gerne weiter.

Live-Demo ausprobieren → TubePress herunterladen →