Importer des vidéos

TubePress peut remplir votre bibliothèque de plusieurs façons — depuis l'ajout d'un seul clip à la main jusqu'à l'importation de centaines de milliers de vidéos prêtes à l'emploi depuis le cloud. Cette page présente l'importateur intégré et vous indique où trouver chaque autre méthode.

Quelle que soit la méthode choisie, le résultat est identique : des vidéos ordinaires que vous pouvez modifier, organiser, modérer et publier comme n'importe quelle autre. Choisissez celle qui correspond au volume de contenu dont vous disposez, et selon que vous souhaitez un chargement unique ou quelque chose qui se renouvelle en continu.

Moyens d'intégrer du contenu dans TubePress

Il n'existe pas de méthode universelle pour ajouter des vidéos — chaque méthode convient à une échelle et un flux de travail différents. Utilisez le tableau ci-dessous pour choisir, puis suivez le lien pour les détails.

Importation d'une seule vidéo

TubePress ne dispose pas d'importateur dédié à une seule vidéo — pour ajouter une vidéo unique, utilisez l'écran Vidéos sur /admin/videos et choisissez Ajouter une vidéo. Il existe deux façons de fournir le média :

• Téléversement manuel — téléversez un fichier vidéo que vous hébergez vous-même.
• Import URL unique — collez un code d'intégration <iframe> ou une URL vidéo directe pour intégrer un clip hébergé ailleurs.

Renseignez le titre et la miniature, associez les catégories, tags ou interprètes souhaités, puis enregistrez en brouillon ou publiez immédiatement. Aucune de ces méthodes n'utilise de crédits.

Import en masse

L'import en masse se trouve dans l'onglet Téléverser un fichier de /admin/import. Il accepte un seul fichier CSV ou JSON — pas une liste d'URL collée — et transforme chaque ligne ou objet en vidéo.

• Le CSV doit comporter une ligne d'en-tête et utiliser des virgules comme séparateurs.
• Le JSON doit être un tableau d'objets.

Faites glisser le fichier sur la zone de téléversement (ou cliquez pour parcourir) et TubePress lit les colonnes et affiche un aperçu. Un CSV minimal ressemble à ceci :

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

Ensuite, vous mappez vos colonnes sur les champs TubePress en les faisant glisser à leur emplacement. Les champs reconnus par l'importateur sont :

Avant de commencer, définissez la gestion des doublons (ignorer ou mettre à jour, correspondance sur video_id), si vous souhaitez télécharger les miniatures pour les servir depuis votre propre stockage, et toute réécriture ou traduction IA optionnelle.

Fonctionnement de la file d'attente d'import

Pour tout ce qui dépasse un petit fichier, choisissez Démarrer en arrière-plan. TubePress crée une tâche et la confie au processeur d'import, qui traite vos lignes même après la fermeture de l'onglet. Aucun crontab système n'est requis — il fonctionne sur le pseudo-cron intégré.

Le processeur est conçu pour être sûr et résilient :

• Fragmenté. Les lignes sont importées quelques-unes à la fois afin qu'un worker web ne soit jamais monopolisé ; une vitesse d'import réglable contrôle le nombre par fragment.
• Asynchrone. Le pseudo-cron prend en charge la tâche au fil du trafic reçu par le site, et la page d'import l'encourage pendant qu'elle est ouverte.
• Auto-réparant. Une tâche qui se bloque — par exemple lors d'un redémarrage du serveur en cours d'exécution — est remise en file d'attente automatiquement après environ cinq minutes et reprend là où elle s'était arrêtée.
• Dédupliquant. Les lignes avec un video_id connu sont ignorées ou mises à jour plutôt que dupliquées.
• Tolérant. Une ligne incorrecte est consignée (les premières erreurs par fragment sont échantillonnées) et la tâche se poursuit.

Suivi de la progression de l'import

Ouvrez /admin/import et observez la File d'attente d'import. Chaque tâche active affiche des comptages en direct — importées, ignorées, erreurs et traitées-sur-total — actualisés toutes les quelques secondes.

Depuis ici, vous pouvez mettre en pause, reprendre, annuler ou supprimer une tâche. Les tâches des dernières 24 heures restent listées pour vous permettre de revoir ce qui s'est passé, y compris les messages d'erreur échantillonnés pour toutes les lignes ayant échoué.

Conseils & limites

• Seuls les fichiers .csv et .json sont acceptés ; les autres formats sont rejetés d'emblée.
• Le minimum pratique par ligne est un titre plus un code d'intégration et une miniature.
• La taille du téléversement est limitée par les paramètres upload_max_filesize et post_max_size de votre serveur. Divisez les très grands fichiers ou utilisez une tâche en arrière-plan.
• Mappez un video_id stable pour que la réexécution d'un fichier mette à jour plutôt que duplique.
• Activez Télécharger les miniatures pour auto-héberger les images au lieu de les lier directement à la source.
• La réécriture et la traduction IA consomment des crédits et nécessitent un compte tubepress.io associé ; si votre solde est trop faible, la tâche s'arrête avec un message explicite.

Étapes suivantes