Ga naar inhoud
TubePress — gratis, zelf gehost & actief onderhouden
Content importeren

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

Verbind externe feeds en haal automatisch volgens schema nieuwe video's binnen.

Feed import (ook wel grabbers genoemd) laat je bibliotheek vanzelf groeien. Je abonneert je eenmalig op een externe feed, en TubePress controleert deze op een schema, haalt nieuwe video's binnen en slaat alles over wat al eerder is gezien.

Het bevindt zich als tabblad in het importscherm — open /admin/import en schakel over naar Feeds (de /admin/feeds URL verwijst daarheen). In tegenstelling tot een eenmalige bestandsupload houdt een feed je site aangevuld naarmate de bron meer publiceert.

Wat feed import doet

Elke bron is een feed-URL plus een aantal instellingen. Op het geplande tijdstip haalt TubePress de feed op, normaliseert elke vermelding en zet nieuwe items in de wachtrij; een tweede stap zet die items vervolgens om in video's. Je kiest hoe het medium wordt opgeslagen:

  • Insluiten — sla de spelerlink op. Snel, gebruikt geen opslag, en de video wordt gestreamd vanaf de bron.
  • Downloaden — haal het daadwerkelijke bestand op naar je opslag of CDN en transcodeer het naar je weergaveversies.

Per bron stel je ook het videotype in (straight, gay of hentai) en of nieuwe video's automatisch gepubliceerd worden of als concept worden bewaard voor beoordeling.

Ondersteunde feedformaten

Vier formaten worden ondersteund, automatisch gedetecteerd door de knop Detecteer & Voorbeeld:

FormaatKoppelingOpmerkingen
MRSSAutomatischMedia RSS — de rijkste optie; velden worden automatisch toegewezen.
RSSAutomatischStandaard RSS-items.
CSVHandmatigEen CSV geserveerd op een URL; je koppelt de kolommen zelf.
JSONHandmatigEen JSON-array geserveerd op een URL; je koppelt de sleutels zelf.
Automatisch vs handmatig. MRSS en RSS worden automatisch herkend. CSV en JSON zijn generiek, dus je koppelt hun kolommen eenmalig — zie Veldkoppeling hieronder.

Een feedbron toevoegen

  1. Open het tabblad Feeds. Ga naar /admin/import, selecteer Feeds en klik op Feedbron toevoegen.
  2. Voer de feed-URL in. Deze moet beginnen met http:// of https://. Klik op Detecteer & Voorbeeld om het formaat automatisch te detecteren en een voorbeeld van de eerste vermeldingen te bekijken.
  3. Geef het een naam en bevestig het type. Geef de bron een naam en controleer het gedetecteerde formaat (MRSS, RSS, CSV of JSON) en het videotype.
  4. Kies een modus. Insluiten om spelerlinks op te slaan, of Downloaden om de bestanden op te halen en te transcoderen.
  5. Koppel kolommen indien nodig. MRSS en RSS koppelen zichzelf; voor CSV/JSON sleep je elke kolom naar het overeenkomstige veld.
  6. Stel het schema en de opties in. Kies een verversingsinterval, de dubbele-items-regel, automatisch publiceren en hoeveel pagina's er worden doorzocht.
  7. Opslaan. Gebruik Nu ophalen om direct te laden, of laat het schema lopen. Wachtrij verwerken verwerkt openstaande items op aanvraag.

Veldkoppeling

Feeds normaliseren vermeldingen naar dezelfde canonieke velden die de importer gebruikt. Voor MRSS/RSS is dit automatisch; voor CSV/JSON koppel je je kolommen aan:

title
Vereist. Vermeldingen zonder titel worden overgeslagen.
video_url
Een direct downloadbaar bestand — gebruikt in de downloadmodus.
embed_url
De speler-URL — gebruikt in de insluitingsmodus.
guid
Een uniek ID dat wordt gebruikt voor deduplicatie.
thumbnail, description, duration, published_at, views
Optionele metadata voor de video.
categories, tags, performers, channels
Door komma's gescheiden namen, aangemaakt als ze ontbreken.
Één URL is voldoende. In de insluitingsmodus fungeert een enkele video_url ook als insluitingslink als je embed_url niet hebt gekoppeld, dus een minimale feed heeft alleen een titel en één URL nodig.

Planning & automatisering

Een achtergrondtaak genaamd feed_import draait op de pseudo-cron ongeveer elke 30 seconden — geen systeemcrontab nodig. Elke bron wordt alleen opgehaald wanneer het eigen interval is verstreken:

  • Alleen handmatig — nooit automatisch opgehaald; gebruik Nu ophalen.
  • Elke 15 minuten, elk uur, elke 6 uur of elke dag.

Dezelfde taak leegt ook de importwachtrij — ingesloten items meerdere tegelijk, downloads één voor één zodat een groot bestand de rest nooit blokkeert. De instelling Max pagina's (1–50) beperkt hoe diep een enkele ophaalactie een gepagineerde feed doorzoekt.

De cron heeft verkeer nodig. De pseudo-cron tikt alleen wanneer je site wordt bezocht. Op een gloednieuwe of inactieve site laad je een pagina om het te activeren — of stel een echte cron-taak in voor gegarandeerde timing (zie cron & CLI).

Deduplicatie & filters

Deduplicatie is automatisch en werkt op twee niveaus:

  • Per bron. De guid van elk item wordt onthouden, zodat opnieuw ophalen alleen echte nieuwe vermeldingen in de wachtrij zet (al bekeken items worden geteld en overgeslagen).
  • Sitebreed. In de downloadmodus wordt het ID van het item opgeslagen bij de video, zodat hetzelfde fragment dat van twee feeds binnenkomt niet twee keer wordt gedownload.

De optie Bij duplicaat bepaalt wat er gebeurt als een item al bestaat: Overslaan (aanbevolen) of Bestaande bijwerken.

Geen trefwoordfilter. Feeds hebben geen inclusie-/exclusietrefwoordfilter — begrens een feed door deze te laten verwijzen naar een categorie- of tagspecifieke URL bij de bron, en gebruik Max pagina's om de diepte te beperken. Het wissen van de items van een bron reset het deduplicatiegeheugen, maar verwijdert nooit video's die je al hebt geïmporteerd.

Feedproblemen oplossen

  • "Kon het feedformaat niet herkennen." De URL heeft geen geldige MRSS/RSS/CSV/JSON geretourneerd. Open het in een browser en bevestig dat je de onbewerkte feed ziet, niet een HTML-pagina.
  • Items vastgelopen bij "importeren." Ze herstellen automatisch na ongeveer 30 minuten en worden opnieuw geprobeerd; tijdelijke fouten worden maximaal drie keer opnieuw geprobeerd voordat ze als mislukt worden gemarkeerd.
  • Mislukte items. Gebruik Herverwerken om alles wat voor een bron is mislukt opnieuw in de wachtrij te zetten. Elke bron toont zijn laatste status en bericht.
  • Downloadmodus mislukt. Downloaden heeft een directe video-URL nodig (geen kijkpagina); privé- of interne hosts zijn geblokkeerd, en er geldt een limiet van 5 GB per bestand.
  • Er wordt niets geïmporteerd. Controleer of het schema niet op Alleen handmatig staat, dat de bron is ingeschakeld en dat je site verkeer ontvangt om de cron aan te drijven.

Volgende stappen

Nog vastgelopen?

Open een ticket vanuit uw dashboard en ons team helpt u verder.

Probeer de live demo → TubePress downloaden →