Ajout de vidéos

S3D Player dispose d'un bouton Catalog. Il ouvre le Media Manager, une fenêtre pour accéder rapidement aux vidéos et images 3D. Vous sélectionnez une source dans la liste, faites défiler les cartes et lancez une vidéo d'un simple clic. Une source peut être un dossier sur votre ordinateur, une chaîne YouTube ou votre propre serveur protégé par mot de passe. Les sources sont décrites dans un fichier de configuration en texte brut, et vous pouvez en ajouter autant que nécessaire sans aucune programmation.

gestionnaire de médias

Méthodes de connexion

Le lecteur prend en charge quatre types de sources vidéo. Choisissez celle qui correspond à votre besoin. Elles peuvent être combinées : un catalogue peut contenir plusieurs dossiers locaux, chaînes et serveurs.

Méthode	Où se trouvent les vidéos	Ce dont vous avez besoin	Enregistrement sur disque
Dossier local	Sur votre ordinateur	Uniquement le chemin du dossier	Pas nécessaire, les fichiers sont déjà à vous
Chaîne YouTube	Sur YouTube	Un lien vers la chaîne	Autorisé
Votre propre serveur	Sur votre hébergement web	Un hébergement avec PHP, notre package de code	Si le serveur l'autorise
Serveur + Cloudflare R2	Dans le stockage cloud Cloudflare R2	Un hébergement avec PHP, un compte Cloudflare, notre package de code	Si le serveur l'autorise

Configuration du catalogue

Toutes les sources multimédias sont décrites dans deux fichiers texte situés dans le dossier du lecteur plugins\catalog\. Vous pouvez les ouvrir directement depuis la fenêtre Media Manager avec les boutons Base et User. Une fois un fichier enregistré, la fenêtre prend automatiquement en compte les modifications.

catalog-base.txt : une liste de sources qui illustre le lecteur. Ce fichier est remplacé par les mises à jour du lecteur de temps à autre, ne placez donc pas vos propres modifications ici : elles seront perdues lors de la prochaine mise à jour.
catalog-user.txt : votre propre liste. Les mises à jour ne la modifient jamais.

Dans la liste de sélection des sources, les sources apparaissent dans le même ordre que dans les fichiers : d'abord tout le contenu de catalog-base.txt, puis tout le contenu de catalog-user.txt. Si votre fichier contient une section portant le même nom qu'une section du fichier de base, vos paramètres remplacent ceux de la base.

Format du fichier
Chaque source commence par un nom entre crochets, suivi de lignes de la forme clé = valeur. Tout ce qui suit le signe # est un commentaire. Les paramètres généraux sont écrits en haut du fichier, avant la première section :

# general settings
quality  = 1080      # 720 / 1080 / 2160
thumb    = max       # preview: mq / 720 / max
save_dir = D:\Video\Saved
cookies  = firefox   # YouTube sign in, see the YouTube section

# source
[My 3D videos]
path      = D:\Video\3D
recursive = 1

Méthode 1 : un dossier sur votre ordinateur

La méthode la plus simple. Le lecteur analyse le dossier et affiche toutes les vidéos sous forme de cartes avec des aperçus. Les aperçus sont extraits d'une image de la vidéo elle-même ; pour les vidéos 3D, la vue gauche est utilisée.

Étape 1. Ouvrez catalog-user.txt
Dans la fenêtre Media Manager, cliquez sur le bouton User.

Étape 2. Ajoutez une section

[My 3D videos]
path      = D:\Video\3D
recursive = 1
include   = SBS, 3D

path : le chemin complet du dossier contenant les vidéos.
recursive = 1 : inclure également les sous-dossiers. Sans cette ligne, seul le dossier lui-même est analysé.
include : afficher uniquement les vidéos dont le titre contient au moins un de ces mots. Facultatif.
exclude : masquer les vidéos dont le titre contient l'un de ces mots. Facultatif.

Étape 3. Enregistrez le fichier
Sélectionnez la nouvelle source dans la liste des sources de la fenêtre. Le dossier est analysé à chaque fois qu'il est sélectionné, ainsi les nouveaux fichiers apparaissent immédiatement dans la liste. Si le dossier n'existe pas, la fenêtre affiche Folder not found.

* Le lecteur détecte le format 3D à partir du nom du fichier, par exemple movie_p.mp4 ou movie SBS.mkv. Si le nom ne précise pas le format, le détecteur de format du lecteur tente de le déterminer pendant la lecture.

Méthode 2 : une chaîne YouTube

Le lecteur affiche les vidéos de la chaîne sélectionnée sous forme de catalogue et les lit sans navigateur. Un filtre par mots dans le titre permet de conserver uniquement les vidéos 3D et d'écarter les autres.

Étape 1. Ajoutez une section à catalog-user.txt

[4K Cine Trailer]
url          = https://www.youtube.com/@4kcinematrailer
include      = 3D, SBS
exclude      = anaglyph, VR
search_max   = 3000
search_limit = 200

url : l'adresse de la chaîne.
include / exclude : mots dans les titres des vidéos qui déterminent quelles vidéos afficher et lesquelles masquer.
search_max : le nombre maximal de vidéos de la chaîne à parcourir.
search_limit : combien de vidéos correspondantes placer dans le catalogue.

Étape 2. Cliquez sur Rescan
Pour éviter de déclencher la protection anti-robots de YouTube, le lecteur n'analyse jamais les chaînes de lui-même. À l'ouverture de la fenêtre, il affiche la liste enregistrée. Les nouvelles vidéos ne sont chargées que par le bouton Rescan et lorsque vous faites défiler jusqu'à la fin de la liste, à chaque fois exactement autant que ce qui tient dans la fenêtre.

Étape 3. Si YouTube vous demande de confirmer que vous n'êtes pas un robot
Cela se produit sur les réseaux universitaires et d'entreprise ainsi qu'avec certains grands fournisseurs d'accès Internet. Connectez-vous à votre compte YouTube dans le navigateur Firefox. Le lecteur utilisera alors cette connexion pour accéder normalement aux vidéos. Ajoutez la ligne suivante en haut de votre catalog-user.txt :

cookies = firefox

Au lieu de firefox, vous pouvez indiquer le chemin vers un fichier cookies.txt. Les navigateurs basés sur Chrome (Chrome, Edge, Opera, Brave) ne fonctionneront pas : ils chiffrent leurs cookies, le lecteur ne peut donc pas les utiliser.

* Lorsque YouTube refuse l'accès, le lecteur suspend ses requêtes pendant 30 minutes. Cela protège votre adresse IP contre le blocage. La pause se lève d'elle-même au bout d'un moment.

Méthode 3 : un catalogue privé sur votre hébergement web

Pour ceux qui veulent montrer leurs propres vidéos 3D à leurs amis, clients ou à leur public. Les vidéos sont stockées sur votre hébergement web ; le lecteur récupère la liste et les lit uniquement avec un identifiant et un mot de passe. Vous décidez qui peut regarder et qui est autorisé à enregistrer les vidéos. Essayez la démo, elle est déjà incluse dans le lecteur : S3D demo server

Ce dont vous avez besoin
Un hébergement ordinaire et peu coûteux avec PHP et Apache (prise en charge de .htaccess). Un serveur dédié n'est pas nécessaire.

Paquet de code : votre propre serveur vidéo

Étape 1. Téléversez le paquet sur votre hébergement
Décompressez l'archive et copiez le dossier sur votre hébergement, par exemple dans /demo/. Les vidéos vont dans son dossier media.

Étape 2. Configurez config.php
Ouvrez config.php dans le dossier du paquet. Il définit le nom du fichier du panneau d'administration et son mot de passe initial. Modifiez les deux avant que le site ne devienne accessible au public.

Étape 3. Ajoutez des utilisateurs
Dans le panneau d'administration, créez des utilisateurs avec des mots de passe et indiquez lesquels sont autorisés à enregistrer les vidéos.

Étape 4. Testez le serveur
Dans l'invite de commandes Windows :

curl -i -X POST -d "user=demo-user&pass=12345" "https://example.com/demo/list.php"

Réponse 200 avec #private sur la première ligne : le serveur fonctionne. Réponse 403 : identifiant ou mot de passe incorrect.

Étape 5. Ajoutez le serveur au lecteur

[My server]
url      = https://example.com/demo/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

Sélectionnez la source et cliquez sur Rescan. À la prochaine ouverture de la fenêtre, la liste est tirée du cache et actualisée en arrière-plan.

Méthode 4 : Cloudflare R2 + votre hébergement web

Cloudflare propose des conditions très avantageuses pour stocker et diffuser vos fichiers : jusqu'à 10 Go de stockage gratuits et un trafic sortant gratuit, avec une tarification modérée au-delà. Utilisez un petit hébergement privé pour les identifiants et mots de passe, tandis que les vidéos elles-mêmes sont stockées dans le stockage cloud Cloudflare R2 au lieu de l'hébergement. L'hébergement vérifie uniquement le mot de passe et fournit au lecteur les liens. La vidéo parvient au spectateur directement depuis R2, ainsi les fichiers volumineux n'occupent ni espace ni trafic sur votre hébergement. Essayez la démo, elle est déjà incluse dans le lecteur : Cloudflare-R2 demo video

Cloudflare R2
Paquet de code : R2 + video

Étape 1. Créez un bucket R2
Dans le tableau de bord Cloudflare, ouvrez R2 object storage, créez un bucket et téléversez-y vos vidéos.

Étape 2. Créez une clé d'accès
Dans R2 object storage, sous Account Details, cliquez sur Manage à côté de API Tokens. Autorisations : Object Read only ; bucket : uniquement le vôtre (Apply to specific buckets only) ; TTL : Forever. Une fois le jeton créé, copiez l'Access Key ID et la Secret Access Key. Le secret n'est affiché qu'une seule fois.

Étape 3. Téléversez le paquet sur votre hébergement
Copiez le dossier du paquet sur votre hébergement, par exemple dans /cloudflare/. Dans config.php, saisissez l'Account ID, les deux clés et le nom du bucket, ainsi que le nom du fichier du panneau d'administration et son mot de passe.

Étape 4. Ajoutez des utilisateurs et testez
Comme dans la méthode 3 : les utilisateurs dans le panneau d'administration, un test avec la commande curl.

Étape 5. Ajoutez le serveur au lecteur

[My R2 server]
url      = https://example.com/cloudflare/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

* La clé R2 est stockée uniquement sur l'hébergement ; les spectateurs ne l'obtiennent jamais. Le serveur émet des liens vidéo temporaires valables 1 heure.

Enregistrement des vidéos

Si la source autorise l'enregistrement, l'en-tête de la fenêtre affiche une case à cocher Save. Lorsqu'elle est cochée, une vidéo est également écrite sur le disque pendant sa lecture : dans le dossier save_dir de la section de la source ou, si aucun n'y est défini, dans le save_dir général. Les vidéos des chaînes YouTube peuvent toujours être enregistrées. Un serveur privé autorise l'enregistrement uniquement pour les utilisateurs que le propriétaire du serveur a autorisés. Un dossier local n'a pas d'option d'enregistrement, puisque les fichiers sont déjà sur votre ordinateur.

L'autorisation d'un serveur privé arrive avec la liste lorsque vous cliquez sur Rescan. Tant que Rescan n'est pas cliqué, la fenêtre affiche No save à la place de la case à cocher.

Dépannage

Si la liste est vide, la fenêtre Media Manager en indique la raison.

No cache: press Rescan
La source n'a jamais été chargée. Cliquez sur Rescan.

Folder not found
Le dossier n'existe pas. Vérifiez le chemin dans path.

Wrong user or password
Le serveur a refusé l'identifiant ou le mot de passe. Vérifiez user et password.

Too many attempts, wait 15 min
Trop de tentatives de connexion échouées d'affilée. Attendez 15 minutes.

Server not responding
Aucune connexion réseau, ou l'adresse dans url est incorrecte.

YouTube : requêtes refusées
YouTube a jugé les requêtes suspectes. Activez cookies = firefox et attendez la fin de la pause.