Package: webp3
What is WebP3? (use case)WebP3 is a humble web-app (server) to play your audio files remotely.Typically, you host WebP3 on your personal home machine (or server) where your music files sit, and you can then listen to the music remotely at your workplace or on a handheld device in your browser.
It's designed for personal use.No, there aren't any user-data-exploiting/social features and no, it's not hosted on some million-dollars cloud, it's hosted on your machine or your server.DesignWebP3 exposes a tree of folders and files that can be browsed through the web interface.
A few root directories are specified on the command-line to run WebP3, and all the content under those roots is simply exposed on the web interface, as there are no fine-grained permissions.An HTML5 player allows to play the audio files from a requested dir.It is designed to serve trees where a folder is an album (or contains other folders). ID3 is not necessary as it's not used.Audio format supportWebP3 doesn't use Flash and solely relies on HTML5's<audio>tag. So, audio file format support (like MP3) depends on your viewing browser and OS.JSONWhenapplication/jsonmimetype is present in theAcceptHTTP header, the listing of the browsed directory is returned in JSON format.M3UWhenaudio/x-mpegurlmimetype is present in theAcceptHTTP header, or if the URL ends with?m3u, the listing of files the browsed directory is returned in M3U playlist format.
Thus, the URL can be given to an audio player like VLC.UsagePodman/DockerWebP3 can be run as a container: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/webp3If you want to have several music directories that are not under the same parent dir, add several volumes to/mediasubdirectories: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/webp3Standalone serverFirst, run something like:webp3.py -p 8000 music=/path/to/some/files music2=/another/folder/to/shareThe command will not terminate, the files are served as long as WebP3 is running.Openhttp://localhost:8000to see (and play!) the music.There will be 2 roots, /music and /music2, serving respectively the full content of /path/to/some/files and /another/folder/to/share.Command-line flags:-p PORTWebP3 will listen on port (default: 8000)Single rootIf it's not needed to have multiple roots, it's possible to run insteadwebp3.py -p 8000 --single-root /path/to/some/filesWSGIWebP3 can be set up to run as a WSGI app, for example to be served by an existing Apache instance.
When using WSGI, the mappings that were passed on command-line should now be placed in awebp3.conffile, with oneNAME=PATHentry per line.Using the documented script in theapachefolder, the installation is as follows:the WebP3 code and WSGI is typically in a path like /usr/lib/python3/dist-packages/webp3the Apache configuration is in /etc/apache2/sites-available/webp3.confthe WebP3 config indicating the locations of the music files is at /etc/webp3.confUsing an Apache instance to run the WebP3 WSGI allows:HTTPSserving the music tree under an URL prefixIf not using the default location, the config file can be passed in env variableWEBP3_CONF.DependenciesWebP3 is written in Python 3 and uses:Bottle web frameworkMako templatesSecurityWebP3 does not write files. However, it gives access to all files and folders contained in directories specified in its configuration.
Therefore, directory containing sensitive data should not be put in its configuration.WebP3 does not have by itself any authentication mechanism to restrict access to its content.
If this is desired a proxy should be used, or access can be configured in an existing WSGI server (like Apache).WebP3 reads files with the process' permissions. For example, if using WSGI, WebP3 will likely read files with thewww-datauser's permissions.
WebP3 does not follow symlinks.InstallOnPyPI:pipx install webp3LicenseWebP3 is licensed under thedo What The Fuck you want Public License v2.