Tater Assistant Docs
Core profile

Music Core

Tater Tube music library and live whole-home player with room-aware routing, recommendations, stereo pairs, Sonos, AirPlay, and synchronized native satellites.

Music library + player v3.4.6 16 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.
  • Targets include native satellites, stereo pairs, synchronized multi-satellite scenes, Sonos, AirPlay, Home Assistant, and compatible integration media players.
  • Mixed Sonos/native groups use shared start timing plus an adjustable offset, while protected Tater Tube streams stay private and reachable on the LAN.
  • 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

  • AirPlay Receiver checkbox

    Let Apple devices send live audio to selected Tater Native, Sonos, and AirPlay speakers.

    Key: airplay_receiver_enabled Default: False
  • AirPlay Receiver Name text

    The name advertised in the AirPlay speaker picker.

    Key: airplay_receiver_name Default: Tater Music
  • AirPlay Pairing PIN password

    Optional fixed four-digit PIN used when a device pairs for the first time.

    Key: airplay_receiver_pin
  • AirPlay Destinations text

    Tater Native satellites, stereo pairs, AirPlay-capable Sonos players, or AirPlay speakers that play incoming audio.

    Key: airplay_receiver_targets
  • 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 every available satellite, stereo pair, Sonos speaker/group, and standard integration media player with readable labels.
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.
Stereo pairNative syncMixed groups

Stereo and multi-room scenes

One request can play through a calibrated stereo pair or a larger synchronized group.

  • Native members prebuffer the same media and start from a shared clock; stereo pairs retain left/right routing, level, and delay calibration.
  • Sonos groups can be formed temporarily, then restored without permanently disturbing the listener's queue or prior grouping.
  • Music remains a persistent session while voice replies play as ducked overlays and restore the original music level afterward.
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