Skip to main content

Configuration

This guide will help you complete the initial setup for Spotoolfy.

Credentials​

Before using Spotoolfy, you need to set up Spotify Developer credentials. This is required because Spotoolfy uses the Spotify API for playback control.

Prerequisites
  • Spotify Premium is required for playback control features
  • A Spotify Developer account (free to create)

Setting Up Spotify Developer​

  1. Visit Spotify Developer Dashboard
  2. Log in with your Spotify account
  3. Click Create App
  4. Fill in the following information:
    • App Name: Any name (e.g., "My Spotoolfy")
    • App Description: Any description
    • APIs used: Select the following:
      • Web API
      • Android SDK
      • iOS SDK
      • Web Playback SDK

Platform Configuration​

After creating the app, you need to configure platform-specific settings based on how you installed Spotoolfy:

iOS​

SettingValue
Redirect URIsspotoolfy://callback
iOS App Bundlescom.gojyuplusone.spotoolfy.spotoolfyFlutter

Android (Google Play Store)​

SettingValue
Redirect URIsspotoolfy://callback
Android Packagescom.gojyuplusone.spotoolfy.spotoolfy_flutter
SHA1 FingerprintD7:A1:25:6A:D6:C9:58:FC:95:A1:48:54:00:99:E2:99:ED:0C:A0:2E

Android (APK v1.3.0+)​

SettingValue
Redirect URIsspotoolfy://callback
Android Packagescom.gojyuplusone.spotoolfy.spotoolfy_flutter
SHA1 Fingerprint8D:BF:1F:07:DC:3D:96:5E:36:49:1E:00:B3:F7:45:B4:77:A2:93:C4

Android (APK v1.1.0 - v1.2.x)​

SettingValue
Redirect URIsspotoolfy://callback
Android Packagescom.gojyuplusone.spotoolfy.spotoolfy_flutter
SHA1 FingerprintB4:DC:68:C9:BB:AF:5B:A3:AE:D0:2D:15:EF:6C:FC:6C:F4:CF:08:22

Web​

SettingValue
Redirect URIshttps://app.spotoolfy.gojyuplus.com/callback
Multiple Platforms

If you use Spotoolfy on multiple platforms, add all the corresponding Redirect URIs and platform configurations to the same app.

Network Requirements

Some regions may require appropriate network environment to access Spotify services.

Basic Configuration​

1. Log in to Spotify​

This is the first step to using Spotoolfy:

  1. Open Spotoolfy
  2. Tap the User icon button in the top right corner
  3. Tap "Log in to Spotify"
  4. Log in to your account on the Spotify authorization page
  5. Authorize Spotoolfy to access your Spotify data
  6. Once logged in, your username will appear on the settings page
Important
  • Spotify Premium is required for playback control features
  • Free users can use lyrics viewing, note-taking, and other features
  • Authorization does not expose your password, only grants necessary access permissions

To use AI translation and insights features, you need to configure a Google AI API Key:

  1. Visit Google AI Studio
  2. Log in with your Google account
  3. Click "Create API Key" to generate a new key
  4. Copy the generated API Key
  5. In Spotoolfy settings, tap "Google AI API Key"
  6. Paste the API Key and save
About API Keys
  • Google AI API Key is free to obtain and use
  • Free tier has usage quota limits, but is sufficient for personal use
  • API Key is stored locally on your device only, never uploaded to any server

3. Ensure Device Availability​

Spotoolfy requires an active Spotify playback device:

  1. Ensure the official Spotify client is installed on your phone/computer
  2. Play any song in the Spotify client (to activate the device)
  3. Tap the Device icon in the top right corner of Spotoolfy
  4. Select the device you want to control from the device list

Advanced Configuration​

Language Settings​

Spotoolfy supports multiple languages in two categories:

App Language​

The display language of the app interface, follows system settings or can be manually selected:

  • English
  • 简体中文 (Simplified Chinese)
  • 繁體中文 (Traditional Chinese)
  • 日本語 (Japanese)

Gemini Language​

The target language for AI translation and insights:

  • Find "Gemini's Language" in settings
  • Select the language you want AI output in
  • This setting is independent of app language

Translation Style​

Select your preferred translation style in settings:

StyleDescriptionBest For
FaithfulAccurately conveys original meaningUnderstanding precise lyrics meaning
Melodramatic PoetMore poetic and emotionalAppreciating literary translation
Machine ClassicSimulates early machine translationEntertainment or special needs
NetEaseNetEase native translationWhen existing translation is available

Deep Translation​

Deprecated

This feature has been removed in v1.3 due to excessively long processing time.

  • Enable "Deep Translation" in settings
  • Sets a thinking budget for Gemini (1024 Tokens)
  • May provide higher quality translation, but consumes more API quota
  • Note: If using a paid API Key, monitor your usage

Data Management​

Export Data​

  1. Tap "Export Data" in settings
  2. Choose save location
  3. Data exports in JSON format, including all notes and translations

Import Data​

  1. Tap "Import Data" in settings
  2. Select previously exported JSON file
  3. Data will merge with current data

Common Questions​

Q: Shows "No device found" after login?​

A: Ensure the Spotify client is running and playing music. If the issue persists, try logging in again.

Q: API Key invalid or translation failed?​

A: Check that the API Key was copied correctly without extra spaces. If still failing, try regenerating the API Key.

Q: Will data sync after setup?​

A: Currently data is stored locally on device only. To use on other devices, use the export/import feature.