webp3

Что такое webp3 ? (вариант использования)

webp3 — это скромное веб-приложение (сервер) для удаленного воспроизведения аудиофайлов.

Обычно вы размещаете webp3 на своем личном домашнем компьютере (или сервере), где находятся ваши музыкальные файлы, а затем можете слушать музыку удаленно на своем рабочем месте или на портативном устройстве в своем браузере. Он предназначен для личного использования.

Нет, здесь нет никаких функций использования пользовательских данных/социальных функций, и нет, он не размещается в каком-то облаке за миллион долларов, он размещается на вашем компьютере или вашем сервере.

Дизайн

webp3 предоставляет дерево папок и файлов, которые можно просматривать через веб-интерфейс. В командной строке для запуска webp3 указывается несколько корневых каталогов, и все содержимое этих корневых каталогов просто отображается в веб-интерфейсе, поскольку нет детальных разрешений.

Проигрыватель HTML5 позволяет воспроизводить аудиофайлы из запрошенного каталога.

Он предназначен для обслуживания деревьев, в которых папка является альбомом (или содержит другие папки). ID3 не требуется, поскольку он не используется.

Снимок экрана webp3, показывающий список файлов и кнопки «Предыдущий/Пауза/Далее» style="max-width: 100%;">

Поддержка аудиоформатов

webp3 опирается исключительно на тег HTML5 <audio> . Таким образом, поддержка формата аудиофайлов (например, MP3) зависит от вашего браузера просмотра и операционной системы.

JSON

Если mimetype application/json присутствует в HTTP-заголовке Accept , список просматриваемого каталога возвращается в формате JSON.

М3У

Когда mimetype audio/x-mpegurl присутствует в HTTP-заголовке Accept или если URL-адрес заканчивается на ?m3u , список файлов в просматриваемом каталоге возвращается в формате списка воспроизведения M3U. Таким образом, URL-адрес можно передать аудиоплееру, например VLC.

Использование

Подман/Докер

webp3 можно запустить как контейнер:

webp3_BASE_URL=https://your.example/webp3/ -v /path/to/some/files:/media:ro -p 8000:8000 registry.gitlab.com/hydrargyrum/ webp3 ">

 podman run --rm -d 
    -e webp3 _BASE_URL=https://your.example/webp3/ 
    -v /path/to/some/files:/media:ro 
    -p 8000:8000 
    registry.gitlab.com/hydrargyrum/ webp3

Если вы хотите иметь несколько музыкальных каталогов, которые не находятся в одном родительском каталоге, добавьте несколько томов в подкаталоги /media :

 podman run --rm -d -v /path/to/some/files:/media/first:ro -v /another/folder/to/share:/media/second:ro -p 8000:8000 registry.gitlab.com/hydrargyrum/ webp3

Автономный сервер

Сначала запустите что-то вроде:

 webp3 .py -p 8000 music=/path/to/some/files music2=/another/folder/to/share

Команда не завершится, файлы будут обслуживаться до тех пор, пока работает webp3 .

Откройте http://localhost:8000, чтобы увидеть (и воспроизвести!) музыку.

Будет два корня, /music и /music2, служащие соответственно полному содержимому /path/to/some/files и /another/folder/to/share.

Флаги командной строки:

 -p PORT

webp3 будет прослушивать порт (по умолчанию: 8000)

Один корень

Если не требуется иметь несколько корней, вместо этого можно запустить

 webp3 .py -p 8000 --single-root /path/to/some/files

WSGI

webp3 можно настроить для работы в качестве приложения WSGI, например, для обслуживания существующим экземпляром Apache. При использовании WSGI сопоставления, переданные в командной строке, теперь должны быть помещены в файл webp3 .conf с одной записью NAME=PATH в каждой строке.

Используя документированный скрипт в папке apache , установка выглядит следующим образом:

• код webp3 и WSGI обычно находятся в пути типа /usr/lib/python3/dist-packages/ webp3
• конфигурация Apache находится в файле webp3 .
• конфигурация webp3 указывающая расположение музыкальных файлов, находится в webp3

Использование экземпляра Apache для запуска WSGI webp3 позволяет:

• HTTPS
• предоставление музыкального дерева под префиксом URL

Если вы не используете местоположение по умолчанию, файл конфигурации можно передать в переменной env webp3 _CONF .

Зависимости

webp3 написан на Python 3 и использует:

• Веб-фреймворк для бутылок
• Шаблоны Мако

Безопасность

webp3 не записывает файлы. Однако он предоставляет доступ ко всем файлам и папкам, содержащимся в каталогах, указанных в его конфигурации. Поэтому в его конфигурации не следует помещать каталог, содержащий конфиденциальные данные.

webp3 сам по себе не имеет механизма аутентификации для ограничения доступа к своему содержимому. Если это желательно, следует использовать прокси-сервер или доступ можно настроить на существующем сервере WSGI (например, Apache).

webp3 читает файлы с разрешениями процесса. Например, при использовании WSGI webp3 , скорее всего, будет читать файлы с разрешениями пользователя www-data . webp3 не следует по символическим ссылкам.

Установить

В PyPI:

 pipx install webp3

Лицензия

webp3 распространяется под лицензией Do What The Fuck You Want Public License v2.