Music - Releases

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Hotfix

• Background cleanup job not working with PostgreSQL (since v2.1.0) #1191

Added in v2.1.0

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed in v2.1.0

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed in v2.1.0

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• French translation #1157 @flozz
• Support for Nextcloud 30

Changed

• Subsonic API: For radio stations without user-supplied name, use the stream URL as a name

Fixed

• Favorite toggle button not working on artists with no image available
• Cover art image not used automatically upon the image file upload in some cases when PostgreSQL used #1164

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Hotfix

• Background cleanup job not working with PostgreSQL (since v2.1.0) #1191

Added in v2.1.0

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed in v2.1.0

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed in v2.1.0

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• French translation #1157 @flozz
• Support for Nextcloud 30

Changed

• Subsonic API: For radio stations without user-supplied name, use the stream URL as a name

Fixed

• Favorite toggle button not working on artists with no image available
• Cover art image not used automatically upon the image file upload in some cases when PostgreSQL used #1164

Added

• Additional tabs "Albums" and "Tracks" to the artist details pane
• Additional tabs "Tracks" and "Artists" to the album details pane
• Favorite toggle to the details pane of the tracks, albums, artists, playlists, and podcasts
• New filter "Favorite" for the smart list
• OpenSubsonic extensions to the Subsonic API:
• Method getLyricsBySongId
• Property sortName to all artist, album, and song responses
• Property played to all song responses

Changed

• Drop support for PHP versions older 7.4 (i.e. PHP 7.1 - 7.3)
• Drop support for ownCloud versions older than 10.5 (i.e. OC 10.0 - 10.4)
• Drop support for Nextcloud versions older than 20 (i.e. NC 13 - 19)
• New design including cover art on all list-like views
• Ampache and Subsonic APIs: Check the username in case-insensitive manner #1147
• Ampache API:
• The action download doesn't implicitly record the track as played (unlike stream)
• The song property url refers to the stream URL instead of download URL

Fixed

• Playlist sorting not working if the list contains any broken track references
• Nextcloud.log being flooded with the debug-level message "/appinfo/app.php is deprecated" on NC20+ #1043

Added

• Advanced search view #1141
• Support for Nextcloud 29 #1132
• Ampache API:
• Option to change the session timeout with the config.php key music.ampache_session_expiry_time #1134
• Support for the actions search, user, user_playlists, user_smartlists, playlist_add, index, scrobble
• Support for the advanced search rule bitrate on songs
• Subsonic API:
• Support for the method getOpenSubsonicExtensions

Changed

• Ampache API:
• Advanced search operators matches regex and does not match regex supported also on SQLite (this is important to properly support Ample)
• Advanced search operators sounds like and does not sound like supported also on SQLite, and on PgSQL if module fuzzystrmatch is installed
• Advanced search rules album_genre and artist_genre supported also on PgSQL
• Authentication tag can be delivered also using the bearer token header (required to support Ample v3) #1140
• All results with property art have also the property has_art
• Implicitly record the track as played with the actions download and stream

Fixed

• Playlist file not playing within Files in case the first track of the list is in unsupported format
• Some Finnish translations being replaced with English (since v1.9.0)
• Error "Cannot set response code - headers already sent" logged on each played song on PHP 8.3 #1133
• Files player: Menu icon for "Import list to Music" not adjusted correctly for the dark theme
• Standard NC viewer opened instead of embedded Music player when opening file from Dashboard on NC28+ #1126
• Music app page loading randomly failing on Chrome #1137
• Ampache API:
• API not working on ownCloud 10.14.0 (HTTP error 500 on all Ampache API calls) #1138
• Advanced search rule playlist_name not being case insensitive like the other string rules
• Advanced search rules playlist and playlist_name not working with SQLite
• Advanced search operator does not sound like not working
• Advanced search numeric rules (e.g. year, played_times, album_count) not working properly on SQLite
• Advanced search rules album_count and song_count never finding artists whose respective count is 0
• Incorrect root node name on the actions user_preference and user_preferences
• Subsonic API:
• Method getAlbumInfo2 response having incorrect root element name #1125 @perillamint
• On NC28+, every XML API call logged an error 'Undefined array key "" at /var/www/html/lib/private/AppFramework/Http.php#128'. #1142

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Hotfix

• Background cleanup job not working with PostgreSQL (since v2.1.0) #1191

Added in v2.1.0

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed in v2.1.0

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed in v2.1.0

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• French translation #1157 @flozz
• Support for Nextcloud 30

Changed

• Subsonic API: For radio stations without user-supplied name, use the stream URL as a name

Fixed

• Favorite toggle button not working on artists with no image available
• Cover art image not used automatically upon the image file upload in some cases when PostgreSQL used #1164

Added

• Additional tabs "Albums" and "Tracks" to the artist details pane
• Additional tabs "Tracks" and "Artists" to the album details pane
• Favorite toggle to the details pane of the tracks, albums, artists, playlists, and podcasts
• New filter "Favorite" for the smart list
• OpenSubsonic extensions to the Subsonic API:
• Method getLyricsBySongId
• Property sortName to all artist, album, and song responses
• Property played to all song responses

Changed

• Drop support for PHP versions older 7.4 (i.e. PHP 7.1 - 7.3)
• Drop support for ownCloud versions older than 10.5 (i.e. OC 10.0 - 10.4)
• Drop support for Nextcloud versions older than 20 (i.e. NC 13 - 19)
• New design including cover art on all list-like views
• Ampache and Subsonic APIs: Check the username in case-insensitive manner #1147
• Ampache API:
• The action download doesn't implicitly record the track as played (unlike stream)
• The song property url refers to the stream URL instead of download URL

Fixed

• Playlist sorting not working if the list contains any broken track references
• Nextcloud.log being flooded with the debug-level message "/appinfo/app.php is deprecated" on NC20+ #1043

Added

• Advanced search view #1141
• Support for Nextcloud 29 #1132
• Ampache API:
• Option to change the session timeout with the config.php key music.ampache_session_expiry_time #1134
• Support for the actions search, user, user_playlists, user_smartlists, playlist_add, index, scrobble
• Support for the advanced search rule bitrate on songs
• Subsonic API:
• Support for the method getOpenSubsonicExtensions

Changed

• Ampache API:
• Advanced search operators matches regex and does not match regex supported also on SQLite (this is important to properly support Ample)
• Advanced search operators sounds like and does not sound like supported also on SQLite, and on PgSQL if module fuzzystrmatch is installed
• Advanced search rules album_genre and artist_genre supported also on PgSQL
• Authentication tag can be delivered also using the bearer token header (required to support Ample v3) #1140
• All results with property art have also the property has_art
• Implicitly record the track as played with the actions download and stream

Fixed

• Playlist file not playing within Files in case the first track of the list is in unsupported format
• Some Finnish translations being replaced with English (since v1.9.0)
• Error "Cannot set response code - headers already sent" logged on each played song on PHP 8.3 #1133
• Files player: Menu icon for "Import list to Music" not adjusted correctly for the dark theme
• Standard NC viewer opened instead of embedded Music player when opening file from Dashboard on NC28+ #1126
• Music app page loading randomly failing on Chrome #1137
• Ampache API:
• API not working on ownCloud 10.14.0 (HTTP error 500 on all Ampache API calls) #1138
• Advanced search rule playlist_name not being case insensitive like the other string rules
• Advanced search rules playlist and playlist_name not working with SQLite
• Advanced search operator does not sound like not working
• Advanced search numeric rules (e.g. year, played_times, album_count) not working properly on SQLite
• Advanced search rules album_count and song_count never finding artists whose respective count is 0
• Incorrect root node name on the actions user_preference and user_preferences
• Subsonic API:
• Method getAlbumInfo2 response having incorrect root element name #1125 @perillamint
• On NC28+, every XML API call logged an error 'Undefined array key "" at /var/www/html/lib/private/AppFramework/Http.php#128'. #1142

Added

• Support for Nextcloud 28 #1116
• Support for PHP 8.3
• Ampache API:
• Support for argument random in the method playlist_songs
• Method bookmark
• Support for argument include in all methods returning bookmarks
• Subsonic API:
• Property playCount to song responses
• OpenSubsonic API extensions:
  • Properties openSubsonic, type, and serverVersion to all responses
  • Allow getting the whole library with an empty query argument in search3 method
• MusicBrainz link from Last.fm to the artist/album/track details pane, when available
• Filters "Recently added" and "Not recently added" for the smart playlist #1098
• Optional "strict" mode for the history filters of the smart playlist #1099
• Hint about the keyboard shortcuts in the Settings view and in tooltips #1086

Changed

• Ampache API:
• Make advanced_search arguments operator and type optional
• On method bookmark_create, the argument client defaults to null instead of "AmpacheAPI"
• Subsonic API: Methods search2 and search3 support '*' as a wildcard
• Consider also the tag names unsynced_lyrics and unsyncedlyrics when parsing lyrics #1111 @RobertZenz
• Updated the getID3 library to the development version 1.9.23-202312292105
• Fixes the issue of garbage bytes being extracted from some RIFF tags #1115
• Search within the Music app now works with an own input field in the navigation pane instead of the unified search input

Fixed

• Songs with scanned integer property value (like track number) larger than 2147483647 causing error on PostgreSQL #1106
• Lite player in Files attempting to play also audio files with MIME types unsupported on the current browser
• Subsonic API: Use integer-type IDs in getMusicFolders to comply with the API specification #1108
• Playlist details showing length as "NaN:NaN" in case the playlist contains any invalid track references

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Hotfix

• Background cleanup job not working with PostgreSQL (since v2.1.0) #1191

Added in v2.1.0

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed in v2.1.0

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed in v2.1.0

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• French translation #1157 @flozz
• Support for Nextcloud 30

Changed

• Subsonic API: For radio stations without user-supplied name, use the stream URL as a name

Fixed

• Favorite toggle button not working on artists with no image available
• Cover art image not used automatically upon the image file upload in some cases when PostgreSQL used #1164

Added

• Additional tabs "Albums" and "Tracks" to the artist details pane
• Additional tabs "Tracks" and "Artists" to the album details pane
• Favorite toggle to the details pane of the tracks, albums, artists, playlists, and podcasts
• New filter "Favorite" for the smart list
• OpenSubsonic extensions to the Subsonic API:
• Method getLyricsBySongId
• Property sortName to all artist, album, and song responses
• Property played to all song responses

Changed

• Drop support for PHP versions older 7.4 (i.e. PHP 7.1 - 7.3)
• Drop support for ownCloud versions older than 10.5 (i.e. OC 10.0 - 10.4)
• Drop support for Nextcloud versions older than 20 (i.e. NC 13 - 19)
• New design including cover art on all list-like views
• Ampache and Subsonic APIs: Check the username in case-insensitive manner #1147
• Ampache API:
• The action download doesn't implicitly record the track as played (unlike stream)
• The song property url refers to the stream URL instead of download URL

Fixed

• Playlist sorting not working if the list contains any broken track references
• Nextcloud.log being flooded with the debug-level message "/appinfo/app.php is deprecated" on NC20+ #1043

Added

• Advanced search view #1141
• Support for Nextcloud 29 #1132
• Ampache API:
• Option to change the session timeout with the config.php key music.ampache_session_expiry_time #1134
• Support for the actions search, user, user_playlists, user_smartlists, playlist_add, index, scrobble
• Support for the advanced search rule bitrate on songs
• Subsonic API:
• Support for the method getOpenSubsonicExtensions

Changed

• Ampache API:
• Advanced search operators matches regex and does not match regex supported also on SQLite (this is important to properly support Ample)
• Advanced search operators sounds like and does not sound like supported also on SQLite, and on PgSQL if module fuzzystrmatch is installed
• Advanced search rules album_genre and artist_genre supported also on PgSQL
• Authentication tag can be delivered also using the bearer token header (required to support Ample v3) #1140
• All results with property art have also the property has_art
• Implicitly record the track as played with the actions download and stream

Fixed

• Playlist file not playing within Files in case the first track of the list is in unsupported format
• Some Finnish translations being replaced with English (since v1.9.0)
• Error "Cannot set response code - headers already sent" logged on each played song on PHP 8.3 #1133
• Files player: Menu icon for "Import list to Music" not adjusted correctly for the dark theme
• Standard NC viewer opened instead of embedded Music player when opening file from Dashboard on NC28+ #1126
• Music app page loading randomly failing on Chrome #1137
• Ampache API:
• API not working on ownCloud 10.14.0 (HTTP error 500 on all Ampache API calls) #1138
• Advanced search rule playlist_name not being case insensitive like the other string rules
• Advanced search rules playlist and playlist_name not working with SQLite
• Advanced search operator does not sound like not working
• Advanced search numeric rules (e.g. year, played_times, album_count) not working properly on SQLite
• Advanced search rules album_count and song_count never finding artists whose respective count is 0
• Incorrect root node name on the actions user_preference and user_preferences
• Subsonic API:
• Method getAlbumInfo2 response having incorrect root element name #1125 @perillamint
• On NC28+, every XML API call logged an error 'Undefined array key "" at /var/www/html/lib/private/AppFramework/Http.php#128'. #1142

Added

• Support for Nextcloud 28 #1116
• Support for PHP 8.3
• Ampache API:
• Support for argument random in the method playlist_songs
• Method bookmark
• Support for argument include in all methods returning bookmarks
• Subsonic API:
• Property playCount to song responses
• OpenSubsonic API extensions:
  • Properties openSubsonic, type, and serverVersion to all responses
  • Allow getting the whole library with an empty query argument in search3 method
• MusicBrainz link from Last.fm to the artist/album/track details pane, when available
• Filters "Recently added" and "Not recently added" for the smart playlist #1098
• Optional "strict" mode for the history filters of the smart playlist #1099
• Hint about the keyboard shortcuts in the Settings view and in tooltips #1086

Changed

• Ampache API:
• Make advanced_search arguments operator and type optional
• On method bookmark_create, the argument client defaults to null instead of "AmpacheAPI"
• Subsonic API: Methods search2 and search3 support '*' as a wildcard
• Consider also the tag names unsynced_lyrics and unsyncedlyrics when parsing lyrics #1111 @RobertZenz
• Updated the getID3 library to the development version 1.9.23-202312292105
• Fixes the issue of garbage bytes being extracted from some RIFF tags #1115
• Search within the Music app now works with an own input field in the navigation pane instead of the unified search input

Fixed

• Songs with scanned integer property value (like track number) larger than 2147483647 causing error on PostgreSQL #1106
• Lite player in Files attempting to play also audio files with MIME types unsupported on the current browser
• Subsonic API: Use integer-type IDs in getMusicFolders to comply with the API specification #1108
• Playlist details showing length as "NaN:NaN" in case the playlist contains any invalid track references

Version 1.9.0 had an app update problem on some versions of Nextcloud with SQLite. This version works around that issue but is othwerise identical with v1.9.0.

Added

• Smart playlist feature, allowing list creation by user-supplied criteria #619 #1061 @rstefko
• Dragging tracks/albums/etc on the "+ New Playlist" item creates a new playlist containing those items
• Files playlist tab: Tooltip showing the file path or stream URL
• Subsonic API:
• Rating support: method setRating, rating properties in all applicable result entities, type highest to the method getAlbumList
• Empty implementation for the method getNowPlaying #1079 @NattyNarwhal
• Ampache API: #1078
• New methods:
  • rate
  • get_similar
  • genres, genre, genre_artists, genre_albums, genre_songs
  • bookmarks, get_bookmark, bookmark_create, bookmark_edit, bookmark_delete
  • live_streams, live_stream, live_stream_create, live_stream_edit, live_stream_delete
  • list
  • browse
  • user_preference and user_preferences with mock-up content
  • advanced_search with partial support, not all search rules supported and some operators work only with MySQL/MariaDB
• Support for the type album_artist in the method get_indexes
• Support for the parameter album_artist in the method artists
• Support for the type playlist in the method stats
• Support for the type playlist in the methods download and stream
• Support for the type playlist in the method flag
• Support for the parameter top50 in the method artist_songs
• Support for the filter highest in the method stats
• Support for the parameter include in the methods album, albums, artist, and artists
• Fields time, albumcount, songcount, prefix, and basename to the artist type results
• Fields time, diskcount, songcount, prefix, and basename to the album type results
• Fields disk, format, stream_format, stream_bitrate, stream_mime, and playlisttrack to song type results
• Fields time, size, bitrate, stream_bitrate, rating, and preciserating to podcast_episode type results
• Fields rating and preciserating to podcast type results
• Fields flag, rating and preciserating to playlist type results
• Null-valued fields language, lyrics, mode, rate, replaygain_album_gain, replaygain_album_peak, replaygain_track_gain, replaygain_track_peak, r128_album_gain, and r128_track_gain to song type results
• In JSON-mode only, field artists to song and album type results
• All the fields of handshake response on the response of ping within a valid session

Changed

• Ampache API: #1078 #909
• Follow the APIv5 conventions if version 5.x.x requested by the client on handshake
• Follow the APIv6 conventions if version 6.0.0 or higher requested by the client on handshake
• Follow the APIv6 conventions if the client doesn't specify any version
  • this may be overridden using the config.php key music.ampache_api_default_ver
• The URLs returned in the art tag of the entities are now cache-friendly, i.e. don't depend on the session
• Terminate all related sessions immediately when API key deleted; previously, this happened upon session timeout
• Fields rating and preciserating now show the user-given rating instead of constant 0 on all applicable result objects
• Own UI settings storage for each OC/NC instance running on the same server (same HTTP origin). Previously, all instances of the origin shared the settings.
• As a side-effect, any UI settings (like volume, view modes) from the previous version get discarded upon the SW update
• Also, volume settings in the Share and Files embedded players are now distinct from the volume in the main app
• Small optimization on the size of the collection.json loaded by the web front-end
• Order the playlists by name in the navigation pane, navigate automatically to the created or renamed playlist #1083
• Any invalid playlist entries are now visible on the web UI to enable easy removal #1087

Fixed

• Subsonic API:
• Unhandled exception when attempting to delete a non-existent bookmark #1071
• Method getPlaylist failing if the playlist contains any invalid track references (since v1.8.0) #1087
• Scanning breaking if any out-of-bounds numeric value gets scanned from any audio file #1073
• File and folder selection dialogs not working on NC 27.1.0 and 27.1.1 (workaround for a NC bug which should get fixed in NC 27.1.2) #1091
• Application update not working on some versions of Nextcloud with SQLite (introduced in v1.9.0)

Added

• Support for Nextcloud 27 (tested on RC3)

Changed

• Allow UTF-8 encoding also on playlists with the extension .m3u (in addition to .m3u8)
• The file is interpreted as ISO-8859-1 only if not valid UTF-8 or if so specified by the #EXTENC tag #1047

Fixed

• Folder icons not being theme-colored on Nextcloud 25+
• Navigation pane divider lines being invisible with some themes on Nextcloud 25+
• Subsonic: Incorrect interpretation of the optional time argument on the scrobble method #1066
• "Show in Files" link in the track details popping up an empty player bar on Nextcloud (at least on NC23-27)

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Hotfix

• Background cleanup job not working with PostgreSQL (since v2.1.0) #1191

Added in v2.1.0

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed in v2.1.0

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed in v2.1.0

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• French translation #1157 @flozz
• Support for Nextcloud 30

Changed

• Subsonic API: For radio stations without user-supplied name, use the stream URL as a name

Fixed

• Favorite toggle button not working on artists with no image available
• Cover art image not used automatically upon the image file upload in some cases when PostgreSQL used #1164

Added

• Additional tabs "Albums" and "Tracks" to the artist details pane
• Additional tabs "Tracks" and "Artists" to the album details pane
• Favorite toggle to the details pane of the tracks, albums, artists, playlists, and podcasts
• New filter "Favorite" for the smart list
• OpenSubsonic extensions to the Subsonic API:
• Method getLyricsBySongId
• Property sortName to all artist, album, and song responses
• Property played to all song responses

Changed

• Drop support for PHP versions older 7.4 (i.e. PHP 7.1 - 7.3)
• Drop support for ownCloud versions older than 10.5 (i.e. OC 10.0 - 10.4)
• Drop support for Nextcloud versions older than 20 (i.e. NC 13 - 19)
• New design including cover art on all list-like views
• Ampache and Subsonic APIs: Check the username in case-insensitive manner #1147
• Ampache API:
• The action download doesn't implicitly record the track as played (unlike stream)
• The song property url refers to the stream URL instead of download URL

Fixed

• Playlist sorting not working if the list contains any broken track references
• Nextcloud.log being flooded with the debug-level message "/appinfo/app.php is deprecated" on NC20+ #1043

Added

• Advanced search view #1141
• Support for Nextcloud 29 #1132
• Ampache API:
• Option to change the session timeout with the config.php key music.ampache_session_expiry_time #1134
• Support for the actions search, user, user_playlists, user_smartlists, playlist_add, index, scrobble
• Support for the advanced search rule bitrate on songs
• Subsonic API:
• Support for the method getOpenSubsonicExtensions

Changed

• Ampache API:
• Advanced search operators matches regex and does not match regex supported also on SQLite (this is important to properly support Ample)
• Advanced search operators sounds like and does not sound like supported also on SQLite, and on PgSQL if module fuzzystrmatch is installed
• Advanced search rules album_genre and artist_genre supported also on PgSQL
• Authentication tag can be delivered also using the bearer token header (required to support Ample v3) #1140
• All results with property art have also the property has_art
• Implicitly record the track as played with the actions download and stream

Fixed

• Playlist file not playing within Files in case the first track of the list is in unsupported format
• Some Finnish translations being replaced with English (since v1.9.0)
• Error "Cannot set response code - headers already sent" logged on each played song on PHP 8.3 #1133
• Files player: Menu icon for "Import list to Music" not adjusted correctly for the dark theme
• Standard NC viewer opened instead of embedded Music player when opening file from Dashboard on NC28+ #1126
• Music app page loading randomly failing on Chrome #1137
• Ampache API:
• API not working on ownCloud 10.14.0 (HTTP error 500 on all Ampache API calls) #1138
• Advanced search rule playlist_name not being case insensitive like the other string rules
• Advanced search rules playlist and playlist_name not working with SQLite
• Advanced search operator does not sound like not working
• Advanced search numeric rules (e.g. year, played_times, album_count) not working properly on SQLite
• Advanced search rules album_count and song_count never finding artists whose respective count is 0
• Incorrect root node name on the actions user_preference and user_preferences
• Subsonic API:
• Method getAlbumInfo2 response having incorrect root element name #1125 @perillamint
• On NC28+, every XML API call logged an error 'Undefined array key "" at /var/www/html/lib/private/AppFramework/Http.php#128'. #1142

Added

• Support for Nextcloud 28 #1116
• Support for PHP 8.3
• Ampache API:
• Support for argument random in the method playlist_songs
• Method bookmark
• Support for argument include in all methods returning bookmarks
• Subsonic API:
• Property playCount to song responses
• OpenSubsonic API extensions:
  • Properties openSubsonic, type, and serverVersion to all responses
  • Allow getting the whole library with an empty query argument in search3 method
• MusicBrainz link from Last.fm to the artist/album/track details pane, when available
• Filters "Recently added" and "Not recently added" for the smart playlist #1098
• Optional "strict" mode for the history filters of the smart playlist #1099
• Hint about the keyboard shortcuts in the Settings view and in tooltips #1086

Changed

• Ampache API:
• Make advanced_search arguments operator and type optional
• On method bookmark_create, the argument client defaults to null instead of "AmpacheAPI"
• Subsonic API: Methods search2 and search3 support '*' as a wildcard
• Consider also the tag names unsynced_lyrics and unsyncedlyrics when parsing lyrics #1111 @RobertZenz
• Updated the getID3 library to the development version 1.9.23-202312292105
• Fixes the issue of garbage bytes being extracted from some RIFF tags #1115
• Search within the Music app now works with an own input field in the navigation pane instead of the unified search input

Fixed

• Songs with scanned integer property value (like track number) larger than 2147483647 causing error on PostgreSQL #1106
• Lite player in Files attempting to play also audio files with MIME types unsupported on the current browser
• Subsonic API: Use integer-type IDs in getMusicFolders to comply with the API specification #1108
• Playlist details showing length as "NaN:NaN" in case the playlist contains any invalid track references

Version 1.9.0 had an app update problem on some versions of Nextcloud with SQLite. This version works around that issue but is othwerise identical with v1.9.0.

Added

• Smart playlist feature, allowing list creation by user-supplied criteria #619 #1061 @rstefko
• Dragging tracks/albums/etc on the "+ New Playlist" item creates a new playlist containing those items
• Files playlist tab: Tooltip showing the file path or stream URL
• Subsonic API:
• Rating support: method setRating, rating properties in all applicable result entities, type highest to the method getAlbumList
• Empty implementation for the method getNowPlaying #1079 @NattyNarwhal
• Ampache API: #1078
• New methods:
  • rate
  • get_similar
  • genres, genre, genre_artists, genre_albums, genre_songs
  • bookmarks, get_bookmark, bookmark_create, bookmark_edit, bookmark_delete
  • live_streams, live_stream, live_stream_create, live_stream_edit, live_stream_delete
  • list
  • browse
  • user_preference and user_preferences with mock-up content
  • advanced_search with partial support, not all search rules supported and some operators work only with MySQL/MariaDB
• Support for the type album_artist in the method get_indexes
• Support for the parameter album_artist in the method artists
• Support for the type playlist in the method stats
• Support for the type playlist in the methods download and stream
• Support for the type playlist in the method flag
• Support for the parameter top50 in the method artist_songs
• Support for the filter highest in the method stats
• Support for the parameter include in the methods album, albums, artist, and artists
• Fields time, albumcount, songcount, prefix, and basename to the artist type results
• Fields time, diskcount, songcount, prefix, and basename to the album type results
• Fields disk, format, stream_format, stream_bitrate, stream_mime, and playlisttrack to song type results
• Fields time, size, bitrate, stream_bitrate, rating, and preciserating to podcast_episode type results
• Fields rating and preciserating to podcast type results
• Fields flag, rating and preciserating to playlist type results
• Null-valued fields language, lyrics, mode, rate, replaygain_album_gain, replaygain_album_peak, replaygain_track_gain, replaygain_track_peak, r128_album_gain, and r128_track_gain to song type results
• In JSON-mode only, field artists to song and album type results
• All the fields of handshake response on the response of ping within a valid session

Changed

• Ampache API: #1078 #909
• Follow the APIv5 conventions if version 5.x.x requested by the client on handshake
• Follow the APIv6 conventions if version 6.0.0 or higher requested by the client on handshake
• Follow the APIv6 conventions if the client doesn't specify any version
  • this may be overridden using the config.php key music.ampache_api_default_ver
• The URLs returned in the art tag of the entities are now cache-friendly, i.e. don't depend on the session
• Terminate all related sessions immediately when API key deleted; previously, this happened upon session timeout
• Fields rating and preciserating now show the user-given rating instead of constant 0 on all applicable result objects
• Own UI settings storage for each OC/NC instance running on the same server (same HTTP origin). Previously, all instances of the origin shared the settings.
• As a side-effect, any UI settings (like volume, view modes) from the previous version get discarded upon the SW update
• Also, volume settings in the Share and Files embedded players are now distinct from the volume in the main app
• Small optimization on the size of the collection.json loaded by the web front-end
• Order the playlists by name in the navigation pane, navigate automatically to the created or renamed playlist #1083
• Any invalid playlist entries are now visible on the web UI to enable easy removal #1087

Fixed

• Subsonic API:
• Unhandled exception when attempting to delete a non-existent bookmark #1071
• Method getPlaylist failing if the playlist contains any invalid track references (since v1.8.0) #1087
• Scanning breaking if any out-of-bounds numeric value gets scanned from any audio file #1073
• File and folder selection dialogs not working on NC 27.1.0 and 27.1.1 (workaround for a NC bug which should get fixed in NC 27.1.2) #1091
• Application update not working on some versions of Nextcloud with SQLite (introduced in v1.9.0)

Added

• Support for Nextcloud 27 (tested on RC3)

Changed

• Allow UTF-8 encoding also on playlists with the extension .m3u (in addition to .m3u8)
• The file is interpreted as ISO-8859-1 only if not valid UTF-8 or if so specified by the #EXTENC tag #1047

Fixed

• Folder icons not being theme-colored on Nextcloud 25+
• Navigation pane divider lines being invisible with some themes on Nextcloud 25+
• Subsonic: Incorrect interpretation of the optional time argument on the scrobble method #1066
• "Show in Files" link in the track details popping up an empty player bar on Nextcloud (at least on NC23-27)

Fixed

• On ownCloud, flooding the log with errors "Cannot declare class because the name is already in use" (since v1.8.2) #1060 @prsnbrg
• Nextcloud 25 and later not running the Music background tasks: podcast channel updates, database cleanup #1044
• M4A-ALAC files sometimes starting to play simultaneously while the previous file is still playing

Added

• Support for Nextcloud 26 #1055 @blizzz
• Support for PHP 8.2 #1056

Changed

• Respect the "Ignored articles" setting also when sorting a playlist by artist #1048
• In addition to 'http' and 'https', allow podcast streams from the URL schemes 'feed', 'podcast', 'pcast', 'podcasts', 'itms-pcast', 'itms-pcasts', 'itms-podcast', and 'itms-podcasts' 153901

Fixed

• Subsonic: getAlbumList with type=alphabeticalByArtist not working on PostgreSQL #1046

Changed

• Advanced search: Enable searching albums by disk count
• Ampache API:
• Use HTML line breaks <br /> in the lyrics to match genuine Ampache behavior
• Add cache headers to the cover art responses
• Advanced search supports new rule disk_count for type album
• Subsonic API:
• Add cache headers to the cover art responses #1205
• Add OpenSubsonic extension method getPodcastEpisode
• Shiva API:
• Added endpoints /api/random/artist, /api/random/album, /api/random/track #51
• Added endpoint /api/tracks/{id}/lyrics #48
• Added endpoint /api/whatsnew
• The playlists API is now mostly compatible with the Shiva specification
• Systematically use plurals in endpoint names to match the specification: api/artists/{id} instead of api/artist/{id} etc.
• Proprietary REST API:
• Systematically use plurals in endpoint names for consistency

Fixed

• Unhandled error logged on corrupted/incompatible album cover images (now a warning is logged instead) #1204
• Unable to play some podcasts in the default relayed mode #1209
• Dashboard widget: Internet radio station without given name failing to load album art and showing the load indicator indefinitely
• Errors like 'Undefined array key "status_code"' logged when playing certain internet radio stations
• Ampache API: Endpoint song failing with code 500 when the song has no lyrics set (since v2.1.2) #1208
• Subsonic API:
• Property artistImageUrl being invalid on artist when authenticated using apiKey
• Method getPlaylist failing with code 500 if the playlist has any invalid song references #1128

Added

• Support for Nextcloud 31 #1198
• Support for PHP 8.4

Changed

• Denser layout for the navigation pane and actions menu on NC 30+, matching the platform style
• Ampache API: Parse and include lyrics in the response of the action song (but not on any other actions returning songs)

Fixed

• Dashboard widget:
• Playback controls disappearing when the playing track changes with Aurora.js backend (used when the audio format has no native browser support)
• Clicking the previously played song didn't play it again after stopping the playback with the keyboard 'stop' media key
• Internet radio:
• Stream relaying not working on some redirecting stream URLs, depending on the headers #1194
• Stream playback failing when the stream URL has only the domain part without any path and no trailing '/' (like http://abc.somedomain.xyz)
• Stream playback failing when the given URL redirects to a playlist file containing the actual audio URL
• HTTP redirections not followed when parsing Icy-MetaData of the channel
• Layout glitches:
• Navigation items "Search" and "Settings" positioned and highlighted incorrectly on NC30+ with Chromium based browsers
• Collapsed navigation pane and corner roundings shown wrong on narrow screens on NC 30.0.5
• Ampache API: CORS problem on the endpoint /ampache/image.php #1199 @rstefko
• Subsonic API: In JSON responses, playlist id was returned as integer instead of string type #1202

Hotfix

• Background cleanup job not working with PostgreSQL (since v2.1.0) #1191

Added in v2.1.0

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed in v2.1.0

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed in v2.1.0

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• Dashboard widget for Nextcloud #1172
• Ampache API:
• Support for API key authentication
• Support for action playlist_hash
• Subsonic API:
• OpenSubsonic extension apiKeyAuthentication, including support for arg apiKey and the new method tokenInfo

Changed

• Renamed config.php key music.allowed_radio_src as music.allowed_stream_src. Its default value is now an empty array [].
• Internet radio and podcast streams are now relayed via the user's cloud instance by default. To opt out, set the config.php keys music.relay_radio_stream and music.relay_podcast_stream as false and add required sources to music.allowed_stream_src. #1035
• Documentation of the admin configuration options moved from the Settings view to the Wiki page
• Troubleshooting for Internet radio moved to the Wiki page
• Allow translating all the strings in the embedded Files player and the new Dashboard widget. Provide Finnish translations for these.
• Optimized loading of folder tree also for cases where the library root is the home folder and there is a huge externally mounted audio folder
• Prompt user to rescan modified tracks on app load if that has not happened automatically (e.g. for shared files modified by another user) #706
• Ampache API:
• Action get_indexes supports also type=song_artist
• Actions playlists and playlist support argument include
• Added fields art and has_art to the podcast_episode and live_stream result types
• Added fields username, max_song, max_album, max_artist, max_video, max_podcast, max_podcast_episode to the responses of handshake and ping
• Added fields md5, has_access, has_collaborate, and last_update to the playlist results
• For radio stations without user-supplied name, use the stream URL as a name
• Set CORS headers and enable pre-flight to allow Ample or other web app clients to connect from any domain #1181
• Action get_bookmark returns an empty response instead of error if the object ID is valid but there are no bookmarks on the object
• Action get_bookmark supports argument all (affects response format only, we still don't support more than one bookmark per song/episode)
• Subsonic API:
• Allow method getOpenSubsonicExtensions without any user authentication
• When browsing by folder, getMusicDirectory sorts songs by file name instead of song title #1182
• Added field path to all song responses

Fixed

• Song progress shown incorrectly in the media session integration of Chrome when playing (exotic file types) with the fallback Aurora.js player
• Track disappearing from playlists when moved to another folder within the library folder #1173
• Scan sometimes breaking on MariaDB with "Serialization failure: 1213 Deadlock" when the cleanup task gets run on the background #918
• In Files app, sidebar not showing playlist file contents if the list has any external URLs with no caption
• Uploaded image not used immediately as album cover when using SQLite (background job fixed this, though)
• Ampache API:
• Action playlist_songs returning internal error 500 if the playlist contains any broken track references
• Action download still implicitly recording song as played even though that was supposed to change in v2.0.0
• Playlist content editing not working with the action playlist_edit
• Actions playlist_add and playlist_add_song not working when using SQLite

Added

• French translation #1157 @flozz
• Support for Nextcloud 30

Changed

• Subsonic API: For radio stations without user-supplied name, use the stream URL as a name

Fixed

• Favorite toggle button not working on artists with no image available
• Cover art image not used automatically upon the image file upload in some cases when PostgreSQL used #1164

Added

• Additional tabs "Albums" and "Tracks" to the artist details pane
• Additional tabs "Tracks" and "Artists" to the album details pane
• Favorite toggle to the details pane of the tracks, albums, artists, playlists, and podcasts
• New filter "Favorite" for the smart list
• OpenSubsonic extensions to the Subsonic API:
• Method getLyricsBySongId
• Property sortName to all artist, album, and song responses
• Property played to all song responses

Changed

• Drop support for PHP versions older 7.4 (i.e. PHP 7.1 - 7.3)
• Drop support for ownCloud versions older than 10.5 (i.e. OC 10.0 - 10.4)
• Drop support for Nextcloud versions older than 20 (i.e. NC 13 - 19)
• New design including cover art on all list-like views
• Ampache and Subsonic APIs: Check the username in case-insensitive manner #1147
• Ampache API:
• The action download doesn't implicitly record the track as played (unlike stream)
• The song property url refers to the stream URL instead of download URL

Fixed

• Playlist sorting not working if the list contains any broken track references
• Nextcloud.log being flooded with the debug-level message "/appinfo/app.php is deprecated" on NC20+ #1043

Added

• Advanced search view #1141
• Support for Nextcloud 29 #1132
• Ampache API:
• Option to change the session timeout with the config.php key music.ampache_session_expiry_time #1134
• Support for the actions search, user, user_playlists, user_smartlists, playlist_add, index, scrobble
• Support for the advanced search rule bitrate on songs
• Subsonic API:
• Support for the method getOpenSubsonicExtensions

Changed

• Ampache API:
• Advanced search operators matches regex and does not match regex supported also on SQLite (this is important to properly support Ample)
• Advanced search operators sounds like and does not sound like supported also on SQLite, and on PgSQL if module fuzzystrmatch is installed
• Advanced search rules album_genre and artist_genre supported also on PgSQL
• Authentication tag can be delivered also using the bearer token header (required to support Ample v3) #1140
• All results with property art have also the property has_art
• Implicitly record the track as played with the actions download and stream

Fixed

• Playlist file not playing within Files in case the first track of the list is in unsupported format
• Some Finnish translations being replaced with English (since v1.9.0)
• Error "Cannot set response code - headers already sent" logged on each played song on PHP 8.3 #1133
• Files player: Menu icon for "Import list to Music" not adjusted correctly for the dark theme
• Standard NC viewer opened instead of embedded Music player when opening file from Dashboard on NC28+ #1126
• Music app page loading randomly failing on Chrome #1137
• Ampache API:
• API not working on ownCloud 10.14.0 (HTTP error 500 on all Ampache API calls) #1138
• Advanced search rule playlist_name not being case insensitive like the other string rules
• Advanced search rules playlist and playlist_name not working with SQLite
• Advanced search operator does not sound like not working
• Advanced search numeric rules (e.g. year, played_times, album_count) not working properly on SQLite
• Advanced search rules album_count and song_count never finding artists whose respective count is 0
• Incorrect root node name on the actions user_preference and user_preferences
• Subsonic API:
• Method getAlbumInfo2 response having incorrect root element name #1125 @perillamint
• On NC28+, every XML API call logged an error 'Undefined array key "" at /var/www/html/lib/private/AppFramework/Http.php#128'. #1142

Added

• Support for Nextcloud 28 #1116
• Support for PHP 8.3
• Ampache API:
• Support for argument random in the method playlist_songs
• Method bookmark
• Support for argument include in all methods returning bookmarks
• Subsonic API:
• Property playCount to song responses
• OpenSubsonic API extensions:
  • Properties openSubsonic, type, and serverVersion to all responses
  • Allow getting the whole library with an empty query argument in search3 method
• MusicBrainz link from Last.fm to the artist/album/track details pane, when available
• Filters "Recently added" and "Not recently added" for the smart playlist #1098
• Optional "strict" mode for the history filters of the smart playlist #1099
• Hint about the keyboard shortcuts in the Settings view and in tooltips #1086

Changed

• Ampache API:
• Make advanced_search arguments operator and type optional
• On method bookmark_create, the argument client defaults to null instead of "AmpacheAPI"
• Subsonic API: Methods search2 and search3 support '*' as a wildcard
• Consider also the tag names unsynced_lyrics and unsyncedlyrics when parsing lyrics #1111 @RobertZenz
• Updated the getID3 library to the development version 1.9.23-202312292105
• Fixes the issue of garbage bytes being extracted from some RIFF tags #1115
• Search within the Music app now works with an own input field in the navigation pane instead of the unified search input

Fixed

• Songs with scanned integer property value (like track number) larger than 2147483647 causing error on PostgreSQL #1106
• Lite player in Files attempting to play also audio files with MIME types unsupported on the current browser
• Subsonic API: Use integer-type IDs in getMusicFolders to comply with the API specification #1108
• Playlist details showing length as "NaN:NaN" in case the playlist contains any invalid track references

Version 1.9.0 had an app update problem on some versions of Nextcloud with SQLite. This version works around that issue but is othwerise identical with v1.9.0.

Added

• Smart playlist feature, allowing list creation by user-supplied criteria #619 #1061 @rstefko
• Dragging tracks/albums/etc on the "+ New Playlist" item creates a new playlist containing those items
• Files playlist tab: Tooltip showing the file path or stream URL
• Subsonic API:
• Rating support: method setRating, rating properties in all applicable result entities, type highest to the method getAlbumList
• Empty implementation for the method getNowPlaying #1079 @NattyNarwhal
• Ampache API: #1078
• New methods:
  • rate
  • get_similar
  • genres, genre, genre_artists, genre_albums, genre_songs
  • bookmarks, get_bookmark, bookmark_create, bookmark_edit, bookmark_delete
  • live_streams, live_stream, live_stream_create, live_stream_edit, live_stream_delete
  • list
  • browse
  • user_preference and user_preferences with mock-up content
  • advanced_search with partial support, not all search rules supported and some operators work only with MySQL/MariaDB
• Support for the type album_artist in the method get_indexes
• Support for the parameter album_artist in the method artists
• Support for the type playlist in the method stats
• Support for the type playlist in the methods download and stream
• Support for the type playlist in the method flag
• Support for the parameter top50 in the method artist_songs
• Support for the filter highest in the method stats
• Support for the parameter include in the methods album, albums, artist, and artists
• Fields time, albumcount, songcount, prefix, and basename to the artist type results
• Fields time, diskcount, songcount, prefix, and basename to the album type results
• Fields disk, format, stream_format, stream_bitrate, stream_mime, and playlisttrack to song type results
• Fields time, size, bitrate, stream_bitrate, rating, and preciserating to podcast_episode type results
• Fields rating and preciserating to podcast type results
• Fields flag, rating and preciserating to playlist type results
• Null-valued fields language, lyrics, mode, rate, replaygain_album_gain, replaygain_album_peak, replaygain_track_gain, replaygain_track_peak, r128_album_gain, and r128_track_gain to song type results
• In JSON-mode only, field artists to song and album type results
• All the fields of handshake response on the response of ping within a valid session