2026.07.20
- harden song and album downloads: stream to a per-process .part file, validate HTTP status / size / audio magic (reject HTML error bodies), then atomically replace the final .mp3
- Content-Length checks skip when Content-Encoding is present (avoids false failures on decoded streams)
- failed downloads leave any existing local .mp3 untouched and do not update downloads.list
- album downloads create the downloading.txt lock up front, clear it in finally, and skip-and-continue on individual track failures
- keep-downloads / playback cache filenames use the same album storage artist+album keys as downloads

2026.07.19
- flat Artist - Album storage escapes embedded " - " (and path-invalid characters) so distinct artist/album pairs no longer share one folder or overwrite each other
- playback prefers the new unambiguous flat path, then falls back to legacy flat folders and pre-2026.07.16 album-only folders with ID3 verification

2026.07.18
- legacy Music/<Album>/ local playback kept for older downloads; when ID3 artist/album tags are present they must match so same-title albums from different artists no longer play the wrong file

2026.07.17
- fix single-track downloads from album pages with collaborative/contributing artists using the track artist as the folder owner — they now store beside full-album downloads under the album artist + album title folder (thanks JMAN730)

2026.07.16
- fix album downloads from different artists with the same title overwriting each other — album folders are keyed by album artist plus album title again (thanks Cursor daily review)
- album playback and stream-cache paths use the same album storage helper and track-numbered filenames as album downloads

2026.07.15
- genre menu icons: rename thrash_speedmetal typo, add topworld/nordicfolk/topclassical from parent genre art, rename r&b folder to r_b to match path code; resolve genre icons with parent fallbacks

2026.07.14
- fix single-track downloads dropping the track-number prefix from filenames (thanks JMAN730)
- fix collab and featured-artist albums downloading into nested per-artist folders instead of one flat album folder (thanks JMAN730)
- migrate language strings from legacy strings.xml to resource.language.en_gb/strings.po (Kodi 19+) (thanks JMAN730)
- remove deprecated start="startup" from xbmc.service declaration in addon.xml (thanks JMAN730)
- fix addon fanart and icon paths in addon.xml (art/fanart.jpg, art/icon.png)
- fix browse fanart and notification icon paths to match addon.xml assets (art/fanart.jpg, art/icon.png)
- Estuary WideList icons: set ListItem.Icon, empty list content (not files), and musicmp3 Referer/UA on remote cover URLs (Red Light pattern); artist rows use art/artists.jpg when no cached photo

2026.05.26
- fix songs with "/" in titles not appearing in search or downloading
- sanitize filenames and URL-encode context menu actions for special characters
- decode HTML entities in download folder and file names (e.g. &amp; to &)
- decode HTML entities when browsing, searching, and viewing favourites
- add Settings to the main menu
- fix custom music directory setting being ignored when unticked
- add Default/Custom folder dropdown
- show download started and complete notifications for songs and albums
- fix favourites display, playback, add/remove, and grouping
- fix favourite remove failing when artist or title contains special characters such as &
- show confirmation notifications when favourites are added or removed
- show notification when a search returns no results
- return to main menu when cancelling favourite group selection or when favourites are empty
- return to previous menu position when backing out of favourites or empty searches
- preserve main menu scroll position when removing the last favourite
- fix blank menu after removing favourites or other context-menu actions
- use plain English labels for music directory settings

2018.08.28
- fix compilation artwork
- fix next page
- remove myfreemp3 functions
- minor cosmetic cleanups

2017.09.09
- fixed by qahanik (thank you very much!)
- changed versioning to date-format
- fixed album downloading
- minor cosmetic cleanups

1.2.4
Different play method for 17.0. Older Kodi versions use pre-cache function.

1.2.1
Fixed playback

1.2.0
Fixed playback
Fixed downloads

1.1.9
Fixed compilations

1.1.8
Fixed billboard charts

1.1.7
Added "golden" path

1.1.6
Fixed charts

1.1.2
Fixed album search results for 'Various Artist' compilations

1.1.1
Fixed addon.xml
Fixed pre-cache default setting
Fixed track number error

1.1.0
Playback function re-written by ****** to pre-cache songs!
Added option to always keep cached songs and automatically set ID3 tags (******) - Disabled by default
Added option to set preferred artist/album folder structure for downloads
Added new Compilations menu

1.0.8b 
Fixed charts

1.0.8a 
Code fixes for alternate source

1.0.8
Added option to use alternate mp3 source for users running Gotham

1.0.7a
Added artist search mode for Super Search

1.0.7
Added context option to albumb/song lists to clear Download Lock

1.0.6
Added setting to use DVDPlayer or PAPlayer

1.0.5a
Added icon for "Add ID3 tags"

1.0.5
Fixed script error when adding song to queue
Adding settings option to queue songs on selection
Added context on song to play song if Queue Songs setting is enabled

1.0.4
Fixed incorrect icons for Instant Mix

1.0.3
Fixed issue where some titles were not saving to favourites
Added Groups function to favourite songs & albums: create & instant_play separate playlists

1.0.2
Added downloads

1.0.0
Added art by Marquerite!

0.9.9a
Fixed searches with '&' in artist/album/song name
Added Instant Mix Albums function
Added UK Official Top 100 Single list

0.9.9
Fixed playback errors on non-Windows devices

0.8.5
Attempted fix for non-Windows devices

0.8.0
First release!