- Objective-C 60.9%
- Logos 32.2%
- Shell 2.3%
- Python 2%
- JavaScript 1.4%
- Other 1.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .agents/skills | ||
| .claude/skills | ||
| .github | ||
| docs | ||
| extension | ||
| harness | ||
| ipa | ||
| plist | ||
| scripts | ||
| tweak | ||
| vendor | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .release-please-manifest.json | ||
| .signing.env.example | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| CLA.md | ||
| CLAUDE.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| release-please-config.json | ||
| version.txt | ||
spoti.pw
Spotify, in glass.
spoti.pw · Build it · Hack on it · Support
A no-jailbreak Theos tweak that rebuilds Spotify for iOS in Liquid Glass, injected into your own decrypted IPA and signed with your own certificate.
Built and tested on Spotify 9.1.78 — use that version's IPA. The mod hooks Spotify's own classes, which change between releases, so another version may build and then break.
| The redesign | iOS 26+ |
| Legacy look | iOS 16.1+ |
| Live Activity | iOS 17+ |
The redesign is UIGlassEffect, which only exists from iOS 26. Below that the Redesigned UI switch
is greyed out and the mod runs Spotify's own screens with everything else it adds on top. Both live
in Settings → Mod Settings.
Build it
No IPA is distributed. Bring a decrypted Spotify 9.1.78 IPA; you get an unsigned
spoti.pw-<mod version>.ipa to sign with SideStore, Feather or any certificate signer. Each
release also carries the tweak's .deb.
Build with GitHub Actions
Fork the repo, enable Actions, run Build IPA from your own Spotify IPA. It takes a direct link to
your decrypted .ipa and hands the built IPA back as a workflow artifact. No Mac needed; the link is
masked in the log and the result stays in your fork.
Build on a Mac
Theos in ~/theos and Xcode with an iPhoneOS 26+ SDK (xcode-select it). An SDK in ~/theos/sdks
alone builds too, but without the Live Activity. Then:
brew install make ldid dpkg zsign ideviceinstaller libimobiledevice
uv tool install "cyan @ git+https://github.com/asdfzxcvbn/pyzule-rw"
Put the decrypted .ipa in ipa/, then:
make release # out/spoti.pw-<version>.ipa, ready to sign
make install # the same, signed with your certificate and pushed over USB
make install reads SIGN_P12, SIGN_PROFILE and SIGN_P12_PASSWORD from .signing.env; copy
.signing.env.example and fill it in.
The first build spends a minute reading Spotify's flags out of your IPA. make flags regenerates it.
Signing
Sign with a bundle id matching your certificate's App ID. If it doesn't match, the app still works but tapping the player on the lock screen won't open it — and it tells you on first launch which id to use. In Feather, copy the App ID into Identifier and leave PPQ protection off; AltStore, SideStore and Sideloadly get this right on their own.
The app keeps Spotify's bundle id, so it installs over the real Spotify.
Support
If it made your phone nicer to use, a coffee is a good way to say so.
Contributing
Pull requests are welcome. The pull request's description has a box for agreeing to the Contributor License Agreement, which gives the project's owner the rights to the contribution; it is ticked once, before the first pull request is merged.
Star history
Credits
cyan injects, Theos builds, and
FLEX, as hopeless's AutoFLEX build in vendor/, is the inspector
the view trees are read through.
License
Source available under the PolyForm Strict License 1.0.0: you can read the code and use
the mod yourself, but not change it, reuse it in other projects or redistribute it. Releases up to
v0.21.1 were published under GPL-3.0 and stay under it. Files in vendor/ and .agents/ keep their
own licences.
Not affiliated with Spotify.