Tater Assistant Docs
Core profile

Music Core

Tater Tube music library and live whole-home player with room-aware Sendspin playback across native and Echo satellites, stereo pairs, Sonos, and AirPlay.

Music library + player v3.6.1 12 settings Internal runtime
Core role

What this core is for

Music library + player

Highlights

Behavior in the current codebase

  • Pairs securely with Tater Tube Server using a Player PIN, then keeps its artists, albums, genres, tracks, and artwork available in Tater.
  • Browses Search, Genres, Artists, Albums, and AI-named Tater Recommendations in a responsive local Vue interface with provider artwork.
  • Keeps a persistent player visible with play, stop, previous, next, synchronized volume, speaker selection, shuffle, and a collapsible current track list.
  • Playback changes update live without loading screens, page refresh flicker, lost scroll position, or discarded in-progress settings.
  • An explicitly named room overrides the speaking satellite; otherwise Music Core can use the voice room, saved preferred room player, defaults, and Sonos-first automatic selection.
  • Tater Tube is the catalog and source; Music Core sends tracks through Sendspin v1 to supported native and Echo satellites, stereo pairs, and synchronized multi-room groups.
  • Grouped Music Core playback and AirPlay input share one Sendspin timeline with clean replacement, buffering, resampling, cancellation, completion, and restart behavior.
  • Capable Echo satellites receive track details, artwork, colors, progress, loudness, peaks, beat events, and spectrum data for now-playing screens and music-reactive LEDs.
  • Mixed Echo/native groups keep measured hardware compensation plus persistent per-satellite delay calibration, while protected Tater Tube streams stay private and reachable on the LAN.
  • Sonos and supported external media-player destinations remain available alongside the Sendspin satellite path.
  • Listening history feeds AI-named recommendation playlists and a compact selected-Person profile with favorite genres, artists, and recent tracks.
  • Music context is injected only when a Person is selected and that Person is the current trusted speaker; no selection means no prompt injection.
  • Continuous radio can extend a queue near its final tracks so a broad voice request keeps playing without stacking unrelated manual album queues.
  • Catalog sync, recommendations, prompt-profile generation, and continuous-radio refill appear in Settings -> System Tasks with next-run state and Run Now controls.
Related Verbas

Direct core support

This runtime component mainly handles orchestration rather than exposing its own direct Verba target.

Settings

Configuration schema

  • Catalog Sync Interval (sec) number

    How often Music Core refreshes artists, albums, genres, and tracks.

    Key: catalog_sync_interval_seconds Default: 900
  • Shuffle Broad Requests checkbox

    Shuffle genre, artist, and general music requests by default.

    Key: default_shuffle Default: True
  • Default Speakers text

    Fallback playback destinations when a room or speaking satellite is unavailable.

    Key: default_targets
  • Default Volume (%) number

    Starting volume for Tater satellite media sessions.

    Key: default_volume_percent Default: 75
  • Maximum Queue Tracks number

    Maximum number of matched tracks placed in one queue.

    Key: maximum_queue_tracks Default: 200
  • Default Mixed Sync Adjustment (ms) number

    Fine-tunes mixed Sonos and Tater satellite groups. Positive values delay satellites; negative values start them earlier.

    Key: mixed_sync_default_adjustment_ms Default: 0
  • Music Prompt Context checkbox

    Share the selected Person's compact music profile with Tater when that Person is speaking.

    Key: prompt_context_enabled Default: True
  • Music Profile Refresh (hours) number

    How often Music Core refreshes the selected Person's prompt-ready listening profile.

    Key: prompt_profile_interval_hours Default: 12
  • Recommendation Refresh (hours) number

    How often Music Core refreshes Tater Recommendations in the background.

    Key: recommendation_interval_hours Default: 12
  • Albums & Songs Per Playlist number

    Maximum recommended albums and songs in each playlist.

    Key: recommendation_items_per_playlist Default: 6
  • Recommendation Playlists number

    Number of AI-named recommendation playlists to prepare.

    Key: recommendation_playlist_count Default: 3
  • Tater Recommendations checkbox

    Use listening history and Tater's primary AI model to prepare named music mixes.

    Key: recommendations_enabled Default: True
Whole-home music

Browse once, then play naturally by voice or from the live player

Music Core keeps the Tater Tube library, room selection, active playback, history, and AI recommendations in one local surface.

Tater Tube ServerPlayer PINBackground sync

Pair Tater Tube Server

Pair once with a Player PIN and let Music Core build its local browse catalog.

  • Create a six-digit Player PIN in Tater Tube Server, then enter the server URL and PIN in Music Core.
  • Catalog sync collects artists, albums, genres, tracks, and artwork, then refreshes in the background on the configured interval.
  • Tater Tube setup and the player remain available from the same Core tab, with connection state shown clearly.
Room awarePreferred playerSonos first

Choose where it plays

Room context removes the need to ask which speaker when Tater already knows.

  • If a request names a room, that room wins. Otherwise the speaking satellite's room is used when available.
  • A preferred player saved for the room is selected before global defaults, and Sonos is preferred when automatic selection finds several compatible players.
  • The player-bar speaker button opens Tater Tube stream destinations with readable labels, including native satellites, stereo pairs, Sonos speakers/groups, AirPlay devices, and supported media-player outputs.
No reloadsTrack listSynced volume

Live queue and player

The persistent player changes in place and keeps the active album or mix easy to navigate.

  • Playing another album replaces the active track list instead of appending it to the previous one.
  • The current song stays highlighted; double-click another row to jump directly to it, or use previous/next without leaving the page.
  • Live Core events update only when playback state changes, preserving the selected browse tab, open track list, forms, and scroll position.
Sendspin v1Stereo pairMixed groups

Stereo and multi-room scenes

One Sendspin timeline can play through a calibrated stereo pair or a mixed native-and-Echo group.

  • Native and Echo members follow the same synchronized media timeline; stereo pairs retain left/right routing, level, and delay calibration.
  • Persistent per-satellite output delay tightens alignment in mixed groups without discarding each board's measured hardware compensation.
  • Sonos groups can be formed temporarily, then restored without permanently disturbing the listener's queue or prior grouping.
  • Voice replies, announcements, timers, and TTS take priority locally, then release the player cleanly back to Sendspin at the intended music level.
PeopleListening historyRecommendations

Personalized music context

A selected Person can receive better music suggestions without sharing that profile with everyone.

  • Music Core records recent listening and can generate favorite genres, favorite artists, recent tracks, and a short taste summary for one selected Person.
  • The prompt fragment is only added when Tater resolves the current speaker to that same Person; leaving the setting empty disables music prompt injection.
  • Tater Recommendations choose exact items from the current catalog and publish friendly AI-named mixes that can be played directly from the browser.
Back to cores Verbas Portals Tater Voice Cores Home