feat: add a built-in browser test client

- serve a single-page client at /ui (and redirect / to it)
- login, folder switch, album grid, album songs, search and streaming
- enabled by default, disable with WEB_UI=false
- document the test client and WEB_UI
This commit is contained in:
TapTap committed 2026-11-13 12:45:41 +00:00
1 parent 1571ec65ff
commit 26d31834a5
5 files changed
+334 -1

No files matched your search

+6 -1
View File
@@ -75,7 +75,7 @@ Or build and run the fat JAR:
java -jar build/libs/musicmanager-0.1.0-all.jar
```
The server listens on `http://localhost:8080`. Override with `PORT`, `DATA_DIR`, `LIBRARY_CONFIG`, `USERS_FILE` and `FFMPEG_PATH` (see Section 6.3). The SQLite database and cover cache are written to `./data`.
The server listens on `http://localhost:8080`. Open `http://localhost:8080/ui` for the built-in test client (log in with a user from `users.yaml`). Override with `PORT`, `DATA_DIR`, `LIBRARY_CONFIG`, `USERS_FILE`, `FFMPEG_PATH` and `WEB_UI` (see Section 6.3). The SQLite database and cover cache are written to `./data`.
On first start, the server scans automatically because the database is empty. After that, scans are manual.
@@ -95,6 +95,10 @@ For quick manual testing you can pass the password in plaintext instead: `&p=cha
### 6. Connect a client (Symfonium)
For a quick browser check, open `http://localhost:8080/ui` and log in with a user from `users.yaml`. It lists folders, albums and songs and can play streams; it is a debugging aid, not a full music client.
For a real client:
1. Add a new **Subsonic** server.
2. URL: `http://<host>:8080` (or `https://subsonic.tap-tap.win` when deployed).
3. Username and password from `users.yaml`.
@@ -510,6 +514,7 @@ users:
| `LIBRARY_CONFIG` | `./config/library.yaml` | Library folder definitions |
| `USERS_FILE` | `./config/users.yaml` | Vault-managed users file |
| `FFMPEG_PATH` | `ffmpeg` | ffmpeg binary used for transcoding |
| `WEB_UI` | `true` | Serve the built-in test client at `/ui` |
### 6.4 Local development