webp3是一个不起眼的网络应用程序(服务器),用于远程播放音频文件。
通常,您将webp3托管在存放音乐文件的个人家用计算机(或服务器)上,然后您可以在工作场所或手持设备上的浏览器中远程收听音乐。它专为个人使用而设计。
不,没有任何用户数据利用/社交功能,也不,它不是托管在价值数百万美元的云上,而是托管在您的计算机或服务器上。
webp3公开了可以通过 Web 界面浏览的文件夹和文件树。在命令行上指定了一些根目录来运行webp3 ,这些根目录下的所有内容都简单地暴露在 Web 界面上,因为没有细粒度的权限。
HTML5 播放器允许播放请求目录中的音频文件。
它旨在为文件夹是相册(或包含其他文件夹)的树提供服务。 ID3 不是必需的,因为它没有被使用。
webp3 屏幕截图显示文件列表和上一个/暂停/下一个按钮" style="max-width: 100%;">
webp3仅依赖于 HTML5 的<audio>
标签。因此,音频文件格式支持(如 MP3)取决于您的查看浏览器和操作系统。
当Accept
HTTP 标头中存在application/json
mimetype 时,浏览目录的列表将以 JSON 格式返回。
当Accept
HTTP 标头中存在audio/x-mpegurl
mimetype 时,或者 URL 以?m3u
结尾时,浏览目录中的文件列表将以 M3U 播放列表格式返回。因此,可以将 URL 提供给 VLC 等音频播放器。
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 即可查看(并播放!)音乐。
将有 2 个根,/music 和 /music2,分别提供 /path/to/some/files 和 /another/folder/to/share 的完整内容。
命令行标志:
-p PORT
webp3将监听端口(默认:8000)
如果不需要有多个根,可以改为运行
webp3 .py -p 8000 --single-root /path/to/some/files
webp3可以设置为作为 WSGI 应用程序运行,例如由现有 Apache 实例提供服务。使用 WSGI 时,在命令行上传递的映射现在应放置在webp3 .conf
文件中,每行一个NAME=PATH
条目。
使用apache
文件夹中记录的脚本,安装如下:
使用 Apache 实例运行webp3 WSGI 允许:
如果不使用默认位置,则可以将配置文件传递到环境变量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 获得许可的。