Liquid Glass and Apple Music touches for the Spotify iOS app. A GPL-3.0 fork of spoti.pw 0.21.1.
C
chore: update readme
Vojtěch Škopekd89631957cd0
diff --git a/README.md b/README.mdindex 878530b5..12460a50 100644--- a/README.md+++ b/README.md@@ -29,65 +29,55 @@<img src="docs/screenshots/settings.webp" width="19%" alt="Mod Settings"></p>-A Theos tweak that rebuilds the Spotify iOS app in Liquid Glass. One dylib, injected into a-decrypted Spotify IPA and signed with your own certificate, so it runs on a stock iPhone with no-jailbreak. Every piece sits behind its own switch in Settings → Mod Settings.--- Spotify's own Liquid Glass, every flag of it on at once-- Glass now playing bar, player header, search field and lyrics card-- Pure black AMOLED, and a Home gradient in any of eight colours-- A tab bar you reorder, hide and add any `spotify:` link to-- Queue as a bottom sheet, swipe a row to play next-- Like and dislike back on the lock screen widget, animated artwork on it-- Speed control and trim silence for music, not only podcasts-- Picture in picture, in the app and out of it-- No ad on app open, no upsells, no tooltips, no DJ badge-- EeveeSpotify's ad blocking, ported: ad services, upsells and a Premium product state, each behind its own switch-- Telemetry blocked, with a count of what it stopped-- Hide anything: Home shortcuts, playlist header, player buttons and the cards under them-- Unreleased features Spotify built and never shipped-- Every remote-config flag Spotify ships, searchable, Auto / Off / On--Cosmetic until asked otherwise. The Ad blocking page holds EeveeSpotify's layers, every one off by default;-the Premium one rewrites what the server says about the account, is the part Spotify's takedowns have-gone after, and is untested here.+A Theos tweak that rebuilds Spotify for iOS in Liquid Glass. One dylib injected into a decrypted+IPA, signed with your own certificate, no jailbreak. Every piece has a switch in Settings → Mod+Settings.++What is in, and what is next.++- [x] Liquid Glass, every flag of it at once+- [x] AMOLED black, Home gradient+- [x] Ad blocking+- [x] Pretend to be Premium+- [x] Tracker blocking+- [x] Custom tab bar+- [x] Double tap zones on the player+- [x] Like and dislike on the lock screen+- [x] Hide anything+- [x] Every flag Spotify ships+- [ ] Custom lyrics+- [ ] Block an artist+- [ ] Radio stations from a stream URL+- [ ] Alternate app icons+- [ ] Open on the tab you choose+- [ ] Long press and swipe gestures## Get it-No IPA is distributed in this repo. [spoti.pw](https://spoti.pw) carries the current build, and-it is also a source for SideStore, AltStore and Feather: add `https://spoti.pw` and later builds-arrive on their own. Mod Settings → Updates checks the same place.+No IPA is distributed here. [spoti.pw](https://spoti.pw) carries the current build and doubles as a+source for SideStore, AltStore and Feather: add `https://spoti.pw` and later builds arrive on their+own.-The app keeps Spotify's own bundle id, `com.spotify.client`, so it installs over the real Spotify-rather than next to it. That is deliberate: a rewritten bundle id has to match the App ID of the-profile you sign with, and this build cannot know which profile that will be. Sign a mismatched-pair and the app installs fine, but tapping the now playing card on the lock screen opens nothing.+The app keeps Spotify's bundle id, so it installs over the real Spotify. Sign it under a mismatched+App ID and it still installs, but the lock screen card opens nothing.### Signing it yourself-Which is what you have to watch for. Feather does not touch the bundle id unless you tell it to, so-with a certificate whose App ID is fixed you end up with exactly that mismatched pair: set-**Identifier** in Feather's signing options to the App ID shown in its certificates tab, and leave-**PPQ protection** off, since it appends a random string to the bundle id and breaks the match-again. AltStore, SideStore and Sideloadly register an App ID from the bundle id themselves and need-none of this.+In Feather, set **Identifier** to the App ID in its certificates tab and leave **PPQ protection**+off. AltStore, SideStore and Sideloadly work this out themselves.-You do not have to work out which of the two you got. A build the lock screen cannot open says so-once on its first launch, and carries a red row at the top of Mod Settings for as long as it lasts;-either one names the bundle id to sign under and copies it to the clipboard.+A build the lock screen cannot open says so on first launch and names the bundle id to sign under.## Build it yourself-You bring a decrypted Spotify IPA of your own. Either way the result is an unsigned-`Spotify-<version>-glass.ipa` to sign with SideStore, Feather or any certificate signer.+Bring a decrypted Spotify IPA. The result is an unsigned `Spotify-<version>-glass.ipa`, to sign with+SideStore, Feather or any certificate signer.### On GitHub, no Mac needed-Fork this repo, enable Actions in the fork, and run the **Build IPA from your own Spotify IPA**-workflow. It asks for a direct link to your decrypted `.ipa` (filebin.net, Dropbox, a host of-your own), builds the tweak, injects it, and hands the IPA back as a workflow artifact, or on-filebin.net if you pick that. The link is masked in the run's log and the result lives only in-your fork.+Fork the repo, enable Actions, run the **Build IPA from your own Spotify IPA** workflow. It takes a+direct link to your decrypted `.ipa` and hands the built IPA back as a workflow artifact. The link is+masked in the log and the result stays in your fork.### On a Mac@@ -102,32 +92,17 @@ Put the decrypted `.ipa` in `ipa/`, then:make install # the same, signed with your certificate and pushed to the iPhone over USB`make install` reads `SIGN_P12`, `SIGN_PROFILE` and `SIGN_P12_PASSWORD` from `.signing.env`; copy-`.signing.env.example` and fill it in. It signs under the App ID of your profile, which is what keeps-the lock screen player working; `BUNDLE_ID=` overrides the bundle id, and is only safe when you know-it equals that App ID.+`.signing.env.example` and fill it in. It signs under your profile's App ID, which is what keeps the+lock screen player working.-The first build spends about a minute reading Spotify's remote-config flags out of your IPA into-`tweak/Sources/Features/Flags/SGFlagList.m`, so the flag list always matches the Spotify you built from. Later builds-reuse it; `make flags` regenerates it.--## Mod Settings--Mod Settings, the first row of the side drawer behind your avatar and the last row of Spotify's-Settings, is one page per area: Appearance (with Navbar under it), Home & Library,-Playlist and Player; Ads & privacy and Labs; then All flags and Mod, which holds the version,-updates, links, the welcome tour and the reset. A switch on a page forces one of Spotify's flags;-off leaves Spotify's own value, and All flags is where a flag goes back to Auto. Navbar applies-straight away, everything else after Spotify restarts.--## Hack on it--[docs/tweaks.md](docs/tweaks.md): the layout of the tweak, the other make targets, how the view-trees are recorded off the phone, and how to add a tweak of your own.+The first build spends a minute reading Spotify's flags out of your IPA, so the flag list matches the+Spotify you built from. `make flags` regenerates it.## Credits-[cyan](https://github.com/asdfzxcvbn/pyzule-rw) does the injection, [Theos](https://theos.dev)-builds the tweak, and [FLEX](https://github.com/FLEXTool/FLEX), as hopeless's AutoFLEX build in-`vendor/`, is the in-app inspector the view trees are read through.+[cyan](https://github.com/asdfzxcvbn/pyzule-rw) injects, [Theos](https://theos.dev) builds, and+[FLEX](https://github.com/FLEXTool/FLEX), as hopeless's AutoFLEX build in `vendor/`, is the inspector+the view trees are read through. The ad blocking and the Premium state are ported from+[EeveeSpotify Reincarnated](https://github.com/SideloadLabs/EeveeSpotifyReincarnated).GPL-3.0. Not affiliated with Spotify.