Stash (stashfm.app)

your Spotify + YouTube Music library, on your phone or browser

Download · Features · Setup · FAQ · Support

Stash grabs your Spotify and YouTube Music playlists and mirrors them on your Android phone. Download them, stream them. Hi-res when it exists.

No Stash account, no analytics, your logins stay encrypted on your phone. Free and open source, forever.

---

What it does

Your library, one place

• Spotify + YouTube Music together: liked songs, playlists, daily mixes
• Your listening wrapped: top songs, stats, and a recap of your month
• Got your own music in Dropbox, OneDrive or Google Drive? Connect it to stream or download it.

Download or stream

• Download your playlists or just stream them.
• Pick your quality: Lossless, AAC 320 or Opus

Sound

• Real FLAC, up to Hi-Res
• 5-band EQ, bass boost, crossfade, normalizer
• Cast to Chromecast and Nest speakers

Lyrics

• Synced lyrics that light up word by word
• Pulled automatically, no setup

Finding new stuff

• Daily Discover, Stash Mixes and radios
• Last.fm recommendations
• Share songs and mixes as links, follow your friends' mixes

Social

• Listen Together, in sync with friends
• Last.fm and ListenBrainz scrobbling
• Discord status (what you're playing, with the art)

Dark, light and pure black themes. Everything optional is off until you turn it on.

Dark

Light

---

Install

Easiest: grab Stash.apk from the latest release, open it, tap Install. If Android grumbles about unknown sources, allow it for your browser and try again.

Want auto-updates? Use Obtainium and add https://github.com/rawnaldclark/Stash. It'll ping you when there's a new version.

You need Android 8.0 or newer, and a Spotify and/or YouTube Music account.

git clone https://github.com/rawnaldclark/Stash.git
cd Stash
./gradlew assembleDebug
# APK lands in app/build/outputs/apk/debug/

You'll need Android Studio Hedgehog (2023.1.1) or later, JDK 17, and Android SDK 35. A build from a plain checkout skips the project's lossless relay and Last.fm proxy. CONTRIBUTING.md has the rest.

---

First-time setup

Open Settings, tap Spotify or YouTube Music under Accounts, tap Connect and sign in like normal. That's it. Then hit the Sync tab, pick the playlists and mixes you want, and tap Sync Now.

The first sync is the slow one (a big library with Download on can take an hour). After that it only grabs what's new. Turn on Auto-sync and forget about it.

Stash doesn't use Spotify's or YouTube's official APIs, because they don't let apps like this exist. It uses your login instead, the same way your browser does. Your login stays on your phone, encrypted, and only ever goes back to Spotify or YouTube.

1. On a computer, open open.spotify.com and make sure you're logged in.
2. Press F12 to open Developer Tools.
3. Open the Application tab (it's Storage on Firefox). Click the >> arrows if you don't see it.
4. In the left sidebar, expand Cookies → click https://open.spotify.com.
5. Find the cookie named sp_dc, double-click its value and copy it.
6. In Stash: Settings → Spotify → Connect → Paste cookie (top right).
7. Paste it and tap Connect.

Tip: cookies from incognito windows sometimes don't work. Use a normal window.

1. On a computer, open music.youtube.com and make sure you're logged in.
2. Press F12 and click the Network tab.
3. Refresh the page (F5).
4. Type browse in the filter box and click any request in the list.
5. Under Request Headers, find the line starting with cookie: and copy everything after it. It's long, that's normal.
6. In Stash: Settings → YouTube Music → Connect, paste it, tap Connect.

Same incognito tip as Spotify.

Discord has no official way for a phone app to show what you're playing, so Stash does it through your own account's session (the same trick PreMiD and similar tools use). It's not a bot and it only sets your status.

Heads up: Discord calls this kind of thing a self-bot in its Platform Manipulation Policy, and its support article says it can get an account banned. In practice they go after spam, not music statuses, so the risk is low. But it's your account, so it's your call. The app asks before connecting, and everything else in Stash works fine without it.

This is the beginning of the README. Read the rest at the original. Read the full README ↗