~ knotless Search/
↑↓ move↵ open⇧↵ all results

geesawra.industries/hydraulophone

An unofficial YouTube Music app for iPhone, iPad, and Mac.

0
0
main
99 lines · 6.4 KB Raw History

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.