Aggiunta di video

S3D Player dispone di un pulsante Catalog. Apre il Media Manager, una finestra per l'accesso rapido a video e immagini 3D. Selezioni una sorgente dall'elenco, scorri le schede e avvii un video con un solo clic. Una sorgente può essere una cartella sul tuo computer, un canale YouTube o il tuo server protetto da password. Le sorgenti sono descritte in un file di configurazione di testo semplice, e puoi aggiungerne quante ne desideri senza alcuna programmazione.

media manager

Metodi di connessione

Il player supporta quattro tipi di sorgenti video. Scegli quello che si adatta alla tua esigenza. Possono essere combinati: un catalogo può contenere più cartelle locali, canali e server.

Metodo	Dove sono i video	Cosa ti serve	Salvataggio su disco
Cartella locale	Sul tuo computer	Solo il percorso della cartella	Non necessario, i file sono già tuoi
Canale YouTube	Su YouTube	Un link al canale	Consentito
Il tuo server	Sul tuo web hosting	Hosting con PHP, il nostro pacchetto di codice	Se il server lo consente
Server + Cloudflare R2	Nell'archivio cloud Cloudflare R2	Hosting con PHP, un account Cloudflare, il nostro pacchetto di codice	Se il server lo consente

Configurazione del catalogo

Tutte le sorgenti multimediali sono descritte in due file di testo situati nella cartella del player plugins\catalog\. Puoi aprirli direttamente dalla finestra Media Manager con i pulsanti Base e User. Una volta salvato un file, la finestra rileva automaticamente le modifiche.

catalog-base.txt: un elenco di sorgenti che dimostra il player. Questo file viene sostituito dagli aggiornamenti del player di tanto in tanto, quindi non inserire qui le tue modifiche: andranno perse al prossimo aggiornamento.
catalog-user.txt: il tuo elenco personale. Gli aggiornamenti non lo modificano mai.

Nell'elenco di selezione delle sorgenti, le sorgenti appaiono nello stesso ordine dei file: prima tutto da catalog-base.txt, poi tutto da catalog-user.txt. Se il tuo file contiene una sezione con lo stesso nome di una nel file base, le tue impostazioni sostituiscono quelle base.

Formato del file
Ogni sorgente inizia con un nome tra parentesi quadre, seguito da righe nella forma chiave = valore. Tutto ciò che segue il segno # è un commento. Le impostazioni generali sono scritte all'inizio del file, prima della prima sezione:

# 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

Metodo 1: una cartella sul tuo computer

Il metodo più semplice. Il player analizza la cartella e mostra tutti i video come schede con anteprime. Le anteprime sono ricavate da un fotogramma del video stesso; per i video 3D viene utilizzata la vista sinistra.

Passo 1. Apri catalog-user.txt
Nella finestra Media Manager, fai clic sul pulsante User.

Passo 2. Aggiungi una sezione

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

path: il percorso completo della cartella con i video.
recursive = 1: include anche le sottocartelle. Senza questa riga viene analizzata solo la cartella stessa.
include: mostra solo i video il cui titolo contiene almeno una di queste parole. Facoltativo.
exclude: nasconde i video il cui titolo contiene una qualsiasi di queste parole. Facoltativo.

Passo 3. Salva il file
Seleziona la nuova sorgente nell'elenco delle sorgenti della finestra. La cartella viene analizzata ogni volta che viene selezionata, quindi i nuovi file compaiono subito nell'elenco. Se la cartella non esiste, la finestra mostra Folder not found.

* Il player rileva il formato 3D dal nome del file, ad esempio movie_p.mp4 o movie SBS.mkv. Se il nome non specifica il formato, il rilevatore di formato del player prova a determinarlo durante la riproduzione.

Metodo 2: un canale YouTube

Il player mostra i video del canale selezionato come catalogo e li riproduce senza browser. Un filtro per parole nel titolo permette di mantenere solo i video 3D e scartare gli altri.

Passo 1. Aggiungi una sezione a 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'indirizzo del canale.
include / exclude: parole nei titoli dei video che selezionano quali video mostrare e quali nascondere.
search_max: il numero massimo di video del canale da esaminare.
search_limit: quanti video corrispondenti inserire nel catalogo.

Passo 2. Fai clic su Rescan
Per evitare di attivare la protezione anti-bot di YouTube, il player non analizza mai i canali da solo. All'apertura della finestra, mostra l'elenco salvato. I nuovi video vengono caricati solo tramite il pulsante Rescan e quando scorri fino alla fine dell'elenco, ogni volta esattamente quanti ne stanno nella finestra.

Passo 3. Se YouTube ti chiede di confermare che non sei un bot
Questo accade sulle reti universitarie e aziendali e con alcuni grandi provider internet. Accedi al tuo account YouTube nel browser Firefox. Il player userà quindi questo accesso per accedere ai video normalmente. Aggiungi la seguente riga all'inizio del tuo catalog-user.txt:

cookies = firefox

Al posto di firefox puoi indicare il percorso di un file cookies.txt. I browser basati su Chrome (Chrome, Edge, Opera, Brave) non funzioneranno: cifrano i loro cookie, quindi il player non può usarli.

* Quando YouTube rifiuta l'accesso, il player sospende le sue richieste per 30 minuti. Questo protegge il tuo indirizzo IP dal blocco. La pausa si annulla da sola dopo un po'.

Metodo 3: un catalogo privato sul tuo web hosting

Per chi vuole mostrare i propri video 3D ad amici, clienti o al proprio pubblico. I video sono archiviati sul tuo web hosting; il player ottiene l'elenco e li riproduce solo con un nome utente e una password. Decidi tu chi può guardare e chi è autorizzato a salvare i video. Prova la demo, è già inclusa nel player: S3D demo server

Cosa ti serve
Un normale piano di hosting economico con PHP e Apache (supporto .htaccess). Non è richiesto un server dedicato.

Pacchetto di codice: il tuo server video

Passo 1. Carica il pacchetto sul tuo hosting
Estrai l'archivio e copia la cartella sul tuo hosting, ad esempio in /demo/. I video vanno nella sua cartella media.

Passo 2. Configura config.php
Apri config.php nella cartella del pacchetto. Imposta il nome del file del pannello di amministrazione e la sua password iniziale. Cambia entrambi prima che il sito diventi accessibile pubblicamente.

Passo 3. Aggiungi utenti
Nel pannello di amministrazione, crea utenti con password e indica quali di loro sono autorizzati a salvare i video.

Passo 4. Testa il server
Nel prompt dei comandi di Windows:

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

Risposta 200 con #private sulla prima riga: il server funziona. Risposta 403: nome utente o password errati.

Passo 5. Aggiungi il server al player

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

Seleziona la sorgente e clicca su Rescan. La prossima volta che la finestra si apre, l'elenco viene preso dalla cache e aggiornato in background.

Metodo 4: Cloudflare R2 + il tuo web hosting

Cloudflare offre condizioni molto favorevoli per archiviare e distribuire i tuoi file: fino a 10 GB di spazio di archiviazione gratuiti e traffico in uscita gratuito, con prezzi moderati oltre tale soglia. Usa un piccolo piano di hosting privato per login e password, mentre i video stessi sono archiviati nell'archiviazione cloud Cloudflare R2 invece che sull'hosting. L'hosting verifica solo la password e fornisce al player i link. Il video arriva allo spettatore direttamente da R2, quindi i file di grandi dimensioni non occupano né spazio né traffico sul tuo hosting. Prova la demo, è già inclusa nel player: Cloudflare-R2 demo video

Cloudflare R2
Pacchetto di codice: R2 + video

Passo 1. Crea un bucket R2
Nella dashboard di Cloudflare, apri R2 object storage, crea un bucket e carica i tuoi video al suo interno.

Passo 2. Crea una chiave di accesso
In R2 object storage, sotto Account Details, fai clic su Manage accanto a API Tokens. Permessi: Object Read only; bucket: solo il tuo (Apply to specific buckets only); TTL: Forever. Dopo aver creato il token, copia l'Access Key ID e la Secret Access Key. Il segreto viene mostrato una sola volta.

Passo 3. Carica il pacchetto sul tuo hosting
Copia la cartella del pacchetto sul tuo hosting, ad esempio in /cloudflare/. In config.php, inserisci l'Account ID, entrambe le chiavi e il nome del bucket, oltre al nome del file del pannello di amministrazione e alla sua password.

Passo 4. Aggiungi utenti e verifica
Come nel Metodo 3: utenti nel pannello di amministrazione, un test con il comando curl.

Passo 5. Aggiungi il server al player

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

* La chiave R2 è memorizzata solo sull'hosting; gli spettatori non la ricevono mai. Il server genera link video temporanei validi per 1 ora.

Salvataggio dei video

Se la sorgente consente il salvataggio, l'intestazione della finestra mostra una casella di controllo Save. Quando è selezionata, un video viene anche scritto su disco durante la riproduzione: nella cartella save_dir della sezione della sorgente o, se non è impostata lì, nella save_dir generale. I video dai canali YouTube possono sempre essere salvati. Un server privato consente il salvataggio solo per gli utenti che il proprietario del server ha autorizzato. Una cartella locale non ha opzione di salvataggio, poiché i file sono già sul tuo computer.

L'autorizzazione da un server privato arriva insieme all'elenco quando fai clic su Rescan. Finché non si fa clic su Rescan, la finestra mostra No save invece della casella di controllo.

Risoluzione dei problemi

Se l'elenco è vuoto, la finestra Media Manager mostra il motivo.

No cache: press Rescan
La sorgente non è mai stata caricata. Fai clic su Rescan.

Folder not found
La cartella non esiste. Controlla il percorso in path.

Wrong user or password
Il server ha rifiutato il login o la password. Controlla user e password.

Too many attempts, wait 15 min
Troppi tentativi di accesso falliti di seguito. Attendi 15 minuti.

Server not responding
Nessuna connessione di rete, oppure l'indirizzo in url è errato.

YouTube: requests refused
YouTube ha considerato le richieste sospette. Abilita cookies = firefox e attendi fino alla fine della pausa.