webp3 adalah aplikasi web (server) sederhana untuk memutar file audio Anda dari jarak jauh.
Biasanya, Anda menghosting webp3 di mesin (atau server) rumah pribadi tempat file musik Anda berada, dan Anda kemudian dapat mendengarkan musik tersebut dari jarak jauh di tempat kerja atau di perangkat genggam di browser Anda. Ini dirancang untuk penggunaan pribadi.
Tidak, tidak ada fitur eksploitasi data pengguna/sosial dan tidak, ini tidak dihosting di cloud bernilai jutaan dolar, melainkan dihosting di mesin atau server Anda.
webp3 memperlihatkan pohon folder dan file yang dapat dijelajahi melalui antarmuka web. Beberapa direktori root ditentukan pada baris perintah untuk menjalankan webp3 , dan semua konten di bawah root tersebut hanya diekspos di antarmuka web, karena tidak ada izin yang rumit.
Pemutar HTML5 memungkinkan untuk memutar file audio dari direktori yang diminta.
Ini dirancang untuk menyajikan pohon di mana foldernya adalah album (atau berisi folder lain). ID3 tidak diperlukan karena tidak digunakan.
tangkapan layar webp3 menampilkan daftar file dan tombol sebelumnya/jeda/berikutnya" style="max-width: 100%;">
webp3 hanya mengandalkan tag <audio>
HTML5. Jadi, dukungan format file audio (seperti MP3) bergantung pada browser dan OS Anda.
Ketika mimetype application/json
ada di header Accept
HTTP, daftar direktori yang dijelajahi dikembalikan dalam format JSON.
Ketika mimetype audio/x-mpegurl
ada di header Accept
HTTP, atau jika URL diakhiri dengan ?m3u
, daftar file dari direktori yang dijelajahi dikembalikan dalam format playlist M3U. Dengan demikian, URL dapat diberikan ke pemutar audio seperti VLC.
webp3 dapat dijalankan sebagai wadah:
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
Jika Anda ingin memiliki beberapa direktori musik yang tidak berada di bawah direktori induk yang sama, tambahkan beberapa volume ke subdirektori /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
Pertama, jalankan sesuatu seperti:
webp3 .py -p 8000 music=/path/to/some/files music2=/another/folder/to/share
Perintah tidak akan berhenti, file disajikan selama webp3 berjalan.
Buka http://localhost:8000 untuk melihat (dan memutar!) musiknya.
Akan ada 2 root, /music dan /music2, yang masing-masing menyajikan konten lengkap /path/to/some/files dan /another/folder/to/share.
Bendera baris perintah:
-p PORT
webp3 akan mendengarkan pada port (default: 8000)
Jika tidak perlu memiliki banyak akar, Anda dapat menjalankannya
webp3 .py -p 8000 --single-root /path/to/some/files
webp3 dapat diatur untuk dijalankan sebagai aplikasi WSGI, misalnya untuk dilayani oleh instance Apache yang sudah ada. Saat menggunakan WSGI, pemetaan yang diteruskan pada baris perintah sekarang harus ditempatkan di file webp3 .conf
, dengan satu entri NAME=PATH
per baris.
Menggunakan skrip yang terdokumentasi di folder apache
, instalasinya adalah sebagai berikut:
Menggunakan instance Apache untuk menjalankan webp3 WSGI memungkinkan:
Jika tidak menggunakan lokasi default, file konfigurasi dapat diteruskan dalam variabel env webp3 _CONF
.
webp3 ditulis dengan Python 3 dan menggunakan:
webp3 tidak menulis file. Namun, ini memberikan akses ke semua file dan folder yang terdapat dalam direktori yang ditentukan dalam konfigurasinya. Oleh karena itu, direktori yang berisi data sensitif tidak boleh dimasukkan ke dalam konfigurasinya.
webp3 sendiri tidak memiliki mekanisme autentikasi untuk membatasi akses ke kontennya. Jika diinginkan, proxy harus digunakan, atau akses dapat dikonfigurasi di server WSGI yang ada (seperti Apache).
webp3 membaca file dengan izin proses. Misalnya, jika menggunakan WSGI, webp3 kemungkinan akan membaca file dengan izin pengguna www-data
. webp3 tidak mengikuti symlink.
Di PyPI:
pipx install webp3
webp3 dilisensikan di bawah Lisensi Publik do What The Fuck you want v2.