Добавление видео

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

media manager

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

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

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

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

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

cookies = firefox

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

* Когда 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"

Ответ 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 предлагает очень выгодные условия для хранения и раздачи ваших файлов: до 10 ГБ хранилища бесплатно и бесплатный исходящий трафик, а сверх этого — умеренные цены. Используйте небольшой приватный хостинг для логинов и паролей, а сами видео хранятся в облачном хранилище Cloudflare 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); 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 и подождите, пока пауза закончится.