Videos importieren

TubePress kann Ihre Mediathek auf verschiedene Arten befüllen — vom manuellen Hinzufügen eines einzelnen Clips bis hin zum Abruf Hunderttausender vorgefertigter Videos aus der Cloud. Diese Seite behandelt den integrierten Importer und zeigt Ihnen, wo die anderen Methoden zu finden sind.

Unabhängig von der gewählten Methode ist das Ergebnis dasselbe: normale Videos, die Sie wie jedes andere bearbeiten, organisieren, moderieren und veröffentlichen können. Wählen Sie die Methode, die zu Ihrem Inhaltsumfang passt und dazu, ob Sie einen einmaligen Import oder eine kontinuierliche Aktualisierung wünschen.

Methoden zum Hinzufügen von Inhalten zu TubePress

Es gibt keinen einzigen „richtigen" Weg, Videos hinzuzufügen — jede Methode eignet sich für eine andere Größenordnung und einen anderen Arbeitsablauf. Nutzen Sie die nachstehende Tabelle zur Auswahl und folgen Sie dem Link für weitere Details.

Importieren eines einzelnen Videos

TubePress hat keinen separaten „Einzelvideo"-Importer — um ein einzelnes Video hinzuzufügen, verwenden Sie den Videos-Bereich unter /admin/videos und wählen Video hinzufügen. Es gibt zwei Möglichkeiten, die Mediendaten bereitzustellen:

• Manueller Upload — laden Sie eine Videodatei hoch, die Sie selbst hosten.
• Einzelne-URL-Import — fügen Sie einen <iframe>-Einbettungscode oder eine direkte Video-URL ein, um einen anderswo gehosteten Clip einzubetten.

Geben Sie Titel und Thumbnail ein, weisen Sie Kategorien, Tags oder Mitwirkende zu und speichern Sie als Entwurf oder veröffentlichen Sie sofort. Keine der Methoden verbraucht Credits.

Massenimport

Der Massenimport befindet sich auf dem Tab Datei hochladen unter /admin/import. Er verarbeitet eine einzelne CSV- oder JSON-Datei — keine eingefügte URL-Liste — und wandelt jede Zeile bzw. jedes Objekt in ein Video um.

• CSV muss eine Kopfzeile haben und Kommas als Trennzeichen verwenden.
• JSON muss ein Array von Objekten sein.

Ziehen Sie die Datei auf die Upload-Zone (oder klicken Sie zum Durchsuchen) und TubePress liest die Spalten und zeigt eine Vorschau. Eine minimale CSV sieht so aus:

title,embed_code,thumbnail,duration,tags
My clip,https://ex.com/v/123.mp4,https://ex.com/t.jpg,612,"solo,hd"

Anschließend ordnen Sie Ihre Spalten per Drag-and-Drop den TubePress-Feldern zu. Die vom Importer erkannten Felder umfassen:

Legen Sie vor dem Start fest, wie Duplikate behandelt werden (überspringen oder aktualisieren, abgeglichen anhand von video_id), ob Thumbnails heruntergeladen werden sollen, damit sie von Ihrem Speicher bereitgestellt werden, und ob optionales KI-Umschreiben oder eine Übersetzung gewünscht ist.

Wie die Importwarteschlange funktioniert

Für alles, was über eine kleine Datei hinausgeht, wählen Sie Im Hintergrund starten. TubePress erstellt einen Auftrag und übergibt ihn an den Importprozessor, der Ihre Zeilen auch nach dem Schließen des Tabs verarbeitet. Es ist kein Systemcrontab erforderlich — er läuft auf dem integrierten pseudo-cron.

Der Prozessor ist auf Sicherheit und Robustheit ausgelegt:

• In Blöcken. Zeilen werden jeweils in kleinen Mengen importiert, sodass ein Web-Worker nie blockiert ist; eine einstellbare Importgeschwindigkeit steuert die Anzahl pro Block.
• Asynchron. Der pseudo-cron nimmt den Auftrag auf, sobald die Website Traffic erhält, und die Importseite treibt ihn voran, solange sie geöffnet ist.
• Selbstheilend. Ein blockierter Auftrag — etwa durch einen Serverneustart während des Laufs — wird nach etwa fünf Minuten automatisch neu eingereiht und setzt dort fort, wo er aufgehört hat.
• Deduplizierend. Zeilen mit einer bekannten video_id werden übersprungen oder aktualisiert statt dupliziert.
• Fehlertolerant. Eine fehlerhafte Zeile wird protokolliert (die ersten Fehler pro Block werden erfasst) und der Auftrag wird fortgesetzt.

Importfortschritt beobachten

Öffnen Sie /admin/import und beobachten Sie die Importwarteschlange. Jeder aktive Auftrag zeigt Live-Zählungen — importiert, übersprungen, Fehler und verarbeitet-von-gesamt — die alle paar Sekunden aktualisiert werden.

Von hier aus können Sie einen Auftrag pausieren, fortsetzen, abbrechen oder löschen. Aufträge der letzten 24 Stunden bleiben aufgelistet, damit Sie nachvollziehen können, was passiert ist, einschließlich erfasster Fehlermeldungen für fehlgeschlagene Zeilen.

Tipps & Einschränkungen

• Nur .csv- und .json-Dateien werden akzeptiert; andere Formate werden sofort abgelehnt.
• Das praktische Minimum pro Zeile ist ein Titel sowie ein Einbettungscode und ein Thumbnail.
• Die Upload-Größe wird durch die Servereinstellungen upload_max_filesize und post_max_size begrenzt. Teilen Sie sehr große Dateien auf oder verlassen Sie sich auf einen Hintergrundauftrag.
• Ordnen Sie eine stabile video_id zu, damit eine erneute Ausführung der Datei aktualisiert statt dupliziert.
• Aktivieren Sie Thumbnails herunterladen, um Bilder selbst zu hosten statt die Quelle direkt zu verlinken.
• KI-Umschreiben und Übersetzung verbrauchen Credits und benötigen ein verknüpftes tubepress.io-Konto; ist Ihr Guthaben zu niedrig, stoppt der Auftrag mit einer klaren Meldung.

Nächste Schritte