Liquid Glass and Apple Music touches for the Spotify iOS app. A GPL-3.0 fork of spoti.pw 0.21.1.
C
// Home redesign: every card Home keeps is the same Encore button, told apart where it lays out:
// id=Shortcut.Card.Home a shortcut tile 181x48 r=4 that clips, in a ConfigurableUIEventObservingView
// r=4 (trees/clean/home/01.txt:36-37): the cover radius, continuous, and its
// picture run across it (HomeTiles.m)
// id=Components.UI.HomeCard a shelf card, its picture Encore.ImageView 149x149 > UIImageView with no radius
// of its own (10.txt:2280-2286): cut at the cover radius, continuous, over the
// 4pt Spotify bakes into the picture (an artist's round one sits inside it)
// in Discovery_MediumDensityCardKit.DJMDCView the DJ card 370x192 r=8 that clips (01.txt:477-478): the card
// radius, and without the transcript Spotify's DJ talks through
// (Discovery_MediumDensityCardKit.TranscriptView, :500) or the Beta badge (:503)
#import "Core/SGCore.h"
#import "Redesigned/Kit/SGRKit.h"
#import "Home.h"
// Below this a card's picture is a glyph or a placeholder, not a cover.
static const CGFloat kCoverMinWidth = 80;
static char kImageKey;
static void roundCorners(UIView *view, CGFloat radius) {
CALayer *layer = view.layer;
if (layer.cornerRadius != radius) layer.cornerRadius = radius;
if (layer.cornerCurve != kCACornerCurveContinuous) layer.cornerCurve = kCACornerCurveContinuous;
}
static void roundCover(UIView *card) {
UIView *holder = SGRFindByIdentifier(card, @"Encore.ImageView", &kImageKey);
if (holder.bounds.size.width < kCoverMinWidth) return;
for (UIView *sub in holder.subviews) {
if (![sub isKindOfClass:UIImageView.class]) continue;
roundCorners(sub, SGRRadiusCover);
if (!sub.layer.masksToBounds) sub.layer.masksToBounds = YES;
}
}
// The transcript's own labels are plain UILabels the Kit keeps transparent; the Swift views around them
// take their alpha again on every pass.
static void calmDJ(UIView *card) {
for (UIView *sub in card.subviews) {
NSString *name = NSStringFromClass(sub.class);
if (![name containsString:@"TranscriptView"] && ![name containsString:@"BetaBadge"]) continue;
if (sub.alpha != 0) sub.alpha = 0;
sub.accessibilityElementsHidden = YES;
SGForEachView(sub, ^(UIView *v) {
if ([v isKindOfClass:UILabel.class]) SGRSuppress(v);
});
}
}
// The button's content (Encore's card, the cover's holder, a tile's row with its playing indicator) is laid out after
// the button's own pass otherwise; brought up to date now, the styling reads final frames.
static void settle(UIView *button) {
if (!SGRHomeLook()) return;
for (UIView *sub in button.subviews) [sub layoutIfNeeded];
}
static void style(UIView *button) {
NSString *identifier = button.accessibilityIdentifier;
// Spotify reuses a button across kinds (a tile's became a shelf card on the phone, 2026-10-11): what the other
// kind put on it comes off first.
if ([identifier isEqualToString:@"Shortcut.Card.Home"]) {
settle(button);
SGRHomeStyleLargeCard(button);
CGFloat radius = SGRHomeLook() ? SGRHomeTileRadius : SGRRadiusCover;
roundCorners(button, radius);
if (button.superview.layer.cornerRadius > 0) roundCorners(button.superview, radius);
SGRHomeStyleTile(button);
return;
}
if ([identifier isEqualToString:@"Components.UI.HomeCard"]) {
settle(button);
SGRHomeUnstyleTile(button);
if (!SGRHomeStyleLargeCard(button)) roundCover(button);
return;
}
static Class dj;
if (!dj) dj = NSClassFromString(@"_TtC30Discovery_MediumDensityCardKit9DJMDCView");
if (dj && [button.superview isKindOfClass:dj]) {
roundCorners(button, SGRRadiusCard);
calmDJ(button);
static dispatch_once_t once;
dispatch_once(&once, ^{ SGLog(@"redesign home: DJ card at the card radius, transcript gone"); });
}
}
%hook _TtC19LegacyUI_ECMCoreKit31InteractableLayoutBackingButton
- (void)layoutSubviews {
%orig;
CFTimeInterval began = SGRHomeProbeBegin();
style((UIView *)self);
SGRHomeProbeEnd(SGRHomeProbeCards, began);
}
%end
// Spotify gives a reused card or tile its new text, and a feed switched by the filter its new cards, without
// laying the button out again: a label of its own (Encore.Label-internal, the tile title's -internal) given text
// under a card or tile marks the button, so the next layout pass styles it with the text as it is then. Spotify's
// SPTEncoreLabel is KVO-observed, so the Kit's per-instance observers cannot take it (SGRRestyle.h).
static void relayoutButtonAround(UIView *view);
static void retextedUnder(UIView *label) {
CFTimeInterval began = SGRHomeProbeBegin();
NSString *identifier = label.accessibilityIdentifier;
BOOL ours = [identifier hasSuffix:@"-internal"] || [identifier hasSuffix:@".playback"];
if (ours) relayoutButtonAround(label);
SGRHomeProbeEnd(SGRHomeProbeLabels, began);
if (ours) SGRHomeProbeEnd(SGRHomeProbeLabelsMatched, began);
}
// The walk is 20 to 30 ns a call (measured 2026-10-12 against an isDescendantOfView: check on Home's list, which is
// no cheaper and would miss a label that joins the window before its card does), so no cheaper gate is kept.
static void relayoutButtonAround(UIView *label) {
static Class backing;
if (!backing) backing = NSClassFromString(@"_TtC19LegacyUI_ECMCoreKit31InteractableLayoutBackingButton");
UIView *button = label.superview;
for (NSUInteger depth = 0; button && depth < 16 && ![button isKindOfClass:backing]; depth++) button = button.superview;
if (![button isKindOfClass:backing]) return;
NSString *identifier = button.accessibilityIdentifier;
if ([identifier isEqualToString:@"Shortcut.Card.Home"] || [identifier isEqualToString:@"Components.UI.HomeCard"]) [button setNeedsLayout];
}
// The hooks the Home look needs (SGRKeyHomeLook): none of them install while it is off.
%group SGRHomeLook
// The tile's playing indicator comes and goes with what plays, on its own, without the tile laying out: shown or
// hidden, the tile's pass is asked for again, and HomeTiles.m moves it to the trailing edge or lets the title have
// the room back.
%hook _TtC11Home_ECMKit36ShortcutCardHomePlayingIndicatorView
- (void)setHidden:(BOOL)hidden {
BOOL was = ((UIView *)self).hidden;
%orig;
if (was == hidden) return;
CFTimeInterval began = SGRHomeProbeBegin();
relayoutButtonAround((UIView *)self);
SGRHomeProbeEnd(SGRHomeProbeFrames, began);
}
%end
// A new card's labels get their text before the card is in the window, under no button yet: once Spotify's label
// joins the window under a card or tile, that button is marked, so the pass that styles it sees the labels.
%hook SPTEncoreLabel
- (void)didMoveToWindow {
%orig;
UIView *label = (UIView *)self;
if (!label.window) return;
CFTimeInterval began = SGRHomeProbeBegin();
// Spotify's card and tile text (id Encore.Label, Shortcut.Card.Home.Content.title); the rest of its labels pass.
NSString *identifier = label.accessibilityIdentifier;
BOOL ours = [identifier isEqualToString:@"Encore.Label"] || [identifier hasSuffix:@".Content.title"];
if (ours) relayoutButtonAround(label);
SGRHomeProbeEnd(SGRHomeProbeLabels, began);
if (ours) SGRHomeProbeEnd(SGRHomeProbeLabelsMatched, began);
}
%end
%hook UILabel
- (void)setText:(NSString *)text {
%orig;
retextedUnder((UIView *)self);
}
- (void)setAttributedText:(NSAttributedString *)text {
%orig;
retextedUnder((UIView *)self);
}
%end
%end // SGRHomeLook
%ctor {
if (!SGRedesignedUI()) return;
%init;
SGRequireClasses(@[
@"_TtC19LegacyUI_ECMCoreKit31InteractableLayoutBackingButton",
@"_TtC30Discovery_MediumDensityCardKit9DJMDCView",
]);
if (!SGRHomeLook()) return;
%init(SGRHomeLook);
SGRequireClasses(@[@"_TtC11Home_ECMKit36ShortcutCardHomePlayingIndicatorView", @"SPTEncoreLabel"]);
}