/
/
/
1{
2 "config_entries": {
3 "client_id": {
4 "label": "Client ID (optional)"
5 },
6 "sync_podcast_progress": {
7 "label": "Sync Podcast Progress from Spotify",
8 "description": "Automatically sync episode played status from Spotify to Music Assistant. Episodes marked as played in Spotify will be marked as played in MA. Only enable this if you use both the Spotify app and Music Assistant for podcast playback."
9 },
10 "sync_audiobook_progress": {
11 "label": "Sync Audiobook Progress from Spotify",
12 "description": "Automatically sync audiobook progress from Spotify to Music Assistant. Progress from Spotify app will sync to MA when audiobooks are accessed. Only enable this if you use both the Spotify app and Music Assistant for audiobook playback."
13 },
14 "playback_auth_method": {
15 "label": "How do you want to allow playback?",
16 "options": {
17 "spotify_app": "Use the Spotify app (recommended)",
18 "browser": "Use a web browser instead"
19 }
20 },
21 "playback_callback_url": {
22 "label": "Address of the error page"
23 },
24 "use_developer_key": {
25 "label": "Use my own Spotify developer key (advanced, optional)"
26 },
27 "playback_backend": {
28 "label": "How should Music Assistant play Spotify audio?",
29 "options": {
30 "soloist": "Spotify Soloist (official)",
31 "librespot": "librespot (community)"
32 },
33 "option_descriptions": {
34 "soloist": "Spotify's official playback engine. It works with all Premium Spotify accounts but requires a personal API key and a few extra setup steps.",
35 "librespot": "Simpler to set up and quicker to start, but relies on reverse-engineered Spotify internals and primarily works for accounts created before December 2024."
36 }
37 },
38 "soloist_download_consent": {
39 "label": "I understand the above, and I allow Music Assistant to download, run, keep and automatically update Spotify Soloist from Spotify's servers"
40 },
41 "soloist_api_key": {
42 "label": "Soloist API key"
43 },
44 "soloist_api_key_hint": {
45 "label": "An API key is already configured. Leave the field below empty to keep using it."
46 },
47 "soloist_repair": {
48 "label": "Pair again with the Spotify app (replaces the current pairing)"
49 },
50 "audio_quality": {
51 "label": "Streaming quality",
52 "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. Takes effect the next time playback starts.",
53 "options": {
54 "normal": "Normal (about 96 kbps)",
55 "high": "High (about 160 kbps)",
56 "very_high": "Very high (about 320 kbps)",
57 "lossless": "Lossless"
58 }
59 },
60 "spotify_normalization": {
61 "label": "Enable Spotify's volume normalization",
62 "description": "Let Spotify even out the loudness between songs instead of Music Assistant. Spotify uses values it has computed for its whole catalogue and will not push a quiet song past the headroom it has left, and songs start quicker because Music Assistant does not have to measure them. Turn it off to have Music Assistant normalize instead, the same way it does for every other music source. Either way, this only applies while volume normalization is enabled for the player."
63 }
64 },
65 "setup_flow": {
66 "abort": {
67 "account_already_configured": "This Spotify account is already set up in Music Assistant. Each account can only be added once â sign in with a different account, or reconfigure the existing one instead.",
68 "premium_required": "A Spotify Premium account is required to use Spotify within Music Assistant. Sign in with a Premium account, or upgrade this one, and try again."
69 },
70 "authenticate": {
71 "title": "Connect your Spotify account",
72 "description": "A browser window will open so you can sign in to Spotify and authorize Music Assistant. Come back here once you're done."
73 },
74 "developer": {
75 "title": "Use your own Spotify developer key",
76 "description": "1. Open the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard) and create an app.\n\n2. Register this address as a redirect URI for that app:\n`{0}`\n\n3. Copy the app's Client ID and paste it below.\n\nLeave the field empty to keep using the shared key."
77 },
78 "authenticate_dev": {
79 "title": "Authorize your Spotify app",
80 "description": "A browser window will open to authorize Music Assistant against your own Spotify app."
81 },
82 "playback_auth": {
83 "title": "Allow Music Assistant to play Spotify audio",
84 "description": "Playing audio needs a separate one-time approval from Spotify, on top of the sign-in you just completed.\n\n**Use the Spotify app (recommended)** â pick this if you have Spotify on a phone, tablet or computer on the same network as Music Assistant. It takes a few taps and there is nothing to copy or paste.\n\n**Use a web browser instead** â pick this if Music Assistant Pairing will not show up in your Spotify app, for example when it runs on another network or VLAN, or in a container without access to your home network. It takes a couple of extra steps."
85 },
86 "playback_browser_open": {
87 "title": "Approve playback in your browser",
88 "description": "Press the button below to open Spotify, sign in if asked, then press Agree.\n\nIf your browser runs on the same machine as Music Assistant, this screen continues by itself.\n\nOtherwise your browser lands on a page that fails to load, showing something like \"This site can't be reached\". That is expected and means it worked. Copy the address of that page, then come back here: this screen switches to a box to paste it into within half a minute."
89 },
90 "playback_pairing": {
91 "title": "Select Music Assistant Pairing in your Spotify app",
92 "progress_text": "Waiting for you to select Music Assistant Pairing in the Spotify app.\n\n1. Open the Spotify app on your phone, tablet or computer.\n2. Start playing any song, so the player bar appears at the bottom.\n3. Tap the speaker icon in the player bar (Connect to a device).\n4. Choose \"Music Assistant Pairing\" from the list of devices.\n\nNo audio will play on it. Selecting it only grants permission, and you can switch back to your usual speaker right after. This screen continues by itself once you have done it.\n\nNot seeing it? Make sure the device running Spotify is on the same network as Music Assistant. You can also go back and choose the web browser option."
93 },
94 "playback_browser": {
95 "title": "Paste the address you landed on",
96 "description": "Your browser could not reach Music Assistant directly, so the last step is manual.\n\n1. Copy the full web address of the page that failed to load, from your browser's address bar.\n\n2. Paste it below and press Next.\n\nThe address starts with 127.0.0.1 and contains a one-time code, so paste all of it without editing. If you no longer have that page open, [try again with a new link]({0})."
97 },
98 "developer_optin": {
99 "title": "You're all set",
100 "description": "Spotify has been added to Music Assistant. Press Finish to start.\n\nOptionally, you can connect your own Spotify developer key. It makes browsing and searching faster, but it takes a few extra steps to set up. Most people can skip this, and you can always add it later."
101 },
102 "playback_backend": {
103 "title": "Choose how Spotify audio is played",
104 "description": "Music Assistant can use two different Spotify playback engines:"
105 },
106 "soloist_terms": {
107 "title": "About Spotify Soloist",
108 "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)"
109 },
110 "soloist_api_key": {
111 "title": "Create your Soloist API key",
112 "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."
113 },
114 "soloist_repair": {
115 "title": "Keep the current Spotify pairing?",
116 "description": "This Spotify instance is already paired with a Spotify account. You can keep that pairing, or pair again â for example to switch to another Spotify account, or when playback stopped working.\n\nPair with the same Spotify account this provider signs in with, so your listening history and recommendations end up on the right account."
117 },
118 "soloist_pairing": {
119 "title": "Pair with your Spotify account",
120 "progress_text": "Music Assistant is downloading Spotify Soloist (first time only) and advertising \"Music Assistant Pairing\" to your Spotify app.\n\n1. Open the Spotify app on a phone, tablet or computer on the same network, signed in to the **same Spotify account** you connected in the first step.\n2. Start playing any song, so the player bar appears at the bottom.\n3. Tap the speaker icon in the player bar (Connect to a device).\n4. Choose \"Music Assistant Pairing\" from the list of devices.\n\nSoloist stores the pairing and this screen continues by itself. You can switch back to your usual speaker right after.\n\nNot seeing it? Make sure the device running Spotify is on the same network as Music Assistant."
121 }
122 },
123 "media": {
124 "folder": {
125 "new_releases": {
126 "name": "New Releases"
127 },
128 "genres_and_moods": {
129 "name": "Genres & Moods"
130 }
131 },
132 "playlist": {
133 "liked_songs": {
134 "name": "Liked Songs {0}"
135 }
136 },
137 "podcast": {
138 "unknown_podcast": {
139 "name": "Unknown Podcast"
140 }
141 }
142 },
143 "errors": {
144 "refresh_token_invalid": "Your Spotify session has expired or been revoked. Please re-authenticate to continue using Spotify.",
145 "pairing_not_completed": "Music Assistant Pairing wasn't selected in the Spotify app in time. Try again, or use the web browser option if Music Assistant Pairing doesn't appear in your Spotify app.",
146 "playback_code_invalid": "That address could not be used. Make sure you copied the complete address of the error page, and note that each attempt can only be used once â start over to get a new link.",
147 "playback_auth_required": "Spotify needs you to approve audio playback again. Open the Spotify provider settings and run through the setup once more to restore playback.",
148 "playback_not_completed": "Playback wasn't approved in time. Open the link again and paste the address of the page your browser ends up on.",
149 "playback_auth_failed": "Approving playback didn't work. Please try again.",
150 "playback_account_mismatch": "Playback was approved with a different Spotify account than the one you signed in with. Use the same account for both, so your music library and the audio come from the same place.",
151 "librespot_unavailable": "Music Assistant has no Spotify playback support for this system, so Spotify audio cannot be played here.",
152 "soloist_consent_required": "Spotify Soloist can only be used after you allow the download. Select Spotify Soloist again to review that step, or choose librespot (community) instead.",
153 "soloist_unsupported_platform": "Spotify Soloist is not available for this system. Choose librespot (community) instead.",
154 "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.",
155 "soloist_pairing_not_completed": "Music Assistant Pairing wasn't selected in the Spotify app in time. Try again.",
156 "soloist_pairing_failed": "Pairing with Spotify didn't work. Check that the API key is complete and try again.",
157 "soloist_pairing_required": "Spotify Soloist is not paired with your Spotify account (or the pairing was lost). Open the Spotify provider settings and run through the setup once more to restore playback.",
158 "soloist_download_failed": "The Spotify Soloist app could not be downloaded from Spotify. Check the server's internet connection and try again.",
159 "soloist_invalid_archive": "The Spotify Soloist app downloaded from Spotify could not be used. Try again later.",
160 "soloist_build_expired": "Spotify's current Soloist app version has expired and no newer version is available yet. Try again later.",
161 "soloist_account_mismatch": "Music Assistant was paired from a Spotify app signed in to a different account than the one you connected. Pair again from an app signed in to the same account, so your music library and the audio come from the same place.",
162 "soloist_session_busy": "{0} is already playing something else. Spotify Soloist plays one thing at a time, so stop the other player first.",
163 "soloist_app_took_over": "The Spotify app took over playback, so {0} stopped playing here. Try again in a moment to bring it back.",
164 "soloist_app_paused": "Playback was paused from the Spotify app, so {0} stopped playing here. Try again in a moment to continue."
165 },
166 "manifest": {
167 "description": "Stream music, playlists, podcasts, and discover new songs via Spotifyâs ecosystem."
168 }
169}
170