/
/
/
1{
2 "config_entries": {
3 "connected_players": {
4 "label": "[%key:common::config_entries::connected_players::label%]",
5 "description": "The Music Assistant players to expose via Spotify Connect. Every selected player appears as its own device in the Spotify app; audio streamed to it plays on that player. Leave empty to keep the plugin idle."
6 },
7 "publish_name_template": {
8 "label": "[%key:common::config_entries::publish_name_template::label%]",
9 "description": "How each device shown in the Spotify app is named, based on the connected player's name."
10 },
11 "backend": {
12 "label": "Please pick the playback engine you'd like to use for Spotify Connect.",
13 "options": {
14 "soloist": "Spotify Soloist (official, recommended)",
15 "go_librespot": "go-librespot (community)"
16 },
17 "option_descriptions": {
18 "soloist": "Spotify's official playback engine. Setup takes a few extra steps and requires a Premium account to create a personal API key.",
19 "go_librespot": "Needs no API key or download, but is intended for accounts created before December 2024 and may stop working when Spotify changes its service."
20 }
21 },
22 "soloist_download_consent": {
23 "label": "I understand the above, and I allow Music Assistant to download, run, keep and automatically update Spotify Soloist from Spotify's servers"
24 },
25 "soloist_api_key": {
26 "label": "Soloist API key"
27 },
28 "soloist_api_key_hint": {
29 "label": "An API key is already configured. Leave the field below empty to keep using it."
30 },
31 "volume_mode": {
32 "label": "Spotify app volume behavior",
33 "description": "'Player volume only' keeps the volume slider in the Spotify app pinned at 100% so the audio always arrives untouched; you control the volume on the Music Assistant player instead. 'Sync Spotify app volume' keeps the Spotify app's volume slider and the player volume in sync, so you can use either. Note: with volume sync, a large upward volume jump in the Spotify app can cause a very brief loud artifact while the volume correction catches up.",
34 "options": {
35 "player_only": "Player volume only (quality-first, default)",
36 "sync_spotify": "Sync Spotify app volume"
37 }
38 },
39 "crossfade_duration": {
40 "label": "Crossfade duration (seconds)",
41 "description": "Fade between tracks for the given number of seconds (0 disables crossfade). The crossfade is applied by the Spotify playback engine itself, so exactly which track transitions fade is up to Spotify."
42 },
43 "loudness_normalization": {
44 "label": "Loudness normalization",
45 "description": "Let Spotify play all tracks at a similar loudness level (Spotify's 'Normalize volume' feature). Disable to receive the audio without Spotify's loudness adjustment."
46 },
47 "audio_quality": {
48 "label": "Streaming quality",
49 "description": "The highest quality Spotify is asked to stream. This is a ceiling, not a promise: Spotify still picks something lower when the connection is slow, when a track has no file at this quality, or when your account does not include it. Lossless needs a Spotify plan that offers it, and is only available on the Spotify Soloist engine - go-librespot streams 320 kbps at most.",
50 "options": {
51 "normal": "Normal (about 96 kbps)",
52 "high": "High (about 160 kbps)",
53 "very_high": "Very high (about 320 kbps)",
54 "lossless": "Lossless (Spotify Soloist engine only)"
55 }
56 }
57 },
58 "setup_flow": {
59 "backend": {
60 "title": "Choose a playback engine",
61 "description": "Spotify Connect can run on two different playback engines:"
62 },
63 "soloist_terms": {
64 "title": "About Spotify Soloist",
65 "description": "Spotify Soloist is Spotify's official playback engine for devices without a screen. Music Assistant may not distribute it as part of its own installation â so if you continue, it is downloaded from Spotify's servers on your behalf and run for you.\n\nPlease read this before you continue:\n\n- You need a Spotify **Premium** account to create the required API key. This is a short manual step on the Spotify developer website, explained on the next screen.\n- Spotify's terms do not clearly allow using Soloist this way. Using it through Music Assistant may violate Spotify's Terms of Service and is entirely at your own risk.\n- Music Assistant will download the Soloist app from Spotify's servers, run it, keep it on disk, and automatically replace it whenever Spotify publishes an update.\n\nMore information: [Soloist documentation](https://developer.spotify.com/documentation/soloist) · [API key page](https://developer.spotify.com/dashboard/soloist) · [Spotify developer policy](https://developer.spotify.com/policy)"
66 },
67 "soloist_api_key": {
68 "title": "Create your Soloist API key",
69 "description": "Soloist needs a personal API key, created with a Spotify **Premium** account:\n\n1. Open the [Soloist API key page](https://developer.spotify.com/dashboard/soloist) and sign in with your Spotify account.\n2. Accept Spotify's terms if you are asked to.\n3. Choose **Generate API Key**.\n4. Copy the key and paste it below.\n\nMusic Assistant stores the key encrypted and only shares it with the Soloist app. Your Spotify username and password are never asked for."
70 }
71 },
72 "errors": {
73 "not_active_device": "'{0}' is not the active Spotify playback device. Open the Spotify app, select it as the playback device, and try again.",
74 "soloist_consent_required": "Spotify Soloist can only be used after you allow the download. Select Spotify Soloist again to review that step, or choose go-librespot (community) instead.",
75 "soloist_api_key_invalid": "This does not look like a complete API key. Copy the entire key from the Spotify page and paste it again.",
76 "soloist_unsupported_platform": "Spotify Soloist is not available for this system. Choose go-librespot (community) instead.",
77 "soloist_download_failed": "The Spotify Soloist app could not be downloaded from Spotify. Check the server's internet connection and try again.",
78 "soloist_invalid_archive": "The Spotify Soloist app downloaded from Spotify could not be used. Try again later.",
79 "soloist_build_expired": "Spotify's current Soloist app version has expired and no newer version is available yet. Try again later."
80 },
81 "manifest": {
82 "description": "Makes a Music Assistant player appear as a device in the official Spotify app via Spotify Connect."
83 }
84}
85