वीडियो जोड़ना

S3D Player में एक Catalog बटन है। यह Media Manager खोलता है, जो 3D वीडियो और चित्रों तक त्वरित पहुँच के लिए एक विंडो है। आप सूची से एक स्रोत चुनते हैं, कार्डों को स्क्रॉल करते हैं और एक क्लिक में वीडियो शुरू करते हैं। एक स्रोत आपके कंप्यूटर पर एक फ़ोल्डर, एक YouTube चैनल या आपका अपना पासवर्ड-सुरक्षित सर्वर हो सकता है। स्रोतों को एक सादे टेक्स्ट कॉन्फ़िगरेशन फ़ाइल में वर्णित किया जाता है, और आप बिना किसी प्रोग्रामिंग के जितने चाहें उतने जोड़ सकते हैं।

मीडिया मैनेजर

कनेक्शन विधियाँ

प्लेयर चार प्रकार के वीडियो स्रोतों का समर्थन करता है। वह चुनें जो आपके कार्य के लिए उपयुक्त हो। इन्हें संयोजित किया जा सकता है: एक कैटलॉग में कई स्थानीय फ़ोल्डर, चैनल और सर्वर हो सकते हैं।

विधि	वीडियो कहाँ हैं	आपको क्या चाहिए	डिस्क पर सहेजना
स्थानीय फ़ोल्डर	आपके कंप्यूटर पर	केवल फ़ोल्डर पथ	आवश्यक नहीं, फ़ाइलें पहले से आपकी हैं
YouTube चैनल	YouTube पर	चैनल का लिंक	अनुमत
आपका अपना सर्वर	आपकी वेब होस्टिंग पर	PHP के साथ होस्टिंग, हमारा कोड पैकेज	यदि सर्वर अनुमति देता है
सर्वर + Cloudflare R2	Cloudflare R2 क्लाउड स्टोरेज में	PHP के साथ होस्टिंग, एक Cloudflare खाता, हमारा कोड पैकेज	यदि सर्वर अनुमति देता है

कैटलॉग कॉन्फ़िगरेशन

सभी मीडिया स्रोत प्लेयर फ़ोल्डर plugins\catalog\ में स्थित दो टेक्स्ट फ़ाइलों में वर्णित हैं। आप उन्हें सीधे Media Manager विंडो से Base और User बटनों से खोल सकते हैं। एक बार फ़ाइल सहेजने पर, विंडो स्वचालित रूप से परिवर्तनों को उठा लेती है।

catalog-base.txt: स्रोतों की एक सूची जो प्लेयर का प्रदर्शन करती है। यह फ़ाइल समय-समय पर प्लेयर अपडेट द्वारा बदली जाती है, इसलिए अपने स्वयं के परिवर्तन यहाँ न रखें: वे अगले अपडेट पर खो जाएँगे।
catalog-user.txt: आपकी अपनी सूची। अपडेट इसे कभी नहीं बदलते।

स्रोत चयन सूची में, स्रोत फ़ाइलों में जिस क्रम में हैं उसी क्रम में दिखाई देते हैं: पहले catalog-base.txt से सब कुछ, फिर catalog-user.txt से सब कुछ। यदि आपकी फ़ाइल में बेस फ़ाइल के समान नाम वाला कोई अनुभाग है, तो आपकी सेटिंग्स बेस वाली सेटिंग्स को बदल देती हैं।

फ़ाइल प्रारूप
प्रत्येक स्रोत वर्ग कोष्ठक में एक नाम से शुरू होता है, उसके बाद key = value के रूप में पंक्तियाँ आती हैं। # चिह्न के बाद कुछ भी टिप्पणी है। सामान्य सेटिंग्स फ़ाइल के शीर्ष पर, पहले अनुभाग से पहले लिखी जाती हैं:

# 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

तरीका 1: आपके कंप्यूटर पर एक फ़ोल्डर

सबसे आसान तरीका। प्लेयर फ़ोल्डर को स्कैन करता है और सभी वीडियो को प्रीव्यू के साथ कार्ड के रूप में दिखाता है। प्रीव्यू वीडियो के एक फ्रेम से लिए जाते हैं; 3D वीडियो के लिए बायाँ दृश्य उपयोग किया जाता है।

चरण 1. catalog-user.txt खोलें
Media Manager विंडो में, User बटन पर क्लिक करें।

चरण 2. एक सेक्शन जोड़ें

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

path: वीडियो वाले फ़ोल्डर का पूरा पथ।
recursive = 1: सबफ़ोल्डर भी शामिल करें। इस पंक्ति के बिना केवल फ़ोल्डर ही स्कैन होता है।
include: केवल वे वीडियो दिखाएँ जिनके शीर्षक में इनमें से कम से कम एक शब्द हो। वैकल्पिक।
exclude: वे वीडियो छिपाएँ जिनके शीर्षक में इनमें से कोई भी शब्द हो। वैकल्पिक।

चरण 3. फ़ाइल सहेजें
विंडो की स्रोत सूची में नया स्रोत चुनें। फ़ोल्डर हर बार चुने जाने पर स्कैन होता है, इसलिए नई फ़ाइलें तुरंत सूची में दिखाई देती हैं। यदि फ़ोल्डर मौजूद नहीं है, तो विंडो Folder not found दिखाती है।

* प्लेयर फ़ाइल नाम से 3D प्रारूप का पता लगाता है, उदाहरण के लिए movie_p.mp4 या movie SBS.mkv। यदि नाम में प्रारूप निर्दिष्ट नहीं है, तो प्लेयर का प्रारूप डिटेक्टर प्लेबैक के दौरान इसे निर्धारित करने का प्रयास करता है।

तरीका 2: एक YouTube चैनल

प्लेयर चयनित चैनल के वीडियो को कैटलॉग के रूप में दिखाता है और उन्हें ब्राउज़र के बिना चलाता है। शीर्षक में शब्दों के आधार पर फ़िल्टर आपको केवल 3D वीडियो रखने और बाकी हटाने देता है।

चरण 1. 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: चैनल का पता।
include / exclude: वीडियो शीर्षकों में वे शब्द जो तय करते हैं कि कौन से वीडियो दिखाए जाएँ और कौन से छिपाए जाएँ।
search_max: चैनल के अधिकतम कितने वीडियो देखे जाएँ।
search_limit: कैटलॉग में कितने मेल खाते वीडियो रखे जाएँ।

चरण 2. Rescan पर क्लिक करें
YouTube की बॉट सुरक्षा ट्रिगर होने से बचाने के लिए, प्लेयर कभी भी अपने आप चैनल स्कैन नहीं करता। विंडो खुलने पर यह सहेजी गई सूची दिखाती है। नए वीडियो केवल Rescan बटन से और सूची के अंत तक स्क्रॉल करने पर लोड होते हैं, हर बार ठीक उतने ही जितने विंडो में फ़िट होते हैं।

चरण 3. यदि YouTube आपसे पुष्टि करने को कहे कि आप बॉट नहीं हैं
यह विश्वविद्यालय और कार्यालय नेटवर्क पर और कुछ बड़े इंटरनेट प्रदाताओं के साथ होता है। Firefox ब्राउज़र में अपने YouTube खाते में साइन इन करें। इसके बाद प्लेयर वीडियो तक सामान्य रूप से पहुँचने के लिए इस साइन इन का उपयोग करेगा। अपनी catalog-user.txt के शीर्ष पर निम्न पंक्ति जोड़ें:

cookies = firefox

firefox के बजाय आप cookies.txt फ़ाइल का पथ दे सकते हैं। Chrome पर आधारित ब्राउज़र (Chrome, Edge, Opera, Brave) काम नहीं करेंगे: वे अपनी कुकीज़ एन्क्रिप्ट करते हैं, इसलिए प्लेयर उनका उपयोग नहीं कर सकता।

* जब YouTube पहुँच से इनकार करता है, तो प्लेयर अपने अनुरोधों को 30 मिनट के लिए रोक देता है। यह आपके IP पते को ब्लॉक होने से बचाता है। कुछ समय बाद यह रोक अपने आप हट जाती है।

विधि 3: आपकी वेब होस्टिंग पर एक निजी कैटलॉग

उन लोगों के लिए जो अपने 3D वीडियो दोस्तों, ग्राहकों या अपने दर्शकों को दिखाना चाहते हैं। वीडियो आपकी वेब होस्टिंग पर संग्रहीत होते हैं; प्लेयर सूची प्राप्त करता है और उन्हें केवल लॉगिन और पासवर्ड के साथ चलाता है। आप तय करते हैं कि कौन देख सकता है और किसे वीडियो सहेजने की अनुमति है। डेमो आज़माएँ, यह पहले से ही प्लेयर में शामिल है: S3D demo server

आपको क्या चाहिए
PHP और Apache के साथ एक साधारण सस्ता होस्टिंग प्लान (.htaccess समर्थन)। समर्पित सर्वर की आवश्यकता नहीं है।

कोड पैकेज: आपका अपना वीडियो सर्वर

चरण 1. पैकेज को अपनी होस्टिंग पर अपलोड करें
संग्रह को अनपैक करें और फ़ोल्डर को अपनी होस्टिंग पर कॉपी करें, उदाहरण के लिए /demo/ में। वीडियो इसके media फ़ोल्डर में जाते हैं।

चरण 2. config.php कॉन्फ़िगर करें
पैकेज फ़ोल्डर में config.php खोलें। यह एडमिन पैनल का फ़ाइल नाम और उसका प्रारंभिक पासवर्ड सेट करता है। साइट के सार्वजनिक रूप से सुलभ होने से पहले दोनों को बदलें।

चरण 3. उपयोगकर्ता जोड़ें
एडमिन पैनल में, पासवर्ड के साथ उपयोगकर्ता बनाएँ और चिह्नित करें कि उनमें से किसे वीडियो सहेजने की अनुमति है।

चरण 4. सर्वर का परीक्षण करें
Windows कमांड प्रॉम्प्ट में:

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

पहली पंक्ति में #private के साथ प्रतिक्रिया 200: सर्वर काम करता है। प्रतिक्रिया 403: गलत लॉगिन या पासवर्ड।

चरण 5. सर्वर को प्लेयर में जोड़ें

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

स्रोत चुनें और Rescan पर क्लिक करें। अगली बार विंडो खुलने पर, सूची कैश से ली जाती है और पृष्ठभूमि में ताज़ा की जाती है।

विधि 4: Cloudflare R2 + आपकी वेब होस्टिंग

Cloudflare आपकी फ़ाइलों को संग्रहीत करने और परोसने के लिए बहुत अनुकूल शर्तें प्रदान करता है: 10 GB तक मुफ़्त स्टोरेज और मुफ़्त आउटबाउंड ट्रैफ़िक, उससे अधिक पर उचित मूल्य निर्धारण। लॉगिन और पासवर्ड के लिए एक छोटा निजी होस्टिंग प्लान उपयोग करें, जबकि वीडियो स्वयं होस्टिंग पर नहीं बल्कि Cloudflare R2 क्लाउड स्टोरेज में संग्रहीत होते हैं। होस्टिंग केवल पासवर्ड जाँचती है और प्लेयर को लिंक देती है। वीडियो दर्शक तक सीधे R2 से जाता है, इसलिए बड़ी फ़ाइलें आपकी होस्टिंग पर न तो जगह लेती हैं और न ही ट्रैफ़िक। डेमो आज़माएँ, यह पहले से ही प्लेयर में शामिल है: Cloudflare-R2 demo video

Cloudflare R2
कोड पैकेज: R2 + video

चरण 1. एक R2 बकेट बनाएँ
Cloudflare डैशबोर्ड में, R2 object storage खोलें, एक बकेट बनाएँ और उसमें अपने वीडियो अपलोड करें।

चरण 2. एक एक्सेस कुंजी बनाएँ
R2 object storage में, Account Details के अंतर्गत, API Tokens के बगल में Manage पर क्लिक करें। अनुमतियाँ: Object Read only; बकेट: केवल आपका (Apply to specific buckets only); TTL: Forever। टोकन बनने के बाद, Access Key ID और Secret Access Key कॉपी करें। गोपनीय कुंजी केवल एक बार दिखाई जाती है।

चरण 3. पैकेज को अपनी होस्टिंग पर अपलोड करें
पैकेज फ़ोल्डर को अपनी होस्टिंग पर कॉपी करें, उदाहरण के लिए /cloudflare/ में। config.php में, Account ID, दोनों कुंजियाँ और बकेट का नाम दर्ज करें, साथ ही एडमिन पैनल का फ़ाइल नाम और उसका पासवर्ड भी।

चरण 4. उपयोगकर्ता जोड़ें और परीक्षण करें
विधि 3 की तरह ही: एडमिन पैनल में उपयोगकर्ता, curl कमांड के साथ एक परीक्षण।

चरण 5. सर्वर को प्लेयर में जोड़ें

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

* R2 कुंजी केवल होस्टिंग पर संग्रहीत होती है; दर्शकों को यह कभी नहीं मिलती। सर्वर 1 घंटे के लिए वैध अस्थायी वीडियो लिंक जारी करता है।

वीडियो सहेजना

यदि स्रोत सहेजने की अनुमति देता है, तो विंडो हेडर में एक Save चेकबॉक्स दिखाई देता है। जब इसे चेक किया जाता है, तो वीडियो चलते समय डिस्क पर भी लिखा जाता है: स्रोत अनुभाग के save_dir फ़ोल्डर में या, यदि वहाँ कोई सेट नहीं है, तो सामान्य save_dir में। YouTube चैनलों के वीडियो हमेशा सहेजे जा सकते हैं। एक निजी सर्वर केवल उन उपयोगकर्ताओं के लिए सहेजने की अनुमति देता है जिन्हें सर्वर स्वामी ने अनुमति दी है। स्थानीय फ़ोल्डर में सहेजने का कोई विकल्प नहीं है, क्योंकि फ़ाइलें पहले से ही आपके कंप्यूटर पर हैं।

निजी सर्वर से अनुमति सूची के साथ आती है जब आप Rescan पर क्लिक करते हैं। जब तक Rescan पर क्लिक नहीं किया जाता, विंडो चेकबॉक्स के बजाय No save दिखाती है।

समस्या निवारण

यदि सूची खाली है, तो Media Manager विंडो कारण दिखाती है।

No cache: press Rescan
स्रोत कभी लोड नहीं हुआ है। Rescan पर क्लिक करें।

Folder not found
फ़ोल्डर मौजूद नहीं है। path में पथ जाँचें।

Wrong user or password
सर्वर ने लॉगिन या पासवर्ड अस्वीकार कर दिया। user और password जाँचें।

Too many attempts, wait 15 min
लगातार बहुत अधिक विफल लॉगिन प्रयास हुए। 15 मिनट प्रतीक्षा करें।

Server not responding
कोई नेटवर्क कनेक्शन नहीं है, या url में दिया गया पता गलत है।

YouTube: requests refused
YouTube ने अनुरोधों को संदिग्ध माना। cookies = firefox सक्षम करें और रुकावट समाप्त होने तक प्रतीक्षा करें।