zara-media: media playback, queues and recommendations bridge #14

New issue

Closed

opened 2026-08-31 18:43:58 +00:00 by lost-rob0t · 0 comments

lost-rob0t commented

2026-08-31 18:43:58 +00:00

(Migrated from github.com)

Plugin

zara-media

Goal

Give Zara a provider-neutral media-control domain for music, video and podcasts without baking a specific player/service into Zara core.

Initial capabilities

inspect current playback state;
play/pause/stop/seek/skip;
volume and mute control;
list/select active player/device;
queue/list/reorder media;
search local/provider catalogs through adapters;
expose track/episode/title/artist/show metadata;
optionally build “play something like this” queries from structured metadata.

Integrations

zara-desktop may provide OS/media-key backends;
zara-context can consume current media state;
provider-specific catalog/search adapters remain behind the normalized media model.

Safety / reliability

commands target an explicit player/device when ambiguity exists;
provider auth/tokens are never included in normal tool output;
queues/results are bounded;
mutations return observed playback/queue state where possible.

Acceptance criteria

normalized player/playback/media-item model exists
playback and queue operations work through fake backends
multiple players/devices are representable
active media state can feed zara-context
catalog/provider adapters do not leak into the core schema
tests require no audio/video device or network
README documents backend model
registry validation, plugin tests and nix flake check pass

## Plugin `zara-media` ## Goal Give Zara a provider-neutral media-control domain for music, video and podcasts without baking a specific player/service into Zara core. ## Initial capabilities - inspect current playback state; - play/pause/stop/seek/skip; - volume and mute control; - list/select active player/device; - queue/list/reorder media; - search local/provider catalogs through adapters; - expose track/episode/title/artist/show metadata; - optionally build “play something like this” queries from structured metadata. ## Integrations - `zara-desktop` may provide OS/media-key backends; - `zara-context` can consume current media state; - provider-specific catalog/search adapters remain behind the normalized media model. ## Safety / reliability - commands target an explicit player/device when ambiguity exists; - provider auth/tokens are never included in normal tool output; - queues/results are bounded; - mutations return observed playback/queue state where possible. ## Acceptance criteria - [ ] normalized player/playback/media-item model exists - [ ] playback and queue operations work through fake backends - [ ] multiple players/devices are representable - [ ] active media state can feed `zara-context` - [ ] catalog/provider adapters do not leak into the core schema - [ ] tests require no audio/video device or network - [ ] README documents backend model - [ ] registry validation, plugin tests and `nix flake check` pass