Video's importeren

TubePress kan uw bibliotheek op verschillende manieren vullen — van het handmatig toevoegen van één clip tot het binnenhalen van honderdduizenden kant-en-klare video's uit de cloud. Deze pagina behandelt de ingebouwde importer en laat u zien waar elke andere route te vinden is.

Welke methode u ook kiest, het resultaat is hetzelfde: gewone video's die u kunt bewerken, organiseren, modereren en publiceren zoals elk ander. Kies de methode die past bij hoeveel content u heeft, en of u een eenmalige import wilt of iets dat zichzelf blijft aanvullen.

Manieren om content in TubePress te importeren

Er is geen enkele 'juiste' manier om video's toe te voegen — elke methode past bij een andere schaal en werkstroom. Gebruik de onderstaande tabel om te kiezen en volg vervolgens de link voor de details.

Een enkele video importeren

TubePress heeft geen aparte importer voor 'één video' — om een enkele video toe te voegen gebruikt u het scherm Video's op /admin/videos en kiest u Video toevoegen. Er zijn twee manieren om de media aan te leveren:

• Handmatig uploaden — upload een videobestand dat u zelf host.
• Enkelvoudige URL-import — plak een <iframe>-insluitcode of een directe video-URL om een clip in te sluiten die elders gehost wordt.

Vul de titel en het miniatuur in, voeg eventuele categorieën, tags of uitvoerenden toe en sla op als concept of publiceer direct. Geen van beide routes verbruikt credits.

Bulk-import

Bulk-import is te vinden op het tabblad Bestand uploaden van /admin/import. Het neemt één CSV- of JSON-bestand — geen geplakte lijst met URL's — en zet elke rij of elk object om in een video.

• CSV moet een headerrij hebben en komma's als scheidingstekens gebruiken.
• JSON moet een array van objecten zijn.

Sleep het bestand naar de uploadzone (of klik om te bladeren) en TubePress leest de kolommen en toont een voorbeeld. Een minimale CSV ziet er zo uit:

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

Vervolgens koppelt u uw kolommen aan TubePress-velden door ze op de juiste plek te slepen. De velden die de importer herkent zijn onder andere:

Stel voor het starten in hoe duplicaten worden behandeld (overslaan of bijwerken, afgestemd op video_id), of u miniaturen wilt downloaden zodat ze vanuit uw eigen opslag worden aangeleverd, en eventuele optionele AI-herschrijving of -vertaling.

Hoe de importwachtrij werkt

Voor alles buiten een klein bestand, kiest u Op de achtergrond starten. TubePress maakt een taak aan en geeft deze door aan de importverwerker, die uw rijen doorwerkt zelfs nadat u het tabblad sluit. Er is geen systeembrede crontab vereist — het draait op de ingebouwde pseudo-cron.

De verwerker is ontworpen om veilig en robuust te zijn:

• Gesegmenteerd. Rijen worden een paar tegelijk geïmporteerd zodat een webwerker nooit vastzit; een aanpasbare importsnelheid bepaalt hoeveel er per segment worden verwerkt.
• Asynchroon. De pseudo-cron pakt de taak op zodra de site verkeer ontvangt, en de importpagina stimuleert het verdere verloop terwijl deze open is.
• Zelfherstellend. Een taak die vastloopt — bijvoorbeeld door een herstart van de server middenin een run — wordt na ongeveer vijf minuten automatisch opnieuw in de wachtrij gezet en gaat verder waar het was gebleven.
• Deduplicerend. Rijen met een bekend video_id worden overgeslagen of bijgewerkt in plaats van gedupliceerd.
• Vergevingsgezind. Een onjuiste rij wordt gelogd (de eerste paar fouten per segment worden bemonsterd) en de taak gaat door.

Importvoortgang bekijken

Open /admin/import en bekijk de Importwachtrij. Elke actieve taak toont live tellingen — geïmporteerd, overgeslagen, fouten en verwerkt-van-totaal — elke paar seconden vernieuwd.

Van hieruit kunt u een taak pauzeren, hervatten, annuleren of verwijderen. Taken van de afgelopen 24 uur blijven vermeld zodat u kunt bekijken wat er is gebeurd, inclusief bemonsterde foutmeldingen voor rijen die zijn mislukt.

Tips & beperkingen

• Alleen .csv- en .json-bestanden worden geaccepteerd; andere indelingen worden direct geweigerd.
• Het praktisch minimum per rij is een titel plus een insluitcode en een miniatuur.
• De uploadgrootte wordt begrensd door de upload_max_filesize en post_max_size van uw server. Splits zeer grote bestanden of gebruik een achtergrondtaak.
• Koppel een stabiel video_id zodat het opnieuw uitvoeren van een bestand bijwerkt in plaats van dupliceert.
• Schakel Miniaturen downloaden in om afbeeldingen zelf te hosten in plaats van de bron te hotlinken.
• AI-herschrijving en -vertaling verbruiken credits en vereisen een gekoppeld tubepress.io-account; als uw saldo te laag is, stopt de taak met een duidelijke melding.

Volgende stappen