Now Playing
Nothing playing
—
—
Library
Internet Radio
Current Queue
Playlists
Drag a playlist onto the calendar to schedule it. Durations are calculated based on tracks.
Playlists
Help Docs & Status
🖥️ Host System Resource Monitor
Real-time resource utilization and storage capacity of the host computer.
CPU Load
RAM Usage
Disk Capacity
🎵 Playback Modes Explanation
TTP Music Remote supports three distinct modes of playback. Here is how they differ and what you can do:
| Mode | Color Code | Description | Supported Features |
|---|---|---|---|
| Jukebox Mode | Purple (Library) | Standard manual queue playback mode. Command Navidrome to play specific tracks, albums, or search results directly from your local music collection. | Play/Pause, seek track, skip, shuffle queue, clear queue, volume change. |
| Radio Mode | Amber (Radio) | Fires up a custom background `mpv` player to stream live internet radio stations directly through the host soundcard. | Add custom radio streams, play/stop radio, volume control. Jukebox queue is paused. |
| Schedule Mode | Sky Blue (Schedule/Playlists) | Auto-pilot mode. Executes your calendar schedule background daemon, automatically loading and shuffling playlists at their designated hours. | Weekly schedule calendar, drag-and-drop playlists, automatic volume fade transitions, persistence across container reboots. |
Discover What You Can Do
Welcome to TTP Music Remote! This application acts as a remote control for your containerized Navidrome Jukebox. Here is a quick guide on what you can do:
- Unified Search & Library: Search and discover songs directly in the Library view. Click 'Clear' to restore your playlists/artists grid.
- Playlist Management: Create new playlists, delete playlists, add tracks to playlists from lists, and remove tracks inside a playlist.
- Local File Import: Drag & drop or browse local audio files right from the pop-up modal inside the Library tab to import them directly.
- Internet Radio: Stream live internet radio stations directly through the server's soundcard and save custom streams persistently.
- Queue Control: Clear, shuffle, or delete queue items and track playing states in real-time.
- Perceived Volume Sync: Linearized logarithmic ALSA volume mapping, synchronized seamlessly on both page sliders.
* Tip: Press Ctrl + Shift to toggle advanced Navidrome API Reference details!
🔒 Access Control Settings
Restrict remote control permissions to specific local IP addresses. Supports multiple IPs separated by commas or spaces. Other devices visiting the page will only be able to view the Now Playing screen (all playback controls, library tabs, and settings will be hidden).
* Leave the field blank and click Save to clear the lock and allow control from all devices.
* If you lock yourself out, delete the file /music/allowed_controller_ip.json on the server to reset permissions.
* Local container (Recommended): Set to http://cobalt:9000/ to route downloads internally through the self-hosted Cobalt service running alongside this app.
* Public alternative: Set to https://dog.kittycat.boo/ to route requests through a trusted public Cobalt instance. This is useful for bypassing Turnstile bot protections or Cloudflare blocks.
⚙️ Stack Management
Restart the music remote server stack services. This will reboot all containers (including database, worker, audio daemon, and backend) to restore stability and refresh status.
Navidrome API References
TTP Music Remote communicates with Navidrome using the Subsonic API standard. Below are the key endpoints integrated into the app:
| Functionality | Subsonic API Method | Proxy Endpoint |
|---|---|---|
| Search Music | rest/search3 |
/api/search |
| Get Artists List | rest/getArtists |
/api/artists |
| Get Artist Details | rest/getArtist |
/api/artist/{id} |
| Get Album Details | rest/getAlbum |
/api/album/{id} |
| Get Playlists | rest/getPlaylists |
/api/playlists |
| Get Playlist Details | rest/getPlaylist |
/api/playlist/{id} |
| Create Playlist | rest/createPlaylist |
/api/playlists/create |
| Add Song to Playlist | rest/createPlaylist (append) |
/api/playlists/{id}/add |
| Remove Song from Playlist | rest/updatePlaylist |
/api/playlists/{id}/remove |
| Delete Playlist | rest/deletePlaylist |
/api/playlists/{id}/delete |
| Add Custom Radio Station | Local JSON Persistence | /api/radio/add |
| Get Album / Artist Art | rest/getCoverArt |
/api/cover_art/{id} |
| Jukebox Control (Get/Set/Skip) | rest/jukeboxControl |
/api/status, /api/play, /api/pause, etc. |