webp3 、オーディオ ファイルをリモートで再生するための謙虚な Web アプリ (サーバー) です。
通常、音楽ファイルが保存されている個人の家庭用マシン (またはサーバー) でwebp3ホストすると、その音楽を職場でリモートで聴いたり、ブラウザ内のハンドヘルド デバイスで聴くことができます。個人使用向けに設計されています。
いいえ、ユーザー データを悪用したりソーシャル機能はありません。また、数百万ドルのクラウドでホストされているわけではなく、ユーザーのマシンまたはサーバーでホストされています。
webp3 Web インターフェイスを通じて参照できるフォルダーとファイルのツリーを公開します。コマンドラインでwebp3実行するためにいくつかのルート ディレクトリが指定されますが、きめ細かい権限がないため、それらのルートの下にあるすべてのコンテンツが Web インターフェイスに公開されるだけです。
HTML5 プレーヤーを使用すると、要求されたディレクトリからオーディオ ファイルを再生できます。
これは、フォルダーがアルバムである (または他のフォルダーを含む) ツリーを提供するように設計されています。 ID3は使用しないので必要ありません。
ファイルのリストと前/一時停止/次のボタンを示す webp3 のスクリーンショット" style="max-width: 100%;">
webp3 HTML5 の<audio>
タグのみに依存します。したがって、オーディオ ファイル形式のサポート (MP3 など) は、表示しているブラウザーと OS によって異なります。
application/json
mimetype がAccept
HTTP ヘッダーに存在する場合、参照されたディレクトリのリストが JSON 形式で返されます。
audio/x-mpegurl
mimetype がAccept
HTTP ヘッダーに存在する場合、または 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 を開いて音楽を確認 (そして再生) してください。
/music と /music2 という 2 つのルートがあり、それぞれ /path/to/some/files と /another/folder/to/share の完全なコンテンツを提供します。
コマンドラインフラグ:
-p PORT
webp3ポート (デフォルト: 8000) でリッスンします。
複数のルートを持つ必要がない場合は、代わりに実行することができます。
webp3 .py -p 8000 --single-root /path/to/some/files
webp3 、たとえば既存の Apache インスタンスによって提供されるように、WSGI アプリとして実行するように設定できます。 WSGI を使用する場合、コマンドラインで渡されたマッピングは、1 行に 1 つのNAME=PATH
エントリを含むwebp3 .conf
ファイルに配置される必要があります。
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 Sex you want Public License v2 に基づいてライセンスされています。