ArchiveTune

Changelog v15.0.0

ArchiveTune 15.0.0 is a major release focused on playback reliability, faster stream resolution, player improvements, lyrics, downloads, and deeper YouTube Music integration.

This release introduces the V10 Editorial Player, next-song stream preloading, SponsorBlock, YouTube Music podcasts, lyrics translation, Spotify and TIDAL Canvas, Google Drive backups, playlist CSV export, improved Quick Picks, and a substantially reworked YouTube playback stack.

A large number of stability, memory, networking, Cast, artwork, AOD, download, lyrics, and account-related issues were also addressed.

✨ Major Highlights

🎵 V10 Editorial Player

ArchiveTune 15 introduces the new V10 Editorial Player, together with further improvements to artwork-driven theming and player interactions.

• Integrated the V10 Editorial Player.
• Improved artwork color extraction and player behavior.
• Backported wallpaper color extraction to Android versions below API 31.
• Integrated continuous shape morphing for the MiniPlayer and Navigation Bar.
• Improved seekbar, queue, BottomSheet, and media-state interactions.
• Fixed visibility-off icon rendering.

Contributors: @IIXII-L192, @sang765, @adam-adrian, @shinonatsukii, @rukamori, @farhanansari888

Related: #1219, #1229, #1230, #1282

⚡ YouTube Playback & Stream Resolution Overhaul

The YouTube playback stack received one of its largest architectural updates so far.

ArchiveTune now combines updated playback clients, video-bound PoTokens, JavaScript runtime handling, refreshed player analysis, and faster extraction paths to improve playback reliability and startup speed.

• Integrated Web, GVS, creator, and video-bound playback tokens.
• Separated session authentication from video-specific tokens.
• Integrated automatic JavaScript challenge handling.
• Integrated JavaScript runtime prewarming.
• Updated bundled YouTube JavaScript and client logic.
• Improved authenticated and age-restricted playback.
• Integrated authenticated embedded-client support.
• Improved TV, Android VR, anonymous, and direct-stream fallbacks.
• Preserved authentication cookies and session state across retries.
• Restored authenticated youtubei playback.
• Integrated one-shot player-backed stream resolution.
• Improved stream-client backoff and blocked-client handling.
• Reduced YouTube player analyzer memory usage.
• Removed obsolete IP rotation and manual cipher handling.

Foreground playback now receives higher priority than downloads and speculative background extraction.

Contributors: @rukamori, @shinonatsukii, @mikooochi

🚀 Next-Song Stream Preloading

ArchiveTune can now resolve an upcoming stream before the current song finishes.

• Integrated optional next-song stream preloading.
• Integrated playback performance settings for preload behavior.
• Preloads one upcoming stream at a time.
• Prioritizes active playback over background preload work.
• Shares already-resolved streams between compatible operations.
• Integrated faster playback stream resolution paths.
• Bounded stream-resolution work to prevent runaway tasks.

Contributors: @rukamori, @shinonatsukii

🔁 Playback Recovery & Crossfade

Playback recovery and crossfade behavior have been substantially hardened.

• Eliminated silence during crossfade handoff.
• Improved recovery when crossfade is unavailable.
• Preserved playback position during recovery.
• Improved recovery after media-host and stream failures.
• Recovers from corrupted cache entries and mismatched streams.
• Improved stream-resolution diagnostics.
• Registered the media session correctly with the playback service.
• Prevented artwork work from being cancelled unexpectedly.
• Prevented stale paused Discord presence updates.
• Improved playback error details and reporting hints.

Contributors: @ru

Changelog V14.1.0

This release focuses on playback compatibility, Canvas stability, Android 15 artwork handling, YouTube stream-client improvements, lyrics provider support, and a major expansion of the player and always-on-display experience.

It also improves network-gate handling, playback authentication, queue behavior, Discord integration, Cast support, localization, playlist imports, and several Android UI edge cases. The release includes substantial community contributions across player design, AOD, lyrics, localization, and playlist management.

Major Highlights

Canvas Artwork and Android Compatibility

Canvas playback and notification artwork handling have been hardened for newer Android versions and a wider range of media codecs.

• Added Canvas media-codec validation before attempting playback.
• Prevented retry loops and crashes when Canvas videos are unsupported.
• Added conditional artwork URI generation for Ice Cream builds to avoid Android 15 metadata-artwork crashes.
• Simplified notification artwork URI conversion.
• Improved Canvas compatibility checks and playback stability.

Contributors: @rukamori, @mikooochi

Related issue: #1047

Material Extended V9 Player

ArchiveTune now includes a major Material Extended V9 player experience with dynamic artwork-driven theming and improved player interactions.

• Added the Material Extended V9 player theme.
• Added dynamic majority-color extraction and animated color transitions.
• Improved player control hierarchy and layout.
• Added thread-safety improvements around player state.
• Improved download and backup integration.
• Refined navigation-bar behavior and player surfaces.
• Improved responsiveness when switching between tracks.

Contributor: @IIXII-L192

Pull request: #1069

YouTube Playback and Stream Clients

YouTube playback compatibility has been updated with a new Android VR client and improved authentication behavior.

• Added the "ANDROID_VR_1_65_10" stream client.
• Updated stream-client ordering logic.
• Replaced the previous "ANDROID_VR_NO_AUTH" client handling.
• Improved primary Web playback authentication without requiring a PoToken in applicable cases.
• Extracted Web playback PoToken minting and forbidden-request detection.
• Improved playback authentication state handling.
• Refined token binding and persisted visitor-data handling.

Contributors: @rukamori

Lyrics and BetterLyrics

Lyrics provider coverage has been expanded with support for BetterLyrics Portato.

• Added BetterLyrics Portato support for word-synchronised lyrics.
• Added provider handling for songs that do not expose syllable-synchronised lyrics.
• Improved lyrics provider selection and ordering.
• Kept lyrics provider actions visible when changing provider settings.
• Improved lyrics search and provider reliability.

Contributor: @rukamori

Related issue: #1060 Related issue: #1128

Always-On Display and Lock Controls

The AOD experience has been substantially expanded with additional playback and device-lock controls.

• Added DreamService-based Always-On Display support.
• Added smart-lock behavior.
• Added shake-to-unlock support.
• Added automatic locking.
• Added additional AOD interaction and marquee behavior.
• Improved sleep-timer interaction with playback.
• Improved AOD touch handling.

Contributor: @Balajitechlabs

Pull request: #1120

Playlist Import Improvements

M3U and CSV imports now provide better source matching and a safer review process.

• Added source-aware playlist matching.
• Added a review step before imported songs are saved.
• Improved matching of imported tracks against available media.
• Reduced accidental or incorrect playlist entries during import.

Contributor: @Sandy4j

Pull request: #1041

Localization and Android Locale Support

Localization handling has been improved, including proper Egyptian Arabic resource

Changelog V14.0.0

This release expands background music recognition, improves playback and device controls, introduces scheduled backups, enhances download management, and adds broader filtering for blocked artists and music videos.

It also delivers major updates to the mini player, media-detail screens, lyrics customization, Spotify playlist downloads, Canvas artwork handling, diagnostics, playback authentication, and application stability.

Major Highlights

Background Music Recognition

Music recognition can now operate while ArchiveTune is outside the foreground.

• Added background device-audio recognition through the Music Recognition quick-settings tile.
• Added a background recognition preference to the Music Recognition screen.
• Fixed background recognition compilation failures.
• Improved recognition service reliability and lifecycle handling.

Contributor: @mikooochi

Playback Devices and Audio Information

Player V7 and V8 now provide better system output controls and more detailed local-file information.

• Added a native audio-output switcher.
• Added a reactive playback-device indicator.
• Added real bitrate and sample-rate information for local audio.
• Added fallback metadata when bitrate or sample-rate information is unavailable.
• Improved file-size formatting with dynamic units and decimal precision.
• Fixed an Android 10 crash when opening the output switcher.
• Added a V7 and V8 volume-bar preference.
• Prevented duplicate copies of the current song from appearing in the queue.

Contributors: @adam-adrian, @mikooochi, @rukamori Pull requests: #981, #988, #991, #1000

Mini Player and Player Controls

Player surfaces and controls have been reconstructed for clearer interaction and better visual consistency.

• Reconstructed the mini player.
• Restored circular artwork progress.
• Replaced the floating mini-player toolbar with a compact navigation bar.
• Added explicit-content badges across all player styles.
• Added a lyrics player-controls visibility toggle.
• Added a Canvas artwork refresh action.
• Added reactive Canvas artwork updates during playback.
• Added a V7 and V8 volume-bar toggle.
• Aligned paired floating mini-player surfaces.
• Improved player-menu Canvas action visibility across player designs.

Contributors: @mikooochi, @rukamori

Download Library and Spotify Downloads

Download management now provides clearer grouping, searchable content, and expanded Spotify playlist support.

• Added grouped download-management tabs.
• Added searchable downloaded-media rows.
• Added Spotify playlist download actions.
• Added download-state handling to Spotify playlist headers.
• Added concurrent Spotify track resolution with up to eight active resolutions.
• Fixed synchronized pause controls in download headers.
• Restored paused-download controls.
• Fixed queueing of subsequent downloaded songs.
• Restored artwork for downloaded songs.
• Reused playback data when preparing downloads.

Contributors: @rukamori, @mikooochi

Scheduled Backups

ArchiveTune can now create backups on a configured schedule.

• Added scheduled backup support.
• Added scheduled-backup repository handling.
• Repaired the scheduled-backup settings layout.
• Improved document-name handling for backup destinations.

Contributor: @mikooochi

Blocked Artists and Music-Video Filtering

Content filtering is now enforced more consistently across playback, playlists, albums, artists, and library screens.

• Removed blocked-artist items from playback queues.

• Filtered blocked artists before playback begins.

• Added persistent music-video metadata to songs.

• Added a preference for hiding music videos.

• Applied music-video filtering to:

  • Artist content
  • Albums
  • Cached playlists
  • Online playlists
  • Local playlists
  • Liked songs
  • Library songs
  • Artist-song collections

• Preserved music-video

Changelog

Focuses on lyrics improvements, extractor playback routing, YouLyPlus support, app icon customization, artist blocking, library download visibility, Discord Rich Presence reliability, search behavior, cache/storage stability, and broader Material 3 UI polish. This release also includes localization updates, dependency updates, icon-generation pipeline improvements, and internal refactors.

Major Highlights

Lyrics, Providers & Playback Routing

Lyrics handling has been expanded with stronger provider support, better TTML behavior, and improved playback URL routing through the extractor pipeline.

• Added romanization and translation support to both enhanced and legacy lyrics modes.
• Added the YouLyPlus lyrics provider.
• Added cookie forwarding to streamingExtractionManager.extractAudioUrl.
• Routed extractor playback URLs through ResolvedUrlRoutingDataSource.
• Recognized URI paths for extractor playback.
• Preserved line-synced Better Lyrics TTML output.
• Classified TTML sync badges more accurately.
• Filtered empty Paxsenix lyrics payloads.
• Gated automatic provider translations.
• Wrapped long lyrics in both lyrics modes.

Contributors: @rukamori Related: #961

Search, Library & Artist Controls

Search, library, and artist-management flows have been refined with new interaction behavior and stronger content filtering.

• Opened online search from the floating navigation toolbar on double tap.
• Opened the search overlay when tapping the Search tab while already on the Search screen.
• Added global artist blocking and blocked-content handling.
• Added downloaded album visibility in Library Albums.
• Added a downloaded album filter.
• Corrected Local Playlist search mode layout.
• Prevented Home app bar overlap.
• Reserved Home chip space during loading.
• Tightened Home section spacing.

Contributors: @rukamori, @sang765, @mikooochi Related: #940, #944

App Icons & Launcher Customization

Launcher icon customization has been expanded with metadata-driven selection, GitHub author actions, and a more reliable adaptive-icon generation pipeline.

• Added a metadata-driven launcher icon selector.
• Added GitHub author actions to the icon screen.
• Matched the icon selector design to the app’s UI language.
• Generated full adaptive launcher icons.
• Generated adaptive icons from SVG metadata.
• Preserved SVG launcher artwork.
• Prevented duplicate adaptive icon layers.
• Created the adaptive drawable directory when needed.
• Enforced 512 vector dimensions for icon submissions.
• Sanitized SVG doctype declarations.
• Handled missing vector fill colors.
• Added opaque vector fill support for submitted icon artwork.
• Aligned the selected icon stroke with row shape.
• Prevented main-thread vector inflation.
• Synchronized the selected launcher task icon.

Contributors: @rukamori, @mikooochi

Material UI, Motion & Recognition

The app receives broader Material motion adoption, tonal backdrop changes, and recognition-screen refinements.

• Applied the global Material motion scheme.
• Replaced the previous mesh background with a tonal backdrop.
• Rebuilt the Music Recognition flow and UI.
• Added restrained Material Shape recognition anchoring.
• Fixed recognition callback, button shape, and composable shape creation issues.
• Standardized settings header scroll behavior.
• Refactored the main header scroll style.
• Corrected navigation callback typing.
• Reset TopAppBarState height and content offsets.
• Filled the AOD shape picker grid width.
• Used compatible connected button shapes in Debug Settings.

Contributors: @rukamori, @adam-adrian, @mikooochi Related: #941, #963

Discord Rich Presence & Social Playback

Discord and Music Together reliability have been improved across status rendering, gateway sync, activity platform storage, and session state.

• Supported multiple artists in Discord RPC status.