Libras is a browser-based minimalistic music player that connects to your own music server. Browse your library, play music, and download tracks to take with you.
Named after “3 Libras” by A Perfect Circle.
- Browse artists, albums, and tracks.
- Stream music from your own server.
- Download music for offline playback and manage it in Settings → Downloads.
- Restore your playback queue and position between sessions.
- Install as a standalone web app.
- Open Libras.
- Connect to your music server with your server address, username, and password.
- Browse your library and start listening.
Just trying it out? Connect to the Navidrome demo server using https://demo.navidrome.org as the server address and demo as both the username and password.
You'll need a reachable HTTPS server with a Subsonic-compatible API, such as Navidrome, supporting OpenSubsonic's empty-query search3 for library synchronization and configured to allow browser requests from https://libras-music.app (CORS). Libras is a player, not a music hosting service; bring your own server and library.
Safari 26.0 or newer is required; older Safari versions are not supported. The app uses native URLPattern and OPFS writable files. Safari 26.0–26.1 load Navigation API and invoker commands polyfills on demand; Safari 26.2+ use the native APIs. The dialog closedby polyfill and relative rgb() colors remain necessary for Safari 26. The standalone styleguide uses native browser features without polyfills.
Libras tries salted token authentication first; your password stays in the browser for that attempt. Only a structured server rejection of token authentication (Subsonic code 41 or 42) automatically retries the same username and password over HTTPS, including on localhost. Invalid credentials, connection failures, and other errors never trigger a password retry.
Credentials persist in localStorage until you disconnect. Token login saves the username, token, and salt, not your password. Successfully verified direct-password login saves the actual password and sends it with subsequent requests, including artwork and streaming URLs. HTTPS encrypts transport, not localStorage; scripts running on the app's origin and anyone with access to your browser profile can read saved credentials. Use a trusted device and server, and disconnect on shared devices. Disconnect removes credentials but retains your offline account, music, and queue.
You can use Libras in your browser or install it as a standalone web app:
- iPhone/iPad: Open in Safari, then choose Share → Add to Home Screen.
- Android: Choose Install app / Add to home screen from the browser menu.
- Desktop: Use the browser's install option, where available.
Installation options vary by browser and device. Offline storage and background playback have not yet been verified on iOS.
Download music while online, then switch to Offline Library to listen without a connection.
- Manage downloads: Settings → Downloads.
- Refresh library: Automatic when opening online, or via Settings → Refresh library.
- Disconnect: Clears credentials and optionally deletes this account’s local cache and downloads. Remembered identity, preferences, other accounts and server data are unchanged. Close other Libras tabs before deleting local data.
- Storage: Each server/account has its own offline library, saved only in this browser on this device. Clearing site data deletes it.
An app-update button beside Settings appears when an update is ready. Open it and choose Update now to install it—this reloads the app and interrupts playback.
This is a pnpm workspace: the root libras package contains the app, and @libras/website contains the landing page and a standalone live demo at /demo/ that imports it. Run the website with pnpm --filter @libras/website dev, then open /demo/ for the player.
See CONTRIBUTING.md for local setup, checks, deployment, and storage architecture.
MIT © 2026 Bogdan Chadkin.
