Skip to content

Liquid Glass and Apple Music touches for the Spotify iOS app. A GPL-3.0 fork of spoti.pw 0.21.1.

C
10.3 KB
Raw Blame
// Album redesign: the artwork field behind the whole page, and what the switch forces.
//
// Tree (trees/clean/album/01.txt:22). The page is CreativeWorkPlatform.CreativeWorkTemplateView, and it
// holds, in this order: the header's color wash (a LegacyUI HeaderView the height of the header, with
// Spotify's GradientView in it), CreativeWorkPlatform.Tab with the scrolling list inside it, the sticky
// HeaderNavigationBar, and the two controls Spotify floats over the page, shuffle and play. Nothing of it
// scrolls except what is inside the Tab, so a field put behind the lot stays still while the cover at the
// top of the header slides up over it -- which is what the Music app does with the page color.
//
// So the field is the page's bottom-most view, the size of the view and bleeding past it, with no backdrop
// of its own: the sharp cover at the top of the header is the picture, and AlbumHeader.x fades it into
// exactly this field's color, and conceals Spotify's wash so the field is what shows. What Spotify paints
// over the field -- the list and every row, all of them the base surface -- is kept clear by the Kit's
// repaint hook while sgr_albumRoot is this page, and by the list's own pass below, which paints itself
// rather than through a layer the repaint hook would hear about.
//
// The color is the cover's main color, as the playlist's and the artist's are. Read off the bottom edge
// it was a scanned cover's pale border, which turned the field gray where the cover is blue (device,
// 2026-09-18); for a while Spotify's own color, read off the wash it paints behind the header, won over
// it for that reason. That color is now only what shows until the cover has been read (AlbumHeader.x
// hands it over as it conceals the wash), and before either the field is the neutral one.
//
// The page is the album's by its identifier, which is how Native/Album/Album.x has told it apart since it
// shipped: the artist page is TemplateKit's TemplateView instead. A podcast's episode page is built from
// this same template (trees/continuous/1.txt 2026-09-20: CreativeWorkTemplateView over Element_List cells
// of EpisodePage_ModernEpisodePageImpl), so it is given the field too, and everything below that holds for
// the album holds for it. What it puts on the field is its own -- a description, a comments card, Episode
// Transcript, See all episodes -- and only the paint is taken off it; AlbumHeader.x and AlbumSections.x
// look for the album's own elements and find none of them there.
#import "Core/SGCore.h"
#import "Redesigned/Kit/SGRKit.h"
#import "Album.h"

static NSString *const kPageIdentifier = @"CreativeWorkPlatform.CreativeWorkTemplateView";

// Above for the bounce at the top of the list, below for the one at the end of it.
static const UIEdgeInsets kBleed = {600, 0, 600, 0};

static char kFieldKey;

#pragma mark - the page

// Where a cell of a list is: the page it is on, and whether it is a row of the page's own list rather than a card
// inside one of its carousels -- a card is a cell of the same class, and the row that carries the carousel decides
// for it (Artist/ArtistSections.x). Worked out once the cell is in a window and kept on it, since a cell never
// leaves its list nor the list its page; every cell of the class asks on every pass, Home's and Search's included.
@interface SGRAlbumPlace : NSObject
@property (nonatomic, weak) UIView *page;
@property (nonatomic) BOOL pageCell;
// pagesFound when no page was found: a cell measured before Spotify names its page looks again once one turns up.
@property (nonatomic) NSInteger pagesFound;
@end

@implementation SGRAlbumPlace
@end

static char kPlaceKey;
static NSInteger pagesFound;
static __weak UIView *lastPage;

static SGRAlbumPlace *placeOf(UIView *cell) {
    SGRAlbumPlace *place = objc_getAssociatedObject(cell, &kPlaceKey);
    if (place.page || (place && place.pagesFound == pagesFound)) return place;
    place = [SGRAlbumPlace new];
    BOOL nested = NO;
    for (UIView *v = cell; v; v = v.superview) {
        if (v != cell && [v isKindOfClass:UICollectionViewCell.class]) nested = YES;
        if ([v.accessibilityIdentifier isEqualToString:kPageIdentifier]) {
            place.page = v;
            place.pageCell = !nested;
            break;
        }
    }
    if (place.page && place.page != lastPage) {
        lastPage = place.page;
        pagesFound++;
    }
    place.pagesFound = pagesFound;
    if (cell.window) objc_setAssociatedObject(cell, &kPlaceKey, place, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
    return place;
}

UIView *SGRAlbumPageOf(UIView *view) {
    if ([view isKindOfClass:UICollectionViewCell.class]) return placeOf(view).page;
    for (UIView *v = view; v; v = v.superview) {
        if ([v.accessibilityIdentifier isEqualToString:kPageIdentifier]) return v;
    }
    return nil;
}

static BOOL isPageCell(UIView *cell) {
    SGRAlbumPlace *place = placeOf(cell);
    return place.pageCell && place.page;
}

#pragma mark - the page's field

static SGRArtworkField *fieldOn(UIView *view) {
    for (UIView *v = view; v; v = v.superview) {
        SGRArtworkField *field = objc_getAssociatedObject(v, &kFieldKey);
        if (field) return field;
    }
    return nil;
}

UIColor *SGRAlbumFieldColor(UIView *view) {
    SGRArtworkField *field = fieldOn(view);
    return field.fieldColor ?: SGRNeutralField();
}

void SGRAlbumSetArtwork(UIView *view, UIImage *image) {
    if (image) [fieldOn(view) setArtwork:image identity:nil animated:YES];
}

void SGRAlbumSetSpotifyColor(UIView *view, UIColor *color) {
    if (color) [fieldOn(view) setProvisionalColor:color];
}

void SGRAlbumHoldPage(UIView *page) {
    [fieldOn(page) holdPage:page];
}

static SGRArtworkField *fieldIn(UIView *page) {
    SGRArtworkField *field = objc_getAssociatedObject(page, &kFieldKey);
    if (field) return field;
    field = [[SGRArtworkField alloc] initWithFrame:page.bounds];
    field.bleed = kBleed;
    field.mainColor = YES;
    objc_setAssociatedObject(page, &kFieldKey, field, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
    SGLog(@"redesign album: field on the page %.0fx%.0f", page.bounds.size.width, page.bounds.size.height);
    return field;
}

%hook _TtC28CreativeWorkPlatform_PageKit24CreativeWorkTemplateView
- (void)layoutSubviews {
    %orig;
    UIView *page = (UIView *)self;
    if (page.bounds.size.height < 200) return;
    // The page the repaint hook keeps clear is the one laying out, which is the one on screen; an album
    // pushed over this one sets itself from its own pass, and this one sets itself again coming back.
    sgr_albumRoot = page;
    SGRArtworkField *field = fieldIn(page);
    if (field.superview != page) [page insertSubview:field atIndex:0];
    else if (page.subviews.firstObject != field) [page sendSubviewToBack:field];
    if (!CGRectEqualToRect(field.frame, page.bounds)) field.frame = page.bounds;
}
%end

// The list paints itself the base surface from its own pass. Its collection view is a private class whose
// name carries a build hash, so the list view around it -- one public name, one child -- is where it is
// cleared.
%hook _TtC32CreativeWorkPlatform_TemplateKit28CreativeWorkTemplateListView
- (void)layoutSubviews {
    %orig;
    UIView *list = (UIView *)self;
    if (!SGRAlbumPageOf(list)) return;
    if (list.backgroundColor && SGIsBaseSurface(list.backgroundColor.CGColor)) list.backgroundColor = UIColor.clearColor;
    for (UIView *sub in list.subviews) {
        if (sub.backgroundColor && SGIsBaseSurface(sub.backgroundColor.CGColor)) sub.backgroundColor = UIColor.clearColor;
    }
}
%end

// An album card of a discovery section switched back on (More by, You might also like) paints the base surface
// behind its caption, a black box on the field. Only the card's own paint goes: its artwork, badges and
// placeholder are views of their own. Spotify paints it before the card is attached, so no color hook hears it;
// it is cleared on the pass of the cell it is in, which a card has to itself when it is reused.
static void clearCards(UIView *cell) {
    SGForEachView(cell, ^(UIView *v) {
        if (![v.accessibilityIdentifier isEqualToString:@"Components.UI.ContentCardAlbum"]) return;
        CGColorRef color = v.layer.backgroundColor;
        if (color && SGIsBaseSurface(color)) v.backgroundColor = UIColor.clearColor;
    });
}

// Every cell of the list paints the base surface too, and the repaint hook misses it: a cell is painted
// before it is inside the page, and a reused one brings its old paint with it. On the episode page the
// Episode Transcript row, the empty section under it and the rule under that sat on black bands (device,
// trees/continuous/1.txt 2026-09-20).
%hook _TtC12Element_List18CollectionViewCell
- (void)layoutSubviews {
    %orig;
    UIView *cell = (UIView *)self;
    if (isPageCell(cell)) SGRClearCellPaint(cell);
    if (SGRAlbumPageOf(cell)) clearCards(cell);
}
%end

%ctor {
    // Registered whatever the switch says: the flag rows elsewhere lock to these while it is on.
    SGRedesignForceFlags(@"album", @{
        // More stays in Spotify's own header row, blanked with the rest of the column, and the redesign pins
        // its own glass ⋯ over the page (Kit/SGRActionRow.h). In the navigation bar -- which this flag is
        // Spotify's own way of putting it, and which the redesign forced until 2026-09-20 -- it was gone as
        // soon as the page was scrolled (the playlist's tree caught the bar's trailing slot empty,
        // trees/continuous/1.txt, issue #57).
        @"ios-album-albumfeatureproperties-impl.context_menu_in_navigation_bar_enabled": @NO,
        @"ios-album-albumfeatureproperties-impl.share_in_action_row_enabled": @NO,
        // A row is a title and its artists. The video badge is neither.
        @"ios-creativeworkcommons-retrievalrow-impl.track_video_indicator_enabled": @NO,
        // On the album page Spotify's cover square is always concealed, the redesign drawing its own; on the playlist
        // page it is too unless Full bleed covers is off, and then it stays square and still, as in the Music app.
        @"ios-creativeworkcommons-cover-art-tilt-configuration-kit.album_playlist_and_podcast_pages_enabled": @NO,
    });
    if (!SGRedesignedUI()) return;
    %init;
    SGRequireClasses(@[
        @"_TtC28CreativeWorkPlatform_PageKit24CreativeWorkTemplateView",
        @"_TtC32CreativeWorkPlatform_TemplateKit28CreativeWorkTemplateListView",
        @"_TtC12Element_List18CollectionViewCell",
    ]);
}