geesawra.industries/hydraulophone
An unofficial YouTube Music app for iPhone, iPad, and Mac.
Artwork URL and variant policy
Hydraulophone's artwork adapter is informed by AuraMusic's pinned
185a77d31733047de06cbec619d40731755a0ec1 source:
Observed behavior
Aura's String.resize helper leaves unknown image hosts unchanged. For
googleusercontent.com and ggpht.com, it replaces an existing wNNN-hNNN
path segment or rebuilds the known =w...-h...-p-l90-rj size suffix. For
i.ytimg.com, it promotes default, mqdefault, hqdefault, and
sddefault JPEG names to hqdefault or maxresdefault at the helper's
320/480-pixel thresholds.
Aura's thumbnail model otherwise returns the final response thumbnail. That
ordering is not treated as a contract here: ResponseParser selects the
largest variant whose declared width and height are both positive, with
response order as a deterministic tie-breaker. If no variant declares usable
dimensions, it retains the final valid URL as a compatibility fallback.
The Swift image boundary applies the observed host-specific size behavior using
the rendered point size multiplied by displayScale, capped at 2,048 pixels.
It validates HTTPS hosts and changes only the known path/size forms above.
Unknown hosts, non-HTTPS URLs, and unsupported paths remain unchanged. List
artwork stays near its rendered density. Lock Screen, CarPlay, and other Now
Playing artwork requests 2,048 pixels through the same adapter; downloaded
artwork is saved at that resolution as well, subject to the existing 2 MB
download limit. The original media URL is not stored in the cache.
This is an intentional Hydraulophone adapter choice, not an official YouTube API guarantee. YouTube may change these undocumented URL forms; update the host/path allowlist and this note together if that occurs.
Album playback context
The collection view model fills missing song artwork and album names from the selected album before publishing its tracks. It applies the same fallback to the first page, refreshes, and continuation pages, so rows and playback queue entries share the enriched metadata. A song's own artwork or album name takes precedence. Playlist covers are not substituted for song artwork because a playlist can contain tracks from different albums.
The same album context fills a missing or Unknown artist track artist only
when the album subtitle exposes one artist, such as Album • Protest The Hero
or a bare artist name. A real track artist always wins. On 2026-09-23, the
authenticated Within album header showed Protest The Hero while its song
renderers decoded without artists; the fallback carries that known name to
the playback queue and media surfaces. This is a presentation fallback based
on display text, not a stable InnerTube field. If that subtitle shape changes,
the adapter should prefer a structured album artist rather than guessing.
This is an intentional Hydraulophone presentation choice using already decoded album metadata; it does not add a request or alter the protocol parser.
Artist and album detail headers — 2026-10-14
The detail adapter additionally consulted AuraMusic commit
185a77d31733047de06cbec619d40731755a0ec1:
Artist portraits may appear in immersive header thumbnails, visual header
foreground thumbnails, or music header thumbnails. Album covers can appear in
the primary column's responsive header, the older detail header's cropped-square
thumbnail, or the response background. The secondary column holds tracks.
Responsive header artist credits use straplineTextOne; older headers use
linked subtitle runs. A navigation reference from a song can contain only a
name and browse ID, so its missing thumbnail does not mean the detail page has
no artwork.
Hydraulophone carries optional CatalogPageHeader metadata on initial track
and artist pages. Header lookup is bounded to recognized response headers and
the primary browse column; it never searches menus or steals song/album artwork
for an artist portrait. The existing largest-valid-variant selection also
accepts the music header's direct thumbnail list. Unlike Aura's background-first
album helper, Hydraulophone prefers explicit header artwork and uses the
background as a fallback. This is an intentional presentation policy.
View models prefer the fetched header, then the incoming navigation reference. Albums can finally use a known album track thumbnail; that fallback is computed once per page replacement. Continuations and successful partial refreshes retain known header values, and session clearing drops them. Album credits/artwork reach track rows and queue metadata. A known guest credit never inherits a different artist's navigation reference. IDs and browse params remain unchanged.
The Swift adapter is an original implementation of these field shapes. Synthetic
fixtures dated 2026-10-14 live in CatalogResponseParserTests.swift; native app
tests cover missing-link artwork, continuation/refresh retention, credit
inheritance, and image decoding. UI fixture headers use locally generated PNGs.
No cookies, authorization values, personal account responses, or media URLs are
recorded. If header renderers move or change, update the bounded adapter and
these fixtures together; a missing optional header remains a typed absence.