EeveeSpotify Logo

Documentation

Everything you need to know about installing, configuring and using EeveeSpotify to its full potential.

Installation

EeveeSpotify can be installed using one of two methods: IPA sideloading or as a jailbreak tweak. Choose the method that best suits your device and situation.

IPA Sideloading (No Jailbreak Required)

  1. Download the EeveeSpotify IPA

    Get the latest IPA file from our downloads page or the GitHub releases.

  2. Download a sideloading tool

    Options include:

    • Sideloadly - Recommended for Windows and macOS
    • AltStore - Great for on-device refreshing
    • Signulous - Paid signing service (no revokes)
  3. Installation process with Sideloadly
    1. Connect your iOS device to your computer
    2. Open Sideloadly and drag the IPA file into it
    3. Enter your Apple ID and password when prompted
    4. Click "Start" to begin the installation
    5. Wait for the process to complete
  4. Trust the developer profile

    On your iOS device, go to Settings > General > VPN & Device Management, find your Apple ID, and tap "Trust".

Sideloading Limitations

With a free Apple ID, sideloaded apps will expire after 7 days and need to be re-sideloaded. To avoid this, you can:

  • Use AltStore with AltDaemon for on-device refreshing
  • Use a paid Apple Developer account ($99/year)
  • Use a paid signing service like Signulous or AppDB

Jailbreak Method

  1. Install Spotify from the App Store

    Make sure you have the official Spotify app installed from the App Store.

  2. Download the DEB files

    Download the appropriate EeveeSpotify DEB file for your device architecture and the SwiftProtobuf dependency from our downloads page.

  3. Install using a package manager
    • Open your package manager (Sileo, Zebra, Cydia, etc.)
    • Install both the EeveeSpotify DEB and the SwiftProtobuf dependency
    • Respring your device when prompted
  4. Launch Spotify

    Open the Spotify app and you should now have premium features activated.

Advantages of Jailbreak Method
  • No need to re-sideload every 7 days
  • Can receive official Spotify updates from the App Store
  • Generally better integration with the iOS system
  • Better compatibility with other tweaks

Configuration

EeveeSpotify offers several configuration options to customize your experience. Here's how to access and modify them.

Accessing EeveeSpotify Settings

  1. Open Spotify

    Launch the Spotify app with EeveeSpotify installed.

  2. Go to Settings

    Tap on your profile icon in the top-left corner, then tap on the gear icon (⚙️) to access Settings.

  3. Find EeveeSpotify settings

    Scroll down to find the "EeveeSpotify" section in the settings menu.

EeveeSpotify Settings
EeveeSpotify Enabled
Premium Patching Dynamic
Lyrics Provider Musixmatch
Do Not Patch Premium

Available Settings

Setting Options Description
Premium Patching Static Dynamic Choose how EeveeSpotify patches premium features. Dynamic is more stable and recommended.
Lyrics Provider Musixmatch Genius LRCLIB Select which service to use for lyrics. Each provider offers different features.
Do Not Patch Premium On Off Enable if you have a legitimate Premium subscription. Prevents EeveeSpotify from interfering.
Lyrics Colors On Off Enable or disable colored lyrics for a more vibrant experience.
LRCLIB Server Address Custom URL Specify a custom LRCLIB server address if you're using that lyrics provider.
Musixmatch Token Custom Token Add your Musixmatch token to enable time-synced lyrics with Musixmatch provider.

Premium Patching Methods

EeveeSpotify offers two different methods to enable Premium features. Understanding the differences can help you choose the best option for your use case.

Static Method

Original

The original method used in early versions of EeveeSpotify.

How It Works:

  • On app startup, EeveeSpotify composes cache data
  • Inserts your username into a blank file with preset Premium parameters
  • When Spotify reloads user data, you'll see a popup with restart options

Pros:

  • Works on older devices with less processing power
  • Simpler implementation

Cons:

  • Requires app restart when Premium status is lost
  • Less stable overall experience

Dynamic Method

Recommended

The newer, improved method introduced in EeveeSpotify v4.0+.

How It Works:

  • Intercepts requests to load user data in real-time
  • Deserializes the data and modifies premium parameters on the fly
  • No need for app restarts or manual intervention

Pros:

  • Much more stable experience
  • No popup prompts or app restarts needed
  • Handles server-side checks more gracefully

Cons:

  • Slightly more resource-intensive
  • May not work as well on very old devices

Which Method Should You Choose?

For most users, the Dynamic Method is recommended as it provides a much more seamless experience. Only use the Static Method if you experience issues with the Dynamic Method on older devices.

How to Change Patching Method:

  1. Open Spotify app
  2. Go to Settings (gear icon)
  3. Scroll down to EeveeSpotify section
  4. Tap on "Premium Patching"
  5. Select your preferred method

Lyrics Providers

One of EeveeSpotify's unique features is the ability to choose from different lyrics providers, each offering different capabilities and content.

Provider Time-Sync Annotations Availability Token Required
Musixmatch Excellent
Genius Very Good
LRCLIB Good
PetitLyrics Limited

Setting Up Musixmatch Token

To use Musixmatch with time-synced lyrics, you need to obtain a token from the Musixmatch app.

Steps to get your Musixmatch token:

  1. Download the Musixmatch app

    Get the official Musixmatch Lyrics Finder app from the App Store.

  2. Open the app and sign in

    Create an account or log in to your existing Musixmatch account.

  3. Go to Settings

    Tap on your profile and go to the Settings menu.

  4. Find Debug Info

    Scroll down → Tap "Get Help" → Tap "Copy debug info".

  5. Paste in EeveeSpotify

    Go to EeveeSpotify settings → Select Musixmatch as provider → Paste token when prompted.

Pro Tip

Musixmatch offers the best synced lyrics experience and has the largest database of songs. It's highly recommended if you enjoy sing-along style lyrics.

Using LRCLIB Server

LRCLIB is a community-driven lyrics database that provides time-synced lyrics without requiring a token.

Customizing LRCLIB Server:

  1. Select LRCLIB as provider

    In EeveeSpotify settings, choose LRCLIB as your lyrics provider.

  2. Optional: Set custom server

    If you want to use an alternative LRCLIB server, tap on "LRCLIB Server Address" and enter the URL.

Note About LRCLIB

LRCLIB servers can occasionally go down or experience outages. If you experience issues, try switching to another lyrics provider or check if the server is online.

Troubleshooting

Encountering issues with EeveeSpotify? Here are solutions to common problems users may experience.

App Crashes on Startup

If your Spotify app crashes immediately upon launching, try these solutions:

1

Download the latest version of EeveeSpotify that matches your Spotify app version.

2

Make sure you've installed the required SwiftProtobuf dependency (for jailbreak method).

3

Delete and reinstall the Spotify app, then reapply EeveeSpotify.

Premium Features Not Working

If premium features are not working as expected, try these steps:

1

Switch to the Dynamic patching method in EeveeSpotify settings.

2

If you're using the Static method, try restarting the app when prompted.

3

Make sure "Do Not Patch Premium" option is disabled if you don't have a legitimate Premium subscription.

No Lyrics Showing

If lyrics aren't displaying for songs, try these solutions:

1

Try changing to a different lyrics provider in the settings.

2

For Musixmatch, make sure you've added a valid token.

3

Check if lyrics are available for the specific song (not all songs have lyrics available).

App Expired After 7 Days

For sideloaded IPA installations that expire after 7 days:

1

This is normal behavior for free Apple ID sideloading. You need to re-sideload every 7 days.

2

Consider using AltStore with AltDaemon for automatic refreshing.

3

Alternatively, use a paid signing service or a paid Apple Developer account for 1-year certificates.

Still Need Help?

If you're still experiencing issues, you can seek help from the community:

Advanced Usage

For more technical users, here are some advanced configurations and options for EeveeSpotify.

Safari Extension

The OpenSpotifySafariExtension allows Spotify links from websites to open directly in your EeveeSpotify app.

Installation Steps:

  1. Download the extension

    Get the OpenSpotifySafariExtension.appex from the GitHub repository.

  2. Extract your EeveeSpotify IPA

    Unzip the IPA file using an archive utility.

  3. Add the extension

    Copy the .appex file to /Payload/Spotify.app/Plugins/

  4. Repackage and sideload

    Compress the Payload folder, rename to Spotify.ipa, and sideload.

  5. Enable in Settings

    Go to Settings > Safari > Extensions > Open in Spotify and toggle it ON.

  6. Set permissions

    Change permission from "Ask" to "Allow".

Once enabled, clicking on Spotify links in Safari will open them directly in the EeveeSpotify app rather than the web player.

Multiple Spotify Versions

You can have both an App Store version and a sideloaded EeveeSpotify version installed simultaneously.

Benefits:

  • Use official Spotify for server-side premium features if you have a subscription
  • Use EeveeSpotify for offline or secondary account usage
  • Test different versions of EeveeSpotify without removing your main app
Important Note

When using multiple Spotify installations, be careful with login sessions as they might interfere with each other. It's best to use different accounts on each app.

Documentation Updates

This documentation is regularly updated to reflect the latest features and changes in EeveeSpotify.

Last updated: March 27, 2025 Documentation version: 5.9.1