Requires at least Ampache 6.6.0

Fixed

• Sharing is a preference so only show if enabled

Requires at least Ampache 6.6.0

Fixed

• Show indication that queue repeat is enabled
• Songs without gain tags would play silently
• 'Share' was present in UI but not implemented (implemented now)
• Bookmark button present in player UI but not implemented (disabled until implemented)

Requires at least Ampache 6.6.0

Player changes

• Streamlined UI
• Waveform now full width of player & can be hidden
• Entire player itself can be hidden
• Hover over next/previous buttons for item details
• Added buttons for +30sec & -10sec
• Change playback speed (with pitch correction)
• Add to Playlist and Find duplicates for the current media

Data table changes

• Now using the Tabulator library which brings
  • Column reordering
  • Remote pagination
  • Happier development as I don't have to maintain a custom table library anymore

Added

• Translations
  • Korean (한국어)
  • Italian (Italiano)
  • Hungarian (Magyar)
  • Polish (Polski)
  • French (Français)
  • Portuguese (Português)
  • Spanish (Español)
• Theme color settings & presets
• More 3rd party links (now with icons)
  • Bandsintown
  • Genius
  • Setlist.fm
  • Song Kick
  • Amazon Music
  • HDTracks
  • Qobuz
  • Tidal
• Show mini-rating for items in the queue
• Artist Releases custom display options
  • Display: Table, Cards (small), Cards (large), Tracks (columns), Tracks (table)
  • Sort: Name, Artist, Rating, Year
  • Grouping: Name, Release Type, Year, Decade (from Year tag)
• Client-side settings now saved per user
• Albums by Year range slider
• Cache and invalidate stale data with Tanstack Query

Changed

• Must define a URL in config file instead of entering at login
• Rebuilt UI atop Shoelace web components
• Better playlist reordering (don't need to enter 'Edit mode' anymore)
• Improved search
  • Results are ordered by their weighted score (using fuse.js)
  • Show total results per type
  • Removed separate X Starting With and X Containing (not needed with the new system)
• 'Public' Ampache servers can auto-login with a defined Guest user API key, see config
• Moved Insights pages (e.g. Trending, Unrated etc) out of sidebar and onto homepage
• Skip below rating
  • Instead of filtering items before adding to queue, they will be added but auto-skipped if enabled (indicated by diagonal shading)
  • Can optionally allow unrated items through the filter
  • Moved from player to queue
• Opening the queue will reveal the currently playing media
• Moved song/media parent items from the main dropdown menu to their own submenu
• Notifications can be 'silenced'; they will only show in the list without an alert
• Artist Appears On
  • Consolidated together at the end of artist releases instead of per release type
  • New option to dim tracks that aren't by the artist, or hide them altogether
  • New option to skip playing songs that aren't by the artist being viewed
• For Artist Mixes which don't have any similar artists, expand search into same genre
• Removed dedicated Multi-rater page in favour of being able to rate items from the Unrated page (or anywhere)
• Lyrics panel now a full overlay instead of a floating panel
• Reworked albums by year interface, now uses a range slider

Fixed

• Rearranging the queue could mark the currently playing media incorrectly
• Rating the currently playing item would not be reflected elsewhere
• Improved error handling

Removed

• Queue reordering is temporarily disabled in favour of having it be virtualised for performance

Requires Ampache 6.5.1

Probably the last beta before moving to RC

Changes compared to v2

Player

• Streamlined UI
• Waveform now stylized and full width of player; can now be hidden
• Entire player itself can be hidden
• Hover over next/previous buttons for item details
• Added buttons for +30sec & -10sec
• Playback speed options (with pitch correction)
• Add to Playlist and Find duplicates for the current media

Added

• Theme settings & presets
• Cache API calls for better responsiveness (localforage & Tanstack Query)
• More 3rd party links (now with icons)
  • Bandsintown
  • Genius
  • Setlist.fm
  • Song Kick
  • Amazon Music
  • HDTracks
  • Qobuz
  • Tidal
• Show rating for queue items
• Artist Releases custom display options
  • Display: Table, Cards (small), Cards (large), Tracks (columns), Tracks (table)
  • Sort: Name, Artist, Rating, Year
  • Grouping: Name, Release Type, Year, Decade (from Year tag)
• Client-side settings now saved per user
• Table columns can be repositioned via Table Options located above each table
  • Actions are now the first column by default instead of stickied at the end

Changed

• Improved search results
  • Results are ordered by their weighted score (using fuse.js)
  • Show total results per type
  • Removed separate X Starting With and X Containing (not needed with the new system)
• Moved Insights pages (e.g. Trending, Unrated etc) out of sidebar and onto homepage
• Skip below rating
  • Instead of filtering items before adding to queue, they will be added but auto-skipped if enabled (shown by diagonal shading)
  • Can optionally allow unrated items through the filter
  • Moved from player to queue
• Opening the queue will reveal the currently playing media
• Moved song/media parent items from the main dropdown menu to their own submenu
• Notifications can be 'silenced'; they will only show in the list without an alert
• Artist Appears On
  • Consolidated together at the end of artist releases instead of per release type
  • New option to dim tracks that aren't by the artist, or hide them altogether
  • New option to skip playing songs that aren't by the artist
• For Artist Mixes which don't have any similar artists, expand search into same genre
• Removed dedicated Multi-rater page in favour of being able to rate items from the Unrated page
• Lyrics panel now a full overlay instead of a fixed panel overlaying the content

Fixed

• ^Rearranging the queue could mark the currently playing media incorrectly
• Rating the currently playing item would not be reflected elsewhere
• Improved error handling

Removed

• ^Queue reordering is temporarily disabled in favour of having it be virtualised for performance

• Virtual list for the queued items (drag and drop reordering is removed, will reimplement in future)
• Change playback speed from menu to slider
• Remove 'waitForElement' logic which could cause hangs

Improved error handling

Still a few things needing to be fixed up but take it for a spin and report any bugs

Player

• Streamlined UI
• Waveform now stylized and full width of player; can now be hidden
• Player itself can be hidden
• Hover over next/previous buttons for item details
• Added buttons for +30sec & -10sec
• Playback speed options (with pitch correction)
• Add to Playlist and Find duplicates for the current media

Added

• Theme settings & presets
• Cache API calls for better responsiveness (localforage & Tanstack Query)
• More 3rd party links (now with icons)
  • Bandsintown
  • Genius
  • Setlist.fm
  • Song Kick
  • Amazon Music
  • HDTracks
  • Qobuz
  • Tidal
• Show rating for queue items
• Artist Releases custom display options
  • Display: Table, Cards (small), Cards (large), Tracks (columns), Tracks (table)
  • Sort: Name, Artist, Rating, Year
  • Grouping: Name, Release Type, Year, Decade (from Year tag)
• Sidebar toggleable categories
• Client-side settings now saved per user
• Table columns can be repositioned via Table Options above each table
  • Actions are now the first column by default instead of stickied at the end

Changed

• Improved search results
  • Results are ordered by their weighted score (using fuse.js)
  • Show total results per type
  • Removed separate X Starting With and X Containing (not needed with the new ordering)
• Moved Insights pages (e.g. Trending, Unrated etc) out of sidebar and onto homepage
• Skip below rating
  • Instead of filtering items before adding to queue, they will be added but auto-skipped if enabled (shown by diagonal shading)
  • Can optionally allow unrated items through the filter
  • Moved from player to queue
• Opening the queue will reveal the currently playing media
• Moved queued song/media parent items from the main dropdown menu to their own submenu
• Notifications can be 'silenced'; they will only show in the list without an alert
• Artist Appears On
  • Consolidated together at the end of artist releases instead of per release type
  • New option to dim tracks that aren't by the artist, or hide them altogether
  • New option to skip playing songs that aren't by the artist
• For Artist Mixes which don't have any similar artists, expand search into same genre
• Removed dedicated Multi-rater page in favour of being able to rate items from the Unrated page
• Lyrics panel now a full overlay instead of a fixed panel overlaying the content

Fixed

• Rearranging the queue could mark the currently playing media incorrectly
• Rating the currently playing item would not be reflected elsewhere

Requires at least Ampache 6.0.1

Fixed

• Preferences are now objects

Fixed

• Album Artists -> All was showing all artists

Fixed

• Advanced search inputs for Added/Update use date inputs

Changed

• Prefix all localstorage values with 'Ample', you will lose your settings sorry :(

Requires at least Ampache 6.0.0

Added

• Multi-artist support
• Translated UI (English-US, English-AU, German available, see readme on adding more)
• Show Previous/Next/Adjacent releases on album page
• Fetch album disk subtitles from MusicBrainz
• Option to view artist releases chronologically
• New search results interface
  • Split into categories (song, album, artist etc)
  • Smaller items to see more results at once
• Majority of views now have both list & card options
• List views will show all results, card views will be paginated (virtual vs traditional for technical reasons)
• Ability to download individual songs

Changed

• Removed Apache/NGINX/other server requirement; will now run from any directory
• General design overhaul
• Rebuilt "Recently Played" on main page; handles song updates much better now
• Simplified Sidebar to only have full/collapsed modes
• Queue actions moved to a menu
• Smartlist Autoplay now has a 10 seconds grace period before adding songs to give user time
• CSS container queries polyfill removed as browser support is stable now
• Tabs will remember the last active tab, e.g. being on Similar Artists then going to a new artist will keep you on the Similar Artists tab
• Rebuilt all menus and panels to use 'floating-ui'; they now scroll with the page

Fixed

• Volume gain was ignored if values were "0"
• Some Listers were breaking out of their containers
• Lister headers sometimes wouldn't become sticky

For Ampache 5.x

Added

• Artist Mix recommendations on the home page (based on trending and 4/5 rated artists)
• Alert popups, e.g. when AutoPlay adds songs to queue or when songs below set rating are skipped
• Give each page its own title to avoid a sea of "Ample" in browser history

Changed

• Removed rating clear button; now click the current rating to clear it
• Backend now uses the 'javascript-ampache' library for API calls

Fixed

• AutoPlay would add process twice

Changed

• 'Contains' search results won't include anything 'Starting With' to avoid duplicates
• Improved player layout for mobile
• Responsive layout for MusicBrainz Compare
• Simplified Albums By Year range interface
• Replaced alphanumeric buttons on Artists/Albums > All tab with a filter field
• Cleaner/simplified Artist/Album/Song cards
• Player will be set to full volume when mobile device is detected, assuming hardware volume controls to be used instead
• Use standard Lister and Album Card when showing expanded albums

Fixed

• Don't show album art in Lister when viewing an album
• Restore Shuffle for playlists

Fixed

• Container queries on Chrome
• Drag and drop broke after adding fullscreen mode
• Media would still play after logging out

The folder structure has changed due to switching to Vite for compiling. Remove contents of ample folder before updating.

Additionally Vite has a different method of URL management, let me know if things break for you.

NGINX users update your rewrite from index.php to index.html

Added

• Search results are split into 'starts with' and 'contains' groups
• Start of a 'fullscreen' mode for Now Playing on smaller devices

Changed

• Header logout and theme switch combined into a menu
• Separate "Artist" and "Album Artist" views instead of having a toggle

Removed

• 'Fancy' search queries e.g. "artist:king"

Fixed

• Login errors not shown
• Handle image loading errors and show fallback image
• Chrome playlist view not scrolling on smaller screens

Added

• Alphabetised list of all artists/album artists on the Artists page

Changed

• The 'artist' column will always show when an album is by Various Artists
• Minimum 2 chars needed for quick search, down from 3
• Name and Actions columns won't become sticky unless there is enough room to comfortably show both

Fixed

• Layout glitches in Chrome 105+ related to CSS Container Queries

Added

• Interface improvements for smaller screens
  • Sidebar and queue can be pinned to the interface (this was the previous behaviour) or floating above it
  • Sidebar can be hidden
  • Player improvements for small screens
• Filter album artists (requires at least Ampache 5.5.1)

Changed

• Dedicated 'Current' button for scrolling to currently playing song instead of clicking 'Now Playing'
• Changed 'Clear played' to be a text button instead of X
• Moved "Skip Below # Rating" from context menu into main player interface (near volume controls)
• Improved volume compressor (Night Mode), fixes the volume slider having no effect over 50% when enabled

Added

• New play option: Start Artist Mix
  • Loads up to 200 songs by this and related artists
• Show lyrics (if present) in the song details view

Changed

• Improved the MusicBrainz artist scanner (artist page > MusicBrainz compare tab)
  • Show your songs (indicated with album art) alongside the MB recordings
  • Remembers filter selections instead of having defaults
  • Show MBID
  • Expanded status types
    • Exact matches: MBID found
    • Duplicates: MBID didn't match, but there was an exact match with the same name
    • (NEW) Issues: Something isn't right, e.g. missing/invalid MBID
    • (NEW) Flagged: In library but not found on MusicBrainz, probably needs to be added to the database
    • Missing: Song not found in library
• Refactored Actions component

Added

• Dynamic Playlist artwork from songs in the playlist
• Song detail page
• Filter album artists (not enabled yet, waiting for Ampache release)

Changed

• Album track list now uses the Lister component instead of a simplified track list
  • Has separate column settings from other Listers, so you can still have less info in album views
• Remember 'Show Expanded/Condensed' setting on artist pages