Repository navigation
Releases
V14.0.0
ReTune Release Notes
All notable changes to ReTune are documented here. ReTune is a fork of
Metrolist, itself based on InnerTune.
Format follows Keep a Changelog, and ReTune uses
semantic versioning.
[14.0.0] — 2026-10-01
versionCode 153 · minSdk 26 · targetSdk 36 · signed with opentune_key
A large rework focused on three things: a calmer, monochrome interface, reliable behaviour on slow
SD cards, and a meaningful reduction in memory churn. No data is lost and the database schema is
untouched — the migration chain is exactly as it was in 13.6.3, so upgrading is in-place.
Interface
- Monochromatic theme. ReTune now ships one hand-tuned neutral palette for light and dark.
Every colour role sits on the same grey axis, so the interface no longer changes hue depending on
wallpaper, album art or system palette. - Dynamic colour removed. The "dynamic theme" toggle, the accent-colour palette picker and the
Material You wallpaper palette are gone. The appearance screen is now just light / dark /
follow system / pure black. - Minimalist shapes. Material 3's expressive corner radii (up to 28dp) were reduced across the
app; the global shape scale is now 4–16dp and oversized per-screen radii were tightened. - About screen simplified to three facts: Created by MO Agamy, Forked by JJDev, and
Buy Me a Coffee. The collaborator list, Discord, Telegram, repository and licence rows are
removed. - Branding. All user-facing "Metrolist" wording is now "ReTune" — crash-report subject, Last.fm
sync copy, user agent, exported folder names and the app name. Themetroliststring key is kept
so existing translations still resolve, and a newretunekey holds the branded value.
Storage and SD card
- The library database never lives on the SD card. It is always kept on internal storage. A
removable volume can be pulled at any moment, and SQLite in WAL mode on slow FAT32 media was the
biggest source of both jank and corruption risk. Only rebuildable caches follow the
"use SD card" preference. - Automatic adoption of existing libraries. Users who previously ran ReTune with the database
on the SD card get their library, playlists and history imported into internal storage on first
launch instead of opening to an empty app. The write-ahead log is carried over so nothing
committed after the last checkpoint is lost. - Lossless storage switching. Toggling "use SD card" now copies the existing song cache,
download cache and image cache to the new location first. Previously the directory was simply
relocated, which silently dropped every download. - Robust volume detection. SD presence now checks the volume is actually mounted and
writable, rather than only asking whether the path is removable. An absent, unmounted or
read-only card falls back to internal storage instead of throwing, so a bad card can no longer
break startup. - Live card detection. Inserting or removing the card is picked up when the storage settings
screen resumes, with no restart required to re-evaluate availability.
Performance and memory
- Unbounded stream-URL generation map fixed.
StreamUrlCachetracked a generation counter per
media id in a plainHashMapthat was never pruned, growing by one entry for every distinct track
ever played. It is now bounded exactly like the URL cache. - Album-art decoding made cheap. Notification and lock-screen artwork is sub-sampled to 1024px
on the long edge instead of being decoded at full resolution, and opaque copies are stored as
RGB_565, roughly halving retained memory. The intermediate scaled bitmap is released
immediately. - No more leaked coroutine scopes.
toggleLike/toggleLibraryon the song, album, artist and
playlist entities, and the lyrics lookup helper, each allocated a fresh parent
CoroutineScope(SupervisorJob())per call that nothing could ever cancel. They now use a single
supervised scope. - No blocking work in service teardown. The last playback position is persisted on a
process-wide scope instead of viarunBlockinginsideMusicService.onDestroy, which had been
stalling service restart on every track change. - Cheaper image pipeline. Coil crossfade is disabled, removing a second live bitmap per list
cell and a redraw per image while scrolling.
Smooth on a slow SD card
- Cache size polling made cheap. The storage screen walked three cache trees three times per
second on the main thread. Polling is now every 2 seconds, on an IO dispatcher, and only while the
screen is actually resumed. - Keeping the SQLite database on internal storage removes the largest single source of main-thread
stalls on slow removable media.
Dependencies
- materialKolor removed. The last use was a colour-ranking helper for the player's gradient
background, which is now a 20-line local implementation. One fewer library in the release APK.
Compatibility
applicationId(com.jjdev.retune), all intent filters, deep links, the FileProvider authority
and the Room schema are unchanged, so this is an in-place upgrade.- Previous playlist exports under
Documents/MetrolistExportsremain shareable through the
FileProvider; new exports go toDocuments/ReTuneExports. - Retained preference keys (
dynamicTheme,selectedThemeColor) are intentionally left in place so
existing DataStore files keep parsing.
V13.6.3
Changelog
1. Enhanced Download Speed
- Engine optimization: Modified
DownloadUtil.ktto increase the efficiency of the download engine. - Simultaneous downloads: Increased
maxParallelDownloadsfrom 16 to 32. - OkHttpClient configuration: Optimized
maxRequestsandmaxRequestsPerHostby setting them to 128. - Connection pool: Expanded the
ConnectionPoolto 20 idle connections with a 10-minute keep-alive time. - Network timeouts: Adjusted timeouts to 20 seconds for better stability on variable networks.
2. JJDev Studio Donation Link
- About screen: Added a "Buy Me a Coffee" link for JJDev Studio.
- String resources: Added the corresponding
donation_linkstring tometrolist_strings.xml.
3. Improved Image Caching
- App.kt optimization: Implemented changes to fix slowness in image loading:
- Memory cache: Increased from 15% to 25% of available RAM for faster UI responsiveness and fewer disk/network hits.
- Disk cache: Configured a dedicated IO dispatcher for cache cleanup, preventing UI stutters during pruning on SD cards or internal storage.
- Strong references: Enabled
strongReferencesEnabledin Coil to retain frequently used images in memory longer.
4. Removal of AI Lyrics Translation
- Code simplification: Completely removed the AI-powered lyrics translation feature to streamline the app and respect the requirements:
- Deleted files: Removed
LyricsTranslationHelper.kt,AiSettings.kt, and AI service files (DeepLService.kt,OpenRouterService.kt, etc.). - UI cleanup: Removed the "AI Lyrics Translation" entry from both Settings and the Lyrics Menu.
- Component cleanup: Refactored
ExperimentalLyrics.ktandOriginalLyrics.ktto remove translation-related UI components and logic. - Preferences & Strings: Removed AI configuration keys from
PreferenceKeys.ktand related strings frommetrolist_strings.xml.
- Deleted files: Removed
5. UI and Usability Improvements
- Material Design 3: Ensured full adherence to Material 3 guidelines across all modified screens.
- Responsiveness: Improved overall app performance by optimizing resource-heavy components (images and downloads).
- Layout refinement: Enhanced the About screen layout for a cleaner display of community and support links.
V13.6.3
V 13.6.3 for Retune
The project was refactored after failing due to multiple errors, so I restarted it using the Metrolist codebase.
Features:
- SD card compatibility maintained.
- Stable Metrolist engine.
- Listen Together feature.
- Support for Metrolist backups.
- Known bugs fixed.
Notes
- Unfortunately, backups from the old Retune version will not work.
- The app will install as a separate application rather than updating the existing one, as the APK signature has changed.
- The app will be updated whenever bugs are reported, or on a schedule of every 2 weeks or 3 days.
Forked by JJDev
V0.8.4
ReTune V 0.8.4
What,s New?:
- Core: Fixed "Invalid stream URL" and download errors via enhanced client rotation and signature retries.
- UI: Fixed Player layout shifting, centered title/artist, and refined dynamic color extraction.
- System: Implemented GitHub Auto-Updater with automatic APK installation via UpdateReceiver.
- Fix: Improved SD Card file access fallback and fixed Theme/Gradient variant bugs.
- Cleanup: Removed legacy Spotify references.
- Performance: Optimized ExoPlayer buffers for instant "Metro-Speed" playback.
Developed By JJDev
V0.8.3 Fix
feat: major overhaul - UI modernization, audio stability, and auto-update system
-
UI/UX:
- Redesigned Player Screen with centered controls and bold typography (Meld/VIVI style).
- Implemented 'BLURMOV' immersive animated backgrounds as default.
- Forced high-contrast (Light Mode) controls in Player for better visibility.
- Standardized Navigation Bar and MiniPlayer layout for better screen integration.
- Optimized Home Screen with a dynamic greeting header and user avatar.
-
Audio & Core:
- Optimized ExoPlayer buffers (15s min) for near-instant playback start.
- Implemented auto-refresh for InnerTube API (visitorData/tokens) for LTS stability.
- Added automatic retry logic for network and timeout errors during playback.
- Fixed SD Card and local file access bugs via robust File/ContentUri fallback.
-
Cleanup & Maintenance:
- Completely removed Spotify integration (routes, models, viewmodels, and assets).
- Reduced app weight by removing unused dependencies and the 'spotify' module.
- Implemented a new UpdateManager to fetch and download latest APKs from GitHub Releases.
V8.3
V 0.8.3 of ReTune
What,s New :
- Data Saver: this feature helps to save data
- InnerTube auto updater : updates innertube to the latest version
- Better player ui
- Reduce data usage
_ Developed By JJDev (jntx studio new name)_
V0.8.1
Release Notes v0.8.1 💎
-
New Progress Indicator: The MiniPlayer now shows the song's progress in a circular way around the cover art.
-
Refined Visual Identity: Songs and albums now have a 25% rounded square design for better visual distinction.
-
Modernized Menu: New 3-dot menu button with a stylish, ultra-rounded dropdown.
-
Space Optimization: Fixed the visual bug where the MiniPlayer progress bar was hidden by the system navigation.
V0.8.2
Release Notes v0.9.0 🚀🔌
-
Spotify Login 2.0: Say goodbye to API keys! Log in directly from the web.
-
Ultra-Stable Buffer: Smooth playback even on older or slower SD cards.
-
Data Saver Mode: Automatic bitrate optimization when using mobile data.
-
Android Auto Ready: Ready for your car.
V0.8.0
Release Notes v0.8.0 🚀
New Killer Feature!: Real-time waveform viewer on the "Now Playing" screen.
-
Material You v2: Refined interface with tonal containers and smoother animations without increasing the app size.
-
Storage Control: Pick your preferred offline downloads folder (improved SD Card support).
-
Spring Cleaning: The old MP3 downloader has been removed to make way for a more robust and modern offline management system.
-
Lyrics Translation: Improved stability when translating lyrics in real time.
V1.0.1
V 1.0.1 of Retune!
Features of this version
(feat:)Add mp3 music downloader and download folder
Technical Details
- added newpipe extractor dependency
- added music downloader using newpipe extractor
- fixed some bugs
- remove all the themes and left only the blueberry theme
- add JAudioTagger dependency