docs: Clarify alternative to non-functional /trackInfo endpoint

- Specify that '/now_playing' endpoint is the API alternative
- Clarify that CLI 'now' command (playback status) is the CLI alternative
- Distinguish between the two 'now' CLI commands (playback vs clock)
- Update warning messages to be more specific about alternatives
This commit is contained in:
Tobias Gesellchen
2026-01-11 00:17:45 +01:00
parent 0e6dffead0
commit fb6e67cd86
3 changed files with 5 additions and 4 deletions
+2 -1
View File
@@ -235,7 +235,8 @@ func getTrackInfo(c *cli.Context) error {
clientConfig := GetClientConfig(c)
PrintDeviceHeader("Getting track information", clientConfig.Host, clientConfig.Port)
fmt.Println("⚠️ WARNING: /trackInfo endpoint times out on real devices. Use 'now' command instead.")
fmt.Println("⚠️ WARNING: /trackInfo endpoint times out on real devices.")
fmt.Println(" Use 'soundtouch-cli now' (playback status) command instead for track information.")
client, err := CreateSoundTouchClient(clientConfig)
if err != nil {
+1 -1
View File
@@ -223,7 +223,7 @@ func main() {
// Track info
{
Name: "track",
Usage: "Get track information (WARNING: times out on real devices, use 'now' instead)",
Usage: "Get track information (WARNING: times out on real devices, use playback 'now' command instead)",
Action: getTrackInfo,
Before: RequireHost,
},
+2 -2
View File
@@ -286,9 +286,9 @@ Checks if bass customization is supported on the device.
### GET /trackInfo ❌ **Not Working**
Gets track information (duplicate of `/now_playing` per official API).
**Status**: Documented in official API but times out on real devices (AllegroWebserver timeout). Use `/now_playing` instead.
**Status**: Documented in official API but times out on real devices (AllegroWebserver timeout). Use `/now_playing` endpoint instead for track information.
**Implementation**: Available via `GetTrackInfo()` method but not functional on hardware.
**Implementation**: Available via `GetTrackInfo()` method but not functional on hardware. Use `GetNowPlaying()` method instead.
### Zone Slave Management ✅ **Implemented**
Both official low-level endpoints and high-level zone management are available: