webp3
1.0.0
webp3 ist eine einfache Web-App (Server) zum Abspielen Ihrer Audiodateien aus der Ferne.
Normalerweise hosten Sie webp3 auf Ihrem persönlichen Heimcomputer (oder Server), auf dem sich Ihre Musikdateien befinden, und können die Musik dann remote an Ihrem Arbeitsplatz oder auf einem Handheld-Gerät in Ihrem Browser anhören. Es ist für den persönlichen Gebrauch konzipiert.
Nein, es gibt keine Funktionen zum Ausnutzen von Benutzerdaten/sozialen Netzwerken und nein, es wird nicht in einer Millionen-Dollar-Cloud gehostet, sondern auf Ihrem Computer oder Server.
webp3 stellt eine Baumstruktur von Ordnern und Dateien bereit, die über die Weboberfläche durchsucht werden können. In der Befehlszeile werden einige Stammverzeichnisse angegeben, um webp3 auszuführen, und der gesamte Inhalt unter diesen Stammverzeichnissen wird einfach auf der Weboberfläche angezeigt, da es keine fein abgestuften Berechtigungen gibt.
Ein HTML5-Player ermöglicht die Wiedergabe der Audiodateien aus einem gewünschten Verzeichnis.
Es dient dazu, Bäume bereitzustellen, in denen ein Ordner ein Album ist (oder andere Ordner enthält). ID3 ist nicht erforderlich, da es nicht verwendet wird.
webp3-Screenshot mit einer Liste von Dateien und den Schaltflächen „Zurück/Pause/Weiter“ style="max-width: 100%;">
webp3 basiert ausschließlich auf dem <audio> -Tag von HTML5. Die Unterstützung von Audiodateiformaten (wie MP3) hängt also von Ihrem Anzeigebrowser und Ihrem Betriebssystem ab.
Wenn der Mimetyp application/json im HTTP-Header Accept vorhanden ist, wird die Auflistung des durchsuchten Verzeichnisses im JSON-Format zurückgegeben.
Wenn der Mimetyp audio/x-mpegurl im Accept HTTP-Header vorhanden ist oder die URL mit ?m3u endet, wird die Liste der Dateien im durchsuchten Verzeichnis im M3U-Wiedergabelistenformat zurückgegeben. Somit kann die URL an einen Audioplayer wie VLC übergeben werden.
webp3 kann als Container ausgeführt werden:
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
Wenn Sie mehrere Musikverzeichnisse haben möchten, die sich nicht im selben übergeordneten Verzeichnis befinden, fügen Sie mehrere Volumes zu /media Unterverzeichnissen hinzu:
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
Führen Sie zunächst Folgendes aus:
webp3 .py -p 8000 music=/path/to/some/files music2=/another/folder/to/share
Der Befehl wird nicht beendet, die Dateien werden bereitgestellt, solange webp3 ausgeführt wird.
Öffnen Sie http://localhost:8000, um die Musik zu sehen (und abzuspielen!).
Es wird zwei Roots geben, /music und /music2, die jeweils den vollständigen Inhalt von /path/to/some/files und /another/folder/to/share bereitstellen.
Befehlszeilenflags:
-p PORT
webp3 überwacht den Port (Standard: 8000)
Wenn es nicht erforderlich ist, mehrere Roots zu haben, ist es möglich, stattdessen auszuführen
webp3 .py -p 8000 --single-root /path/to/some/files
webp3 kann so eingerichtet werden, dass es als WSGI-App ausgeführt wird, beispielsweise um von einer vorhandenen Apache-Instanz bedient zu werden. Bei Verwendung von WSGI sollten die über die Befehlszeile übergebenen Zuordnungen jetzt in einer webp3 .conf Datei mit einem NAME=PATH Eintrag pro Zeile platziert werden.
Mit dem dokumentierten Skript im apache -Ordner läuft die Installation wie folgt ab:
Die Verwendung einer Apache-Instanz zum Ausführen des webp3 -WSGI ermöglicht Folgendes:
Wenn nicht der Standardspeicherort verwendet wird, kann die Konfigurationsdatei in der Umgebungsvariablen webp3 _CONF übergeben werden.
webp3 ist in Python 3 geschrieben und verwendet:
webp3 schreibt keine Dateien. Es gewährt jedoch Zugriff auf alle Dateien und Ordner, die in den in der Konfiguration angegebenen Verzeichnissen enthalten sind. Daher sollten Verzeichnisse mit vertraulichen Daten nicht in die Konfiguration aufgenommen werden.
webp3 selbst verfügt über keinen Authentifizierungsmechanismus, um den Zugriff auf seine Inhalte einzuschränken. Wenn dies gewünscht ist, sollte ein Proxy verwendet werden, oder der Zugriff kann in einem vorhandenen WSGI-Server (wie Apache) konfiguriert werden.
webp3 liest Dateien mit den Berechtigungen des Prozesses. Wenn Sie beispielsweise WSGI verwenden, wird webp3 wahrscheinlich Dateien mit den Berechtigungen des www-data Benutzers lesen. webp3 folgt keinen Symlinks.
Auf PyPI:
pipx install webp3
webp3 ist unter der do What The Fuck you want Public License v2 lizenziert.
