Skip to content
coye2Public

About

The free Spotify alternative and Spotify mod: Spotify's look and playlists, Rewind stats anytime, account-free Jams and an on-device AI DJ.

Topics

Resources

Contributing

Security policy

Stars

29 stars

Watchers

0 watching

Forks

Repository files navigation

Spot+ logo

Spot+

The free Spotify alternative and Spotify mod. Spotify’s look and playlists in a free, installable app for phone and desktop, plus what Spotify doesn’t give you: Rewind stats anytime, Jams without Premium or accounts, and an on-device AI DJ.

Open Spot+ →

Deploy PWA No accounts License Installs Listening now Tests

Spot+ home, a Spotify playlist, Jam and Connect Spotify screens

Artwork is replaced with color tiles in these screenshots.


See what changed in each update: Changelog

Highlights

🎧 Full music player Search, queue, shuffle, repeat, lyrics, sleep timer, downloads, local files and lock-screen controls.
🧩 Spotify mod An optional helper adds a Spot+ panel to Spotify’s own web player that copies your Liked Songs and playlists into Spot+.
🟢 Spotify collections Charts, editorial, mood and decade playlists from Spotify, playable right in Spot+. Paste any playlist link to open it.
📊 Rewind Your top songs, artists, genres and listening clock, plus a shareable story. Connect Spotify by pasting two links; it then stays up to date without a login.
🎲 Daily Mixes & Smart Radio Fresh mixes every day from what you play and skip, and music that keeps going when your queue ends.
🔗 Your devices & shared playlists Keep your library in sync across phone and computer, and edit playlists live with friends. Encrypted, no accounts.
🎙️ Podcasts & audiobooks Any public podcast and thousands of free classic audiobooks, with resume and 15/30s skips.
🧪 Playlist generator Build a playlist from your taste, artists, songs, genres and vibes, with sliders for discovery and popularity.
🎤 Sing-along Turn the vocals down and follow lyrics that fill in as you sing.
👥 Jam Listen together in sync on separate phones. Share a code or QR. No accounts, no servers, end-to-end encrypted.
🎙️ Spot+ DJ Talk or type to request music. Optional live mode runs a small AI model and voice entirely on your device.
🎬 Canvas loops Full-screen portrait video loops behind the player, like Spotify mobile.
🎨 Themes & backgrounds Light, dark and automatic modes, 33 color themes, true-black AMOLED, and your own background from Alpha Coders, Wallhaven, Openverse, a Pinterest pin or a Google Images link.
🎤 Artist pages like Spotify’s Spotify photo, monthly listeners, popular songs with play counts, full discographies and related artists.
⚡ Instant playback Full songs, no ads. The next song is ready before you reach it, so skips start in about a fifth of a second.
🐍 Snake Spotify’s Snake on every device: the snake is made of your queue’s covers.
📤 Share Share a song as a Spot+ story card, a Spotify link or a Spot+ link.
🔔 Calm notifications New releases from artists you follow, a weekly recap and update alerts. Two a day at most, none at night.
📱 Works everywhere One web app for iPhone, Android, Windows, macOS and Linux. Installs like a native app and works offline.

Get started

Open coye2.github.io/spot-plus and install it:

  • iPhone / iPad: Safari → Share → Add to Home Screen
  • Android: Chrome → menu → Install app
  • Computer: Chrome or Edge → install icon in the address bar

A short welcome tour runs on first launch. Nothing to sign up for.

Connect Spotify (optional, about a minute)

Profile → Connect Spotify, then paste two links from the Spotify app:

  1. Your profile: tap your picture → View profile → ⋯ → Copy link
  2. On Repeat: search it in Spotify → ⋯ → Share → Copy link

Rewind, your profile picture and Made For You then update by themselves. Optional extras, a browser helper for Liked Songs and a Spotify data download, are under More ways to connect. See the helper guide.

Privacy

  • No accounts, no tracking, no ads. Your library, history and settings stay in your browser.
  • Spot+ only reads public Spotify playlist and profile pages. It never asks for your Spotify password.
  • Jams and synced stats are encrypted on your device before they travel through public relays.
  • Back up or move your data anytime: Settings → Export backup.

How it works

                 metadata   ┌──────────────────┐
              ┌───────────▶ │ Deezer           │  search, artists, albums
              │   audio     ├──────────────────┤
              ├───────────▶ │ Piped / Invidious│  matched full tracks
┌──────────┐  │   lyrics    ├──────────────────┤
│  Spot+   │──┼───────────▶ │ LRCLIB           │  synced lyrics
│  (PWA)   │  │   Spotify   ├──────────────────┤
└──────────┘  ├───────────▶ │ Spot+ bridge     │  public playlists, Canvas,
              │             │ (Cloudflare)     │  lyrics search
              │ Jam & sync  ├──────────────────┤
              └◀──────────▶ │ Nostr relays     │  encrypted, no accounts
                            └──────────────────┘

Spot+ is plain JavaScript modules with no framework. A service worker caches the app for offline use and instant startups. The production build minifies everything with esbuild.

Development

Requires Node.js 20 or newer.

npm ci
npm run dev      # local server at http://127.0.0.1:8080
npm test         # unit tests (node --test)
npm run lint     # ESLint
npm run check    # project consistency checks
npm run build    # production build in dist/

Pushing to main builds and publishes to GitHub Pages automatically.

Mandatory workflow: While active development is in progress, keep MAINTENANCE_MODE = true in js/maintenance.js and var MAINTENANCE = true; in js/boot.js. Only turn maintenance mode off when development is complete and the maintainer declares the build stable.

Project layout

index.html, sw.js, manifest.webmanifest   app shell, offline cache, install info
js/              app modules (player, rewind, jam, spotify links, DJ…)
css/             styles; polish.css loads last
canvas-bridge/   Cloudflare Worker: Canvas, Spotify public pages, lyrics search
scripts/         build, dev server, checks, optional PowerShell helpers
tests/           node:test suites
docs/            guides, audit notes and screenshots

Deploying the bridge

The worker in canvas-bridge/ deploys automatically when the repository secrets CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID are set. To deploy by hand:

cd canvas-bridge
npx wrangler login
npx wrangler deploy

Known limits

  • Full-length playback depends on public audio servers; when they're down, Spot+ falls back to 30-second previews.
  • Notifications arrive while Spot+ is open or playing in the background, not when the app is fully closed.
  • iOS Home Screen apps can show a thin strip at the bottom of the screen (an iOS 26 bug).
  • Spotify playback, Spotify Connect and Blend aren't part of Spot+.

Contributing

Bug reports and ideas are welcome. Open an issue. See CONTRIBUTING.md for pull requests.

License

All rights reserved. The source is public for transparency, but Spot+ is not open source. You may use the hosted app personally. Copying, modifying, redistributing or hosting it requires written permission. See LICENSE.

Disclaimer

Spot+ is an independent project. It is not affiliated with, endorsed by or connected to Spotify, Deezer, Genius or YouTube. All trademarks belong to their owners.

About

The free Spotify alternative and Spotify mod: Spotify's look and playlists, Rewind stats anytime, account-free Jams and an on-device AI DJ.

Topics

Resources

Contributing

Security policy

Stars

29 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages