Spotify Help

Complete guide to Spotify integration in Remiio

Remiio Pro Feature

On This Page

1. Prerequisites — What you need before connecting 2. How to Connect — OAuth sign-in flow, step by step 3. How Playback Works — Spotify Connect explained 4. Troubleshooting — 9 common issues and fixes 5. Tips & Tricks — Get the best experience 6. Disconnecting Spotify — Remove your credentials

Prerequisites

Spotify requires the Spotify app to be installed on your device and a Spotify Premium subscription. Without both, playback will not work.

Requirement Description
Spotify App Installed The Spotify mobile app must be installed on the same device running Remiio. The app is used as a Spotify Connect player.
Spotify Premium Account Playback is controlled via the Spotify Connect Web API, which is a Premium-only feature. Free accounts can authenticate and browse, but cannot start playback.
Active Internet Connection Required for OAuth authentication, token refresh, search, and all playback commands.
Spotify Opened At Least Once Spotify must have been launched at least once after installation so it can register itself as a Connect device.

How to Connect Your Spotify Account

Spotify is connected from the Station Search screen. Tap the provider picker, select Spotify, and tap the Connect button to begin the OAuth sign-in flow.

Step-by-Step

  1. Open Station Search — Tap the search icon or navigate to the "Find a Station" screen.
  2. Select Spotify from the provider picker at the top of the screen.
  3. Tap "Connect" — A button will appear if Spotify requires authentication. Tap it.
  4. The app checks for the Spotify app — If Spotify is not installed on your device, the connection will stop here and you will be prompted to install it.
  5. A browser/login sheet opens — You are redirected to Spotify's official login page using a secure OAuth 2.0 PKCE flow. No password is ever seen by Remiio.
  6. Sign in and authorize — Log in with your Spotify credentials and grant Remiio the requested permissions.
  7. You are redirected back to Remiio — The app exchanges the authorization code for an access token automatically.
  8. Account type is detected — Remiio checks your Spotify account type. If you have a Free account, a warning will be shown and playback will be unavailable.
  9. Your session is saved — Your tokens are stored securely on the device. You will not need to log in again unless you explicitly disconnect or your session expires.

Permissions Requested

Scope Why It's Needed
user-read-private Detects Premium vs. Free account status and your country for localized search results.
playlist-read-private Allows Remiio to show your saved playlists in your library.
user-modify-playback-state Allows Remiio to send play, pause, skip, and shuffle commands to Spotify.
user-read-playback-state Allows Remiio to verify that playback started successfully.

How Spotify Playback Works

Remiio controls Spotify playback using the Spotify Connect Web API. Your Spotify app acts as the music player; Remiio sends commands to it over the internet.

  • Remiio does not play audio directly. The Spotify app on your device is the audio engine.
  • When you tap play in Remiio, it sends a command to Spotify's Connect API, which tells the Spotify app to start playing.
  • The Spotify app does not need to be visible or in the foreground — it only needs to be installed and have been opened at least once.
  • If the Spotify app is not currently "awake," Remiio will attempt to wake it automatically before playing.
  • Remiio retries the play command up to 4 times (with a 2-second delay between retries) to account for the time the Spotify app needs to initialize after being woken.
  • If shuffle is enabled in Remiio's settings, shuffle mode will be automatically applied to Spotify after playback starts.
  • Tracks, playlists, and albums are all supported. Individual tracks play directly; playlists and albums play as a context (respecting Spotify's queue behavior).

Troubleshooting

Below are the most common problems users encounter with Spotify and how to resolve each one. Tap an issue to expand it.

Symptom

The Connect button does nothing, or an error appears saying Spotify is not found.

Cause

The Spotify mobile app is not installed on the device. Remiio checks for the app before starting authentication.

Resolution

  • Download Spotify from the App Store or Google Play.
  • Open Spotify at least once and sign in.
  • Return to Remiio and tap Connect again.

Symptom

You connected successfully but tapping play shows a "Spotify Premium is required" error or a badge indicating your account is Free.

Cause

The Spotify Connect Web API is a Premium-only feature. Remiio detects your account type after sign-in and blocks playback for Free accounts.

Resolution

  • Upgrade your account at spotify.com/premium.
  • You do not need to reconnect Remiio after upgrading — your session will be used automatically.

Symptom

You tap play and nothing happens, or you see an error about no active device.

Cause

Spotify has no registered Connect device. This happens when the Spotify app has not been opened recently and could not be woken automatically.

Resolution

  1. Open the Spotify app on your device.
  2. Let it load to the home screen (a few seconds is enough).
  3. Switch back to Remiio and tap play again.

On Android, Remiio will attempt to wake Spotify automatically. On iOS, you must open Spotify manually.

Symptom

A warning icon appears on the Spotify provider tile in the station list or provider picker.

Cause

Remiio's automatic token refresh has failed multiple times in a row (up to 4 retries). The app is in a degraded state and cannot communicate with Spotify reliably.

Resolution

  1. Go to Settings → Advanced → Connected Services.
  2. Disconnect Spotify.
  3. Tap Connect and sign in again.

Typically happens after a long period without internet or after a password change.

Symptom

A message appears saying "Spotify authorization needs to be refreshed. Please go to Settings → Advanced → Connected Services and reconnect Spotify."

Cause

Remiio received a 403 Forbidden error from Spotify — typically caused by revoked permissions or a scope mismatch after an app update.

Resolution

  1. Go to Settings → Advanced → Connected Services.
  2. Disconnect Spotify.
  3. Tap Connect and sign in again to grant fresh permissions.

Symptom

Searching for a playlist or album returns results that don't reflect recent changes.

Cause

Search results are cached for up to 7 minutes to reduce API calls and improve performance. Your library (saved playlists) is cached on the same schedule.

Resolution

  • Wait a few minutes and search again.
  • Navigating away from the search screen and returning will trigger a fresh search on your next query.

Symptom

The "My Library" view shows no Spotify playlists, or playlists you just created in Spotify are missing.

Cause

Remiio fetches up to 50 playlists from your library. If you have more than 50, only the first 50 are shown. New playlists may also be in the 7-minute cache.

Resolution

  • Confirm the playlist exists in the Spotify app.
  • Wait up to 7 minutes for the cache to expire and retry.
  • If you have more than 50 playlists, Remiio shows the 50 most recent ones returned by Spotify.

Symptom

The Spotify login screen briefly appears and then closes, returning you to Remiio without connecting.

Cause

You cancelled the sign-in, or the browser/login sheet was dismissed. This is not an error — the flow is simply cancelled.

Resolution

  • Tap the Connect button again to restart the sign-in process.
  • Make sure you complete the Spotify login and tap "Agree" on the permissions screen before the sheet closes.

Symptom

Tapping the skip forward or skip backward buttons in Remiio has no effect.

Cause

Skip commands require an active Spotify Connect session (Spotify app open and playing). If there is no active device, the commands are silently ignored.

Resolution

  • Ensure Spotify is actively playing audio before trying to skip.
  • Open the Spotify app, start playback, then return to Remiio.

Tips & Tricks

Practical advice to help you get the most out of the Spotify integration in Remiio.

Open Spotify before using Remiio

Launching Spotify first ensures a Connect device is already registered and ready. This eliminates the most common playback delay.

You stay signed in automatically

Remiio silently refreshes your access token 5 minutes before it expires. You should never need to sign in again after initial setup.

Use shuffle from Remiio's settings

Enable shuffle in Remiio and it will be automatically applied every time you start Spotify playback — no need to change it in the Spotify app.

Search finds playlists and albums

Remiio is designed around curated listening. Spotify search returns playlists and albums rather than individual songs.

Your results are localized

Remiio uses your Spotify account's country to return region-appropriate search results.

Disconnecting doesn't affect your Spotify account

Signing out of Spotify in Remiio only removes the stored token from your device. Your Spotify account, playlists, and data are completely untouched.

Remiio works with Spotify's own queue

When you play a playlist or album from Remiio, Spotify manages the queue. You can continue interacting with the Spotify app normally while Remiio controls it.

Free tier users can still browse

Even without Premium, you can connect Spotify, search for playlists, and browse your library in Remiio. Only playback is blocked.

Disconnecting Spotify

You can disconnect Spotify at any time from the app's settings. This removes your stored credentials from the device without affecting your Spotify account.

Disconnect from Remiio

  1. Open the Remiio app.
  2. Go to Settings.
  3. Tap Advanced Settings.
  4. Under Connected Services, find Spotify and tap Disconnect.
  5. Your access token and refresh token are immediately deleted from secure storage on the device.
  6. Your Spotify account and data are not affected.