Подключение видео

В S3D Player есть кнопка Catalog. Она открывает Media Manager для быстрой работы с 3D роликами и картинками. Выбираете источник в списке, листаете карточки и запускаете ролик одним кликом. Источником может быть папка на вашем компьютере, канал YouTube или ваш собственный сервер с паролем. Источники описываются в простом текстовом файле конфигурации, их можно добавлять сколько угодно, без программирования.

media manager

Способы подключения

Плеер поддерживает четыре вида источников видео. Выберите тот, что подходит под вашу задачу. Их можно смешивать: в одном каталоге могут быть и разные папки на диске, хостинг и web серверы.

Способ	Где лежат ролики	Что нужно	Сохранение на диск
Папка на диске	На вашем компьютере	Только путь к папке	Не нужно, файлы уже ваши
Канал 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. Если в вашем файле есть секция с тем же именем, что и в базовом, ваши настройки заменяют базовые.

Формат файла
Каждый источник начинается с имени в квадратных скобках, под ним строки ключ = значение. Всё, что после знака #, считается комментарием. Общие настройки пишутся в начале файла, до первой секции:

# общие настройки
quality  = 1080      # 720 / 1080 / 2160
thumb    = max       # превью: mq / 720 / max
save_dir = D:\Video\Saved
cookies  = firefox   # вход в YouTube, см. раздел про YouTube

# источник
[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 просит подтвердить, что вы не бот
Так бывает в сетях университетов, офисов и у крупных провайдеров. Войдите в свой аккаунт YouTube в браузере Firefox. Это позволит использовать авторизацию для свободного просмотра видео в плеере. Добавьте в начало вашего catalog-user.txt строку:

cookies = firefox

Вместо firefox можно указать путь к файлу cookies.txt. Браузеры на основе Chrome (Chrome, Edge, Opera, Brave) не подходят: свои куки они шифруют, плеер не может их использовать для соединения.

* После отказа в доступе к YouTube, плеер сам делает паузу запросов на 30 минут. Это защищает ваш IP от блокировки. Пауза сама сбрасывается через некоторое время.

Способ 3: приватный каталог на вашем хостинге

Для тех, кто хочет показывать свои 3D ролики друзьям, клиентам или своей аудитории. Ролики лежат на вашем web хостинге, плеер получает их список и смотрит только по логину и паролю. Вы сами решаете, кому показывать и кому можно сохранять ролики себе. Попробуйте это демо, оно уже в сделано плеере: 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"

Ответ 200 и первая строка #private: сервер работает. Ответ 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 предлагает очень выгодные условия для размещения и показа ваших файлов. Бесплатное хранение до 20Гб без ограничения трафика раздачи. И далее очень умеренная оплата. Используйте маленький частный хостинг с логинами и паролями, но сами ролики лежат не на хостинге, а в облачном хранилище Cloudflare R2. Хостинг только проверяет пароль и выдаёт плееру ссылки. Видео идёт к зрителю прямо из R2, поэтому большие файлы не тратят место и трафик хостинга. У R2 нет платы за исходящий трафик. Попробуйте это демо, оно уже в сделано плеере как: Cloudflare-R2 demo video

Cloudflare R2
Пакет кода: R2 + video

Шаг 1. Создайте бакет R2
В панели Cloudflare откройте R2 object storage, создайте бакет и загрузите в него ролики.

Шаг 2. Создайте ключ доступа
R2 object storage, раздел Account Details, Manage рядом с API Tokens. Права: Object Read only, бакет: только ваш (Apply to specific buckets only), срок: Forever. После создания скопируйте Access Key ID и Secret Access Key. Secret показывают только один раз.

Шаг 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: отклонение запросов
YouTube посчитал запросы подозрительными. Включите cookies = firefox и подождите конца паузы.