These are some answers to common questions, along with some solutions to try if things aren't quite right.

Frequently Asked Questions

Does Sleeve need access to my Apple Music or Spotify account?

There's no authentication required — Sleeve interacts directly with the Apple Music and Spotify apps as long as they're open on your Mac, without acessing anything about your account. However, to use certain features with Spotify, such as the ability to like tracks, you will need to authenticate with Spotify by following this guide.

Why does Sleeve ask to control Apple Music/Spotify/Doppler when it first launches?

Sleeve needs this system permission in order to fetch information from those apps and send playback events to them. We fetch the current track information, whether or not the apps are open and playing, and send events to control playback.

Can you add support for Tidal, Deezer, SoundCloud or YouTube Music?

We'd love to add support for more services, but unfortunately none of those mentioned above ship apps that support AppleScript, so Sleeve doesn't currently have a way to fetch metadata or control playback.

If you're a developer of a music app and want to integrate with Sleeve please contact us and take a look the Developers guide.

Where can I download Sleeve if I've already purchased it?

You can retrieve your download link from our dedicated Purchase Lookup page.

Granting Sleeve permissions

Sleeve requires the Automation permission on macOS to communicate with the music apps Sleeve supports. You should be prompted to grant this permission via a system alert window the first time Sleeve tries to access the music app you use.

If you initially deny the permission, you'll need to grant it manually from System Settings, as Sleeve can't prompt again itself. You can do this by navigating to Privacy & Security, then Automation, and then expanding the Sleeve.app option where you'll see switches next to each player.

For Apple Music users, you'll see an additional prompt where Sleeve will request permission to access Apple Music directly. This is new in Sleeve 3 and is required to fetch information when tracks are sreaming in Apple Music only. This permission can also be granted or revoked later from the Media & Apple Music section under the Privacy system settings.

Resetting Sleeve

A possible solution if you're finding Sleeve has lost the ability to communicate with a music app, or you revoked or accidentally declined the system permissions window on first launch, you can restore Sleeve by running the following command in Terminal.app.

tccutil reset AppleEvents com.replay.sleeve

If you encounter other issues with Sleeve, you can reset Sleeve completely, including all settings and themes, by running the following command:

defaults delete com.replay.sleeve && tccutil reset AppleEvents com.replay.sleeve

Upgrading Sleeve from older versions

If you're upgrading to Sleeve 2.0 from a version of Sleeve prior to 1.8.2, you may encounter an error when updating from within the app.

If you encounter this issue, use the Purchase Lookup page to get a direct download link for the latest version of Sleeve, and then replace the existing version of Sleeve.app in the Applications folder with the new one (make sure to quit Sleeve first).

Report an Issue

To get in touch about any issue you're experiencing with Sleeve you can email [email protected] and we'll get back to you as soon as we can.