Import par flux (MRSS, RSS, CSV, JSON)
Connectez des flux externes et récupérez automatiquement de nouvelles vidéos selon une planification.
L'import de flux (parfois appelé grabbers) fait croître votre bibliothèque de façon autonome. Vous vous abonnez une seule fois à un flux distant, et TubePress le vérifie selon un calendrier, récupère les nouvelles vidéos et ignore tout ce qu'il a déjà vu.
Cette fonctionnalité se présente sous forme d'onglet dans l'écran d'import — ouvrez /admin/import et basculez vers Flux (l'URL /admin/feeds y redirige). Contrairement à un import de fichier ponctuel, un flux continue d'alimenter votre site au fur et à mesure que la source publie du nouveau contenu.
Fonctionnement de l'import de flux
Chaque source est une URL de flux accompagnée de quelques paramètres. Selon son calendrier, TubePress récupère le flux, normalise chaque entrée et met en file les nouvelles ; une deuxième étape convertit ensuite ces éléments en attente en vidéos. Vous choisissez la façon dont le média est stocké :
- Embed — stocke le lien du lecteur. Rapide, sans consommation d'espace de stockage, la vidéo est diffusée depuis la source.
- Download — télécharge le fichier réel vers votre espace de stockage ou CDN et le transcode dans vos renditions.
Par source, vous définissez également le type de vidéo (straight, gay ou hentai) et si les nouvelles vidéos sont publiées automatiquement ou conservées comme brouillons pour révision.
Formats de flux pris en charge
Quatre formats sont pris en charge, détectés automatiquement par le bouton Détecter & Prévisualiser :
| Format | Correspondance | Notes |
|---|---|---|
| MRSS | Automatique | RSS Média — l'option la plus riche ; les champs se mappent automatiquement. |
| RSS | Automatique | Éléments RSS standard. |
| CSV | Manuel | Un CSV servi à une URL ; vous mappez les colonnes. |
| JSON | Manuel | Un tableau JSON servi à une URL ; vous mappez les clés. |
Ajouter une source de flux
- Ouvrir l'onglet Flux. Accédez à
/admin/import, sélectionnez Flux, puis Ajouter une source de flux. - Saisir l'URL du flux. Elle doit commencer par
http://ouhttps://. Cliquez sur Détecter & Prévisualiser pour détecter automatiquement le format et prévisualiser les premières entrées. - Nommer et confirmer le type. Donnez un nom à la source et vérifiez le format détecté (MRSS, RSS, CSV ou JSON) ainsi que le type de vidéo.
- Choisir un mode. Embed pour stocker les liens du lecteur, ou Download pour récupérer et transcoder les fichiers.
- Mapper les colonnes si nécessaire. MRSS et RSS se mappent automatiquement ; pour CSV/JSON, faites glisser chaque colonne vers le champ correspondant.
- Définir le calendrier et les options. Choisissez un intervalle de rafraîchissement, la règle pour les doublons, la publication automatique et le nombre de pages à explorer.
- Enregistrer. Utilisez Récupérer maintenant pour importer immédiatement, ou laissez le calendrier s'exécuter. Traiter la file traite à la demande les éléments en attente.
Mappage de champs
Les flux normalisent les entrées vers les mêmes champs canoniques que l'importateur utilise. Pour MRSS/RSS, c'est automatique ; pour CSV/JSON, vous mappez vos colonnes vers :
video_url fait office de lien d'intégration si vous n'avez pas mappé embed_url, donc un flux minimal n'a besoin que d'un titre et d'une URL.Planification & automatisation
Une tâche de fond nommée feed_import s'exécute sur le pseudo-cron environ toutes les 30 secondes — pas besoin de crontab système. Chaque source n'est récupérée que lorsque son propre intervalle est écoulé :
- Manuel uniquement — jamais récupérée automatiquement ; utilisez Récupérer maintenant.
- Toutes les 15 minutes, toutes les heures, toutes les 6 heures ou chaque jour.
La même tâche vide également la file d'import — traite plusieurs éléments Embed à la fois, et les téléchargements un par un pour qu'un fichier volumineux ne bloque pas le reste. Le paramètre Max pages (1–50) limite la profondeur d'exploration d'un flux paginé lors d'une seule récupération.
Déduplication & filtres
La déduplication est automatique et fonctionne sur deux niveaux :
- Par source. Le
guidde chaque élément est mémorisé, ainsi lors d'une nouvelle récupération seules les entrées véritablement nouvelles sont mises en file (les éléments déjà vus sont comptés et ignorés). - Sur l'ensemble de votre site. En mode Download, l'ID de l'élément est stocké sur la vidéo, de sorte que le même clip provenant de deux flux n'est pas téléchargé deux fois.
L'option En cas de doublon détermine ce qui se passe quand un élément existe déjà : Ignorer (recommandé) ou Mettre à jour l'existant.
Résolution des problèmes de flux
- « Impossible de reconnaître le format du flux. » L'URL n'a pas retourné un MRSS/RSS/CSV/JSON valide. Ouvrez-la dans un navigateur et vérifiez que vous voyez le flux brut, pas une page HTML.
- Éléments bloqués en « importation ». Ils se rétablissent automatiquement après environ 30 minutes et sont relancés ; les échecs transitoires sont retraités jusqu'à trois fois avant d'être marqués comme échoués.
- Éléments échoués. Utilisez Retraiter pour remettre en file tout ce qui a échoué pour une source. Chaque source affiche son dernier statut et message.
- Échec du mode Download. Le mode Download nécessite une URL de vidéo directe (pas une page de visionnage) ; les hôtes privés ou internes sont bloqués, et il y a une limite de 5 Go par fichier.
- Rien ne s'importe. Vérifiez que le calendrier n'est pas en Manuel uniquement, que la source est activée et que votre site reçoit du trafic pour alimenter le cron.
Prochaines étapes
Toujours bloqué ?
Ouvrez un ticket depuis votre tableau de bord et notre équipe vous assistera.