Say goodbye to buffering and playback issues while listening to music in Saavn 320 kbps quality.

Streaming has been migrated from third-party servers to our own servers, delivering a faster, more reliable, and seamless listening experience with improved stability and performance.

This is a maintenance release focused on playback stability and reliability improvements. The only new addition is the Service Uptime checker.

Playback Fixes

• Resolved multiple playback errors (1004, 2008, 3001) by improving network retry logic and securing AudioTrack recovery.
• Fixed silent playback caused by mid-stream container changes — stream quality is now locked for the duration of the currently playing track.
• Fixed an ExoPlayer crash that occurred when a stream's container format fell back to a format different from what was cached.
• Fixed seek errors (error 2008 — IO read position out of range) when skipping to a segment within a downloaded song.
• Fixed IO error 2000 (unspecified IO error) by properly recovering the audio stream and cache state.

Offline & Cache Fixes

• Fixed downloaded songs incorrectly requiring an internet connection due to a cache metadata mismatch — fully downloaded tracks now play offline as expected.
• Fixed audio fallback toast notifications appearing only once per app session instead of triggering on each relevant event.

UI Fix

• Removed the volume percentage indicator from the Phone Speaker row in the Audio Device selector.

New Feature

• Service Uptime Checker — Available under Content Settings, this tool allows users to monitor the real-time status of YouTube Music, JioSaavn, and Qobuz.

No other new features or behavioral changes are included in this release.

New Features

• Pin Playlists — Long-press to pin playlists to the top of your library.
• Sync to YouTube Music — Sync local playlists via the playlist menu.
• Settings Search — Filter settings categories and sub-settings instantly.
• Song Suggestions — Discover and add related songs at the bottom of local playlists.
• Canvas Provider (Tidal) — Animated album canvas with improved matching accuracy.
• Audio Fallback — Opus failure auto-reroutes to JioSaavn 320 kbps, and vice versa.
• Markdown in Changelog — Bold, italics, inline code, and links rendered natively.

UI & Design

• Echo Find Screen — Material You pill button, animated wave visualizer, edge-to-edge blur.
• Recognition Screen — Glassmorphism layout with full-square album art and playback FAB.
• Suggestions & Menus — Rounded edges on suggestions list; removed grey header backgrounds from bottom sheets.
• Online Playlist Header — Count and duration shown above action buttons.
• Logout Dialog — Stacked buttons fix text clipping.

Bug Fixes

• Crash on Recognition — Fixed IllegalStateException via main thread dispatch.
• Offline Playback — Fixed downloaded songs failing due to bad cache length reads.
• Apple Music Black Screen — Album art now shows for downloaded songs.
• Volume Slider — Stays in sync with system volume.
• Background Updater — Runs as background service with auto-retry; fixed notification spam.
• Comments Button — Removed from Listen Together screen.

Build

• FFmpeg — Switched to ffmpeg-kit-audio; removed unused aria2c dependency.
• ABI Filters — Fixed per-arch filters to prevent universal APK generation.

Bug Fixes

• Resolved an issue where songs downloaded at Saavn (320 kbps) or YouTube Music quality would fail to play and skip during offline playback.
• Corrected the stream URL caching logic in the download resolution process.

Improvements

• Extended local library playback support to include virtually all standard audio formats (.mp3, .wav, .ogg, .aac, and others) by utilizing native Media3 extractors in place of the previously restricted format set.

New Features

• Added a setting under Appearance > Lyrics to automatically hide the status bar upon entering full-screen lyrics mode.
• Added a "Play Next" option to the multi-selection menu for albums and playlists, enabling multiple selected tracks to be queued immediately after the current song.
• Added a "Legacy Icon" toggle under Appearance settings to revert the application icon to its original design.

Bug Fixes

• Fixed an issue where the Local songs screen inside the Library did not display a back button, and corrected its navigation logic to return to the Library home rather than exiting the tab.
• Fixed system back button behavior on the Library screen to properly return to the mix view instead of the home screen when navigating from library chips.
• Corrected UI overlapping issue where the back button on the Local Songs screen was hidden under the main navigation bar.
• Refactored library layout spacing and dynamic top app bar padding across Library tabs.

New Features

• Implemented a new Export as MP3 feature that downloads, transcodes via FFmpeg, and embeds ID3 metadata (including album art) into local MP3 files directly from the player and song menus.
• Added a new Exported auto-playlist in the Library to easily filter and view all exported MP3 songs, with visibility toggles in Appearance Settings.
• Added full changelog support to the System Update screen. Update notes and descriptions are now fully rendered with Markdown support (bold, italics, code blocks, and clickable links).
• Added a new setting in Appearance Settings to show audio codec information centrally below the player timeline.
• Added an option in Appearance Settings to hide the volume slider, specifically available when the Apple Music Inspired UI is active.
• Added full Persian (Farsi) translation. Thanks to @mcuteangel.

Changes

• Replaced Qobuz with JioSaavn (320kbps) for streaming and downloading.
• Enabled Crossfade support specifically for Saavn (320kbps) streams.
• Crossfade is now automatically disabled when Qobuz (Lossless) audio quality is selected; the toggle becomes unclickable with an explanatory message.
• Migrated default Listen Together server to Echo Music Server on Hugging Face (wss://iad1tya-echomusic.hf.space/ws). To modify or verify the URL, navigate to Listen Together > Settings > Server URL.
• Updated the audio codec display to show codec name, bitrate in kbps, and lossless indicator.
• Adjusted the audio codec display to align horizontally with the music playback timestamps.
• The playback queue is now unlocked for rearrangement by default.
• The Quick Picks carousel is now always pinned to the top of the Home Screen.
• Updated the previous and next player buttons to maintain a consistent translucent white styling across all themes.
• Unlocked the player background style setting, allowing users to customize their background even when the Apple Music Inspired UI is enabled.
• Repositioned the Listen Together connection controls to the top app bar.
• Moved the Listen Together usage guide below the settings card.
• Revamped the "How to use Listen Together" instructions with a clean, numbered list within a Material 3 card.
• Moved "Import from Spotify" back to the Import page inside Backup & Restore settings, placing it above the local file import option.
• Removed FLAC codec information display (sample rate, bit depth) from the Now Playing screen.
• Removed the disc icon from the album title on the Album screen.

Bug Fixes

• Fixed an issue where the canvas videos were being stretched on the album, artist, and square player screens by properly applying a zoom crop to fit the shapes.
• Fixed an issue where locally liked songs were incorrectly removed from the library instead of being pushed to the YouTube server during cloud sync.
• Fixed random playback pauses by clearing ghost cache entries and removing unnecessary retry delays.
• Fixed an issue where restoring from a manual zip backup could cause database corruption and app crashes by explicitly clearing old WAL cache files during restore.
• Fixed a bug where the player would show active playback with no audio when reopening from active apps, caused by an out-of-bounds queue index during state restoration.
• Prevented text overflow on the Subscribe, Radio, and Shuffle buttons within the Artist screen.
• Prevented potential data wipes on future app updates by safely disabling destructive Room database migrations.
• Improved parsing for localized artist statistics, properly extracting subscriber and monthly listener counts when APIs return text mixed with numbers across different languages.

Changelog

Improvements & Fixes

• Fixed a crash that could occur when enabling the Hide Player Thumbnail option.
• Improved backup restore compatibility and handling. Restoring backups from older or incompatible versions will now fail gracefully instead of causing a crash, with clearer feedback provided to the user.
• Refreshed the default artwork used by the home screen widget for a cleaner appearance.
• Various bug fixes, stability improvements, and UI refinements.

Changelog

Fixes

• Fixed a MusicService retry issue that could incorrectly resume playback after an AudioTrack error. The player now preserves the playWhenReady state before pausing and uses it to determine whether playback should resume during recovery, improving playback reliability.

UI Improvements

• Increased Floating Action Button (FAB) margins (end = 16dp, bottom = 64dp) to prevent overlap with other UI elements.

• Improved library filter layouts by:

  • Vertically centering filter rows.
  • Adding top and bottom padding to FilterChip components for better spacing and touch targets.

• Replaced the decorative lock Surface in the Mix and Playlists screens with a simple 16dp spacer, resulting in a cleaner layout.

• Added the required width-related imports to support layout updates.

Enhancements

• Improved playback robustness during audio output recovery scenarios.
• Refined spacing and alignment across multiple screens for a cleaner and more consistent user experience.

Changelog

Fixed

• Improved video ID extraction with robust fallback handling across multiple page parsers:

  • ArtistItemsPage
  • ArtistPage
  • HistoryPage
  • LibraryPage
  • RelatedPage
  • SearchSuggestionPage
  • SearchSummaryPage
  • SearchPage

• Added support for extracting video IDs from additional renderer structures, including:

  • navigationEndpoint
  • overlay play button renderers
  • flexColumns-based layouts

• Enhanced SearchPage diagnostics by logging debug information whenever expected metadata fields such as secondaryLine, id, or artists are missing.

Changed

• Updated OnlineSearchViewModel to preserve video results when the active search filter is set to Videos, preventing valid video items from being filtered out.

• Refined SearchSummaryPage filtering behavior:

  • The Videos summary is now always preserved.
  • Other summaries continue to respect the "videos disabled" setting.

Changelog

Fixed

• Fixed some albums and playlists appearing empty due to missing video and set ID resolution.

Improvements

• Improved album and playlist parsing reliability by expanding video and set ID extraction fallbacks.

• Added support for resolving IDs from additional renderer locations, including:

  • navigationEndpoint.watchEndpoint
  • musicItemThumbnailOverlayRenderer → musicPlayButtonRenderer → playNavigationEndpoint
  • flexColumns navigation endpoints

• Both videoId and playlistSetVideoId are now checked across multiple fallback paths before failing, improving compatibility with varying YouTube Music response structures.

Sharing

• Migrated all shared links from music.youtube.com to share.echomusic.fun.

• Shared songs, playlists, and channels now use Echo Music's centralized share domain across:

  • Playback actions
  • UI share menus
  • Database entities
  • Innertube models