# New Features - Added the ability to share the currently playing song's information and album artwork to social media. - Added the ability to share artist biographies and album/work reviews provided by the MAI plugin, supporting both plain text and Markdown formats. - Added a quick-access entry in the title area of Album and Artist pages to view artist bios and reviews from MAI. - Added a marquee (scrolling text) effect for song titles and artist names on the Now Playing screen. This can be toggled in the Appearance settings. - Added an "Add to Playlist" shortcut on the Now Playing screen. This feature can be enabled in the Appearance settings. - Added support for the new album sorting options introduced in LMS 9.1, such as "Most Played" and "Recently Played". - Added the ability to sort Albums/Releases in search results. # Optimizations - Enhanced browsing by enabling a sidebar alphabetical index for sort modes like "Album", "Artist, Album", and "Artist, Year, Album". - Improved the layout of the Album Details page by changing the "Contributing Artists" list to an expandable/collapsible format. - Optimized artist image display to be compatible with LMS 9.1's local artist picture feature. Local artist images are now displayed when MAI does not provide one. # Bug Fixes Fixed an issue where the "Appearances" category in an artist's releases list was not displayed correctly.

# New Features ## Music Search - Improved search ranking to prioritize local library, then Spotify, Qobuz, Tidal. - Added settings to sort categories and customize the list style of search results. - Added source icons in grid-view search results. - Redesigned the search results page with the unified xTune style. - Playlist search now supports case-insensitive matching. - Fixed an issue where works could not be found via search. ## Built-in Player - Added full gapless playback support (with no sample rate change). - Improved audio format switching by briefly muting audio to prevent pops/clicks. ## Now Playing & Current Playlist - Added a grouped playlist view (by Work, Disc, GROUPING, Album) with a toggle button at the top. - Added Work information display to the Now Playing page (requires MAI 1.22.0 or higher). - Redesigned Artist tab: shows composer by default for classical music and supports multiple artists. ## Other - Added a new toggle in the Release Appearance settings to control whether to group tracks using the GROUPING tag. - Added a progress bar to the iPad mini player (can be enabled in settings). - Added a Work Review section to the Work detail page (requires MAI 1.22.0+). # Optimizations - Redesigned the theme switch button icon to preview the next theme. - Added a link from the Album's Work grouping menu to the corresponding Recording. - Added links from Recording details to its Work and Album. - Improved year display in artist album lists based on the focused artist. - Various UI, style, and text size refinements. # Issues Fixed - Fixed erratic volume display during adjustment. - Fixed hardware volume keys not controlling player group volume. - Fixed incorrect progress text display in Now Playing.

This is a maintenance update for xTune 3.0.0. While retaining the new features introduced in version 3.0.0—such as Release Type Grouping and One‑Tap Search—this release addresses the following issues: - Fixed a crash that occurred when the number of Release Types exceeded 18 - Fixed an issue where the CarPlay interface would unexpectedly refresh and return to the Home screen - Fixed an anomaly with Qobuz search in the One‑Tap Search feature - Restricted the scope of One‑Tap Search to Local, Spotify, Qobuz, and Tidal

# New Features ## Release Types and Compilations - Renamed "Albums Appearance" to "Releases Appearance", adding a toggle between Compact and Expert modes, plus settings for release types and grouping. - In Compact mode, "Albums" is used for all navigation and menus. In Expert mode, "Releases" is used, with advanced features like grouping by release type. - Enhanced the release categorization algorithm. Supports both standard categories and custom release type tags. - Added an option for a separate Compilations menu (with quick-access buttons), offering both LMS and MusicBrainz classification standards. ## Song Grouping and Subtitles - Enhanced the album songs grouping feature. Supports grouping by Work ID, GROUPING tag, and disc number. - The Now Playing screen now shows the work title, GROUPING info, or disc subtitle next to the album title. - Added display and navigation for work information in the Now Playing screen's song information tab. ## One-Tap Search - Added one-tap search for the local library and streaming services (supports Qobuz, Tidal, and Spotify). - Features automatic Simplified/Traditional Chinese conversion (when iOS is set to Chinese and the keyword is Chinese). - Also searches within local playlist titles. - Added local search history for quick repeats. - Redesigned interface: replaced tabs with a categorized list and detail pages. - Uses concurrent API calls for faster searches. - Added an advanced search settings page. ## Volume Buttons - Added support for using iOS hardware volume buttons to control player volume. - Configurable to adjust either system volume or xTune's internal player volume. - Shows an OSD when adjusting (with a percentage display option). - Added related settings in Advanced Settings. ## CarPlay - Added "Now Playing/Resume," "My Playlists," and "My Radios" to the CarPlay home screen. - Added a Favorites (Like) button to the CarPlay Now Playing screen. ## Other - Added Genre and Year to album detail pages, with click-to-navigate. - Added Year and Genre info/links to the album action dialog. - Added option to show release year in album lists (can be disabled in settings). - Added "Enable Half-Star Ratings" option in Advanced Settings. # Optimizations - Enhanced artist roles, adding "Performer" to the defaults. - Changed artist role display order to: Performer/Composer/Conductor. - The built-in player settings page now hides the Now Playing card if the player is not purchased. - Optimized components and layouts in several settings screens. # Bug Fixes - Fixed incorrect artist info in song lists caused by wrong song.artist data from LMS. - Fixed incorrect parsing of commas within artist names. - Artist detail page now uses cropped background images to prevent UI issues. - Fixed non-half-star ratings not working and updates not appearing promptly. - Resolved playback failures for some recordings (caused by using performanceId from song data). - Fixed playback control issues and empty Now Playing lists after Comet long-connection interruptions.

# New Features ## Built-in Player - Added Bit-Perfect mode support when connected to USB DAC - Added DoP output mode support via USB DAC - Added Loudness volume adjustment support when connected to USB DAC - Added PCM upsampling support when connected to USB DAC - Implemented advanced audio settings interface for built-in player ## Release Type Grouping - Added release type grouping support in album lists on Album, Artist, Year, and Genre pages - Added release type grouping support on Artist Detail page - Added Release Type Grouping option in Settings (Appearance → Albums) ## Other - Added third-party application support (with independent Third-Party Apps menu) - Extended support for more radio stations via SlimBrowse protocol - Added new player icons for various room types (living room, bedroom, kitchen, etc.) # Optimizations - Added streaming service icon display in recently added albums list - Moved Virtual Library feature option from Experimental Features to Features Settings - Optimized LMS Comet Connection subscription and cleanup logic for subscribed players - Optimized logo icons for some radio plugins - Optimized styling, layout, and information display in built-in player status dialog - Optimized built-in player decode buffer size (8M for non-mobile, limited to 64M for mobile) # Bug Fixes - Fixed issue where server connection could get stuck on connecting screen (easily triggered when changing server IP or switching servers) - Resolved issue where Alphabet Index UI didn't update promptly when data changed - Resolved issue where digital volume adjustment was incorrectly shown for non-PCM formats in audio output path dialog - Fixed missing 64-bit to 16/24-bit conversion information in audio output path dialog - Resolved issue where bitrate wasn't prioritized in radio station playback interface - Fixed incorrect Power field in player status - Resolved incorrect "Add to Queue" action in streaming service action dialog

# New Features - Added decoding support for FLAC audio in Ogg container format (for high-bitrate FLAC radio streams). - Added metadata parsing support for Ogg format streams. # Improvements - Optimized the built-in player's caching strategy to improve playback continuity when network stream fluctuations cause audio underruns. - Enhanced the radio playback interface to display the current stream's bitrate instead of the sample rate. # Bug Fixes - Fixed an issue where the built-in player could unexpectedly stop during AAC format radio playback. - Resolved a connection screen hang that occurred when the LMS server (with Ratings Light plugin installed) was on a different subnet from xTune. - Fixed playback history not updating when selecting and playing radio stations from history.

# New Features ## Enhanced Artist Information and User-Defined Roles (Configurable in "Appearance Settings") - Added "Custom Artist Roles" tab on artist pages - Added highlight feature for focus artist tracks in album and work views - Support for displaying artist role labels in song lists and now playing interface - Custom artist roles support in song action dialogs ## Player Group Volume Control and Volume Slider - Volume control via slider (can be enabled in "Advanced Settings") - Support for group volume control in player management page - Support for both group volume and individual player volume in player selection dialog (default behavior configurable in "Advanced Settings") ## Redesigned "My Radios" and Radio Playback - Completely redesigned "My Radios" page integrating favorite radios and radio browsing - Enhanced support for Radio Now Playing plugin with new radio search functionality - Improved Icy Meta format parsing capability for smoother internet radio playback - Replaced default radio tower icon with colorful radio icon ## Half-Star Rating Precision - Rating system now supports half-star precision for more granular rating experience # Optimizations and Improvements - Enhanced built-in player network reconnection mechanism - continues playing cached audio during network interruptions with automatic server reconnection upon network recovery - Improved USB DAC detection mechanism for built-in player, now supporting USB Audio and headphone outputs - Optimized built-in player settings page with new playback status card for easy monitoring of hardware output parameters like sample rate - Snackbar notification when long-pressing pause button to stop player - Refactored background Comet long connection for improved stability and real-time playback information synchronization - Optimized liquid glass circular button sizing for iOS 26 - Improved layout and visual styling across multiple pages # Bug Fixes - Fixed mini player bar layout issues on iPads with Home button - Resolved bottom layout overlap issue in vinyl playback theme on iPads with Home button - Fixed DSP display showing incorrect value (not "N/A") when built-in player stops playback

Bug Fixed - Fixed an issue where xTune's built-in player could not play FLAC/PCM/WAV files when using Daphile as the LMS server. - Fixed incorrect display of Audio Data and DSP information in the audio output path dialog. - Fixed abnormal display of Decode and DSP information in the built-in player status dialog.

New Features - Added a playback buffer that caches up to 2 songs when bandwidth optimization is active - Implemented grouped song list display for multi-disc albums on the album detail page - Added long-press gesture on pause button to stop playback Improvements - Optimized audio processing logic to reduce memory usage during decoding - Enhanced MP3 decoding compatibility for files with incomplete headers - Improved song list layout and spacing for better visual appearance - Refined search results page layout and bottom spacing for improved browsing experience Bug Fixes - Fixed abnormal playback interruption caused by insufficient MP3 decode buffer space - Resolved issue where AudioUnit could be closed multiple times, causing resource anomalies - Fixed search returning no results with specific iOS and LMS version combinations - Corrected missing artist avatars in search results - Fixed lock screen controls (play/pause/next/previous) not affecting built-in player - Resolved issue where favorited artists' avatars were not displayed on home screen and related pages

## New Features - Built-in player xPlay now supports AAC and OGG audio format decoding - Added activation status card in bandwidth optimization settings for real-time status monitoring - Implemented CarPlay connection detection and added CarPlay connectivity as an activation condition for bandwidth optimization ## Improvements - Refactored bandwidth optimization logic and improved settings page layout for better usability - Enhanced JSON matching and parsing algorithms for Comet connections to improve stability - Optimized Artflow Now Playing Theme for better visual consistency and interactive experience ## Bug Fixes - Fixed incorrect display of artist's first local image in MAI plugin - Resolved issue where Artwork view was incorrectly displayed in Folders view - Solved issue where embedded lyrics failed to display in certain scenarios

## New Features - Built-in player now supports Opus audio format (requires custom-convert.conf configuration) ## Improvements - Optimized MP3 decoder output buffer size for improved playback stability - Redesigned built-in player settings and bandwidth optimization interface (added advanced mode for bandwidth optimization) - Refined iPhone ArtFlow theme layout to prevent accidental taps - Expanded song info text width in iPhone mini player for better content display - Enhanced network transfer rate display in built-in player status dialog ## Bug Fixes - Fixed JSON parsing issues in Comet long connections (ensures real-time sync of playback progress and info) - Resolved missing album covers and artist images on password-protected server - Fixed authentication failure not returning unauthorized status, preventing redirect to login page

New Features - Added bandwidth optimization settings for built-in player, supporting sample rate limit and codec restrictions (Settings → Built-in Player) - Added player name display on full-screen now playing interface (configurable in Appearance settings, disabled by default) Improvements - Improved sorting in all player list pages with new alphabetical order - Enhanced error handling for image components by adding error logging in ArtworkImage, ArtistImage, and ImageCard - Optimized UI refresh mechanism to automatically update interface upon receiving server messages and player status changes Bug Fixes - Fixed issue where "Works" label still appeared when no works were available in Genre Detail interface - Fixed pull-to-refresh not updating the works list in Genre Detail interface - Resolved long-standing issue with incomplete response handling in Comet background connection (fixes playback state sync issues and missing player display)

New Features - Added experimental CarPlay support with interfaces for Albums, Artists, My Favorites, My Playlists, My Radios, and Now Playing Optimizations - Optimized data refresh logic in Now Playing, significantly reducing CPU usage (from ~30% down to ~10% in typical scenarios) - Improved backend Comet protocol implementation for better reconnection efficiency and connection stability - Optimized audio pause logic to automatically close audio output devices after 60 seconds of inactivity. - Restructured concurrent backend service requests to eliminate potential deadlock risks - Unified visual styles across multiple interfaces for improved design consistency Issue Resolutions​ - Fixed an issue where audio playback could not resume after pausing - Fixed an issue where playback information and lyrics failed to sync in real-time under certain scenarios. - Fixed an issue where system playback control buttons incorrectly operated the current player - Addressed multiple defects in the previous version's Artflow playback theme - Optimized text rendering to resolve display flickering issues on some device models

Features - Added a brand new full-screen player theme: Artflow (available on both iPhone and iPad). - Added theme switch and more options buttons at the bottom of the player screen on iPhone (to maintain a clean UI, these buttons are hidden by default—tap the empty area at the bottom to reveal them). - Introduced an additional settings popup in the full-screen player interface. Optimization - Made subtle refinements to the UI layout and color scheme. - Redesigned some button icons for a better visual experience. Bug Fixe - Fixed an issue where pages like album details and artist details would persistently display a loading indicator.

New Features - Added appearance style transparency level setting (default: Medium) - Added audio processing path dialog (accessible by clicking the sample rate icon below the progress bar in full-screen playback interface) - Added built-in player status dialog (switchable via the icon in the upper-right corner of the audio processing path dialog) Optimizations - Optimized audio initialization and output logic of the built-in player to improve playback stability - Improved MAI data processing flow to reduce server load and prevent playback interruptions or connection drops - Enhanced plugin API call mechanism to automatically skip calls when corresponding plugins are not installed - Improved data loading logic for album and artist detail pages to prevent data overwriting causing persistent loading states - Optimized album artwork display strategy: full-screen playback uses original images, other pages use 600x600 resolution - Enhanced server connection stability and added connection status logging for troubleshooting - Redesigned Ratings star icons for better visibility in dark mode - Refactored screen always-on feature code with additional runtime status logging - Various UI layout and styling refinements Bug Fixes - Fixed decoding issues in the underlying audio library that caused playback interruptions and failure to resume - Fixed a crash that could occur when entering Player Settings page on iOS 26

*New Features* ​MAI (Music Artist Information) Plugin Support​ - Integrated MAI data in the Now Playing screen to display artist information and album details - Added support for fetching and displaying artist photos via the MAI plugin - Added "Album Review" and "Album Covers" features to the Album Detail page - Added "Artist Biography" and "Artist Photos" features to the Artist Detail page ​ DSTM (Don't Stop The Music) Support​ - Long-press the Repeat button in the Now Playing screen to access DSTM settings - Added DSTM configuration options in Player Settings - When DSTM is enabled, tapping the Repeat button cycles through infinite play, single song repeat, and playlist repeat modes ​ Ratings Light Support​ - Added star-based rating functionality for currently playing songs in the Now Playing screen - Added bulk rating option for all songs in an album through the Album Actions dialog - Added individual song rating option in the Song Actions dialog - New "Tracks Appearance" setting to show ratings in song lists ​ Other Additions​ - Added "Alarm" settings option in Player Settings - Built-in player now supports Replay Gain functionality *Improvements* - Improved data refresh process when switching servers or libraries - Enhanced artist photo loading and caching with better MAI plugin compatibility - Optimized caching mechanism for music library pages - Added pull-to-refresh functionality on the Home screen to clear and reload all cached data - Redesigned global shortcut buttons on iPhone for better visual appearance and usability *Bug Fixes* - Fixed data synchronization issues in the Song Actions dialog - Fixed navigation error when accessing Artist Biography from the Artist Actions dialog - Fixed layout issues in the global navigation menu caused by long virtual library names - Album and track counters are now automatically hidden in the global menu when using Virtual Library to prevent incorrect statistics *Other Changes* - Removed the option to use album artwork as artist photos to reduce app complexity and improve data accuracy

New Features - Added virtual music library support for more flexible music management - Added useVolumeControl volume control switch field to enhance Denon/Marantz AVR plugin support - Added album appearance settings dialog and sorting functionality on album/artist/genre/year pages for better browsing experience - Added track duration display in track lists, controllable through advanced options - Added automatic player icon detection and modification functionality for personalized customization - Added ReplayGainMode volume gain setting option in player settings Optimizations - Refactored core audio library to optimize built-in player's stability when switching between different output devices - Reconstructed sample rate switching logic to improve built-in player audio stability when plugging/unplugging USB DAC - Optimized player list interface display to support scrolling through large numbers of players - Improved interface details and text translations for better user experience Bug Fixes - Fixed issue where external USB DAC could not automatically modify sample rates - Resolved incorrect playback status display after completing all songs - Fixed abnormal appearance settings page display when returning from iPhone settings page - Solved issue where favorited Works and Recordings couldn't be clicked to view details on home page cards

xTune 2.0 is now officially released. This version brings ​wide-ranging​ improvements to music streaming browsing and playback, along with a major new feature designed for classical music lovers: "Works". With this feature, you can explore classical music ​in a structured way—moving from​ composer, to work, to different recordings by various orchestras or artists. The home page also introduces new cards recommending works and recordings, while playback history and search now integrate classical works content. Here’s what’s new in this version: ​New Features:​​ - All-new classical "Works" browsing and playback - Improved streaming plugin support, now including: Spotify, Tidal, Qobuz, BBC Sounds, and Podcasts - One-touch transfer of the current playback queue to different devices - Manual lyric timing adjustment to better sync lyrics with playback ​ Improvements:​​ - Redesigned playlist loading and display for smoother operation ​ Bug Fixes:​​ - Fixed an issue where tapping playback history wouldn’t navigate correctly - Fixed missing management icons in playlist details on iOS 16 - Corrected parameter errors in the "Play from current track’s directory" feature (which previously played the entire directory) - Fixed display issues in the player management screen when no player was available

New Features: - Added more operation options for songs in the Now Playing list (previously only supported removal) - Added support for creating new playlists directly when adding songs to playlists - Added precise volume adjustment with 1%-10% granularity - Album view now supports displaying individual covers for different songs Bug Fixes: - Fixed issue where local playback history became unclickable after rebuilding media database - Fixed incorrect display of album covers instead of song covers in playlists Optimizations: - Improved dynamic lyrics synchronization to resolve timing misalignment issues

New Features:​​ - Added new Classic playback theme - Added "Keep Screen On" option during playback (enable in Settings) - Bluetooth audio switching support with song metadata display ​ Improvements:​​ - Enhanced vinyl theme with better lighting, layout proportions, and animations ​ Bug Fixes:​​ - None

New Features​:​​ - Brand new vinyl record player theme for your music playback screen (works on both iPhone and iPad) - Now you can expand/collapse the A-Z index sidebar in album and artist lists for easier navigation ​Improvements​:​​ - Improved language translations and formatting - Redesigned genre pages to better showcase albums, artists and songs - Enhanced year pages with better organized album and song lists - Smoother scrolling and animations in lists with A-Z index - Faster loading of artist photos with less lag - Better display of streaming music artwork (even for extra-wide covers) ​ Problems Fixed:​​ - Fixed spacing issues with the A-Z index in folder lists - Improved how artist photos get updated in the system

New Features​ - Added ​Artist Bio​ and ​Artist Photos​ support - Introduced ​A-Z Index​ in album lists for faster navigation - Now shows ​Streaming Source​ in ​Album List, Album Details, and Now Playing​ ​Improvements​ - Optimized data loading for ​Music Discovery​ page, improving performance - Enhanced layout in ​Album/Artist Pages​ for better visual consistency - Improved ​iPad Settings UI​ and back button behavior for better tablet experience ​ Bug Fixes​ - Fixed incorrect Album ​Artist​ display in some cases

New Features​ - Added "Discover Music" recommendation cards on homepage - New pull-to-zoom animation for artwork in album/artist pages ​ Improvements​ - Redesigned corner radius for more consistent modern look - Enhanced background image display in detail pages ​Bug Fixes​ - Fixed incorrect artist info when saving favorites - Resolved unresponsive artist buttons in playlist details - Fixed missing cover art/titles in radio playback - Improved folder content loading reliability

​Redesigned iPad UI​ – Fully optimized for iPad, delivering a seamless and adaptive user experience. ​Improved LMS Server Connectivity​ – Enhanced background communication with the LMS server for faster and more reliable performance. ​General Optimizations & Bug Fixes​ – Minor improvements and stability enhancements across the application.