Amperfy Music2.1.1 - App Store

Amperfy allows you to play music or podcasts from an Ampache or Subsonic server.
Experience a clean, simplistic and modern client for your music server interactions.
Download the songs from your music server to play offline.
Amperfy requires a private hosted Ampache or Subsonic server installation to function.

Features:

- Multi account
- Offline mode
- CarPlay
- Gapless playback for appropriate media file formats
- Music, Podcast and Radio support
- Siri play media command, Siri Shortcuts and App Intents
- Equalizer
- Replay gain
- Sleep timer
- 5 star song rating
- Favorite song
- Sleep Timer
- Scrobbling

Amperfy is open source and licensed under GPLv3.
It can be found at https://github.com/BLeeEZ/amperfy
Please discuss this app and report all issues at https://github.com/BLeeEZ/amperfy/issues

Version History Features
- Support custom HTTP headers per account
- Support autoplaying similar songs at the end of the play queue
- Add "Instant Mix" via the server API to request similar songs
- Support sharing songs
- Display radio station metadata in player info
- Always-on-top setting for the macOS mini player
- Clicking a lyric line will seek to that point in the song
- Seek directly on click (instead of click-and-drag) in the macOS player

Bug Fixes
- Fixed endless artwork downloads
- Fixed playing a song directly when clicked in the Home random songs section
- Fixed CarPlay displaying the album's song list instead of directly playing the album 2.1.1 Aug 13 Features
- Multi account support
- Configurable Home tab
- Reworked SiriShortcuts and Intents
- Reworked CarPlay interface
- Optional song rating display
- Siri support for radios via voice command
- Support radios in PlayID and SearchAndPlay intent
- New setting to optionally save and use song playback progress
- Library resync and logout can be done without restart
- Volume slider available in iOS and iPadOS

BugFixes
- Fixed mini player title tear
- Fixed NowPlayingInfo when player is paused
- Fixed macOS crash in fullscreen when selecting the searchbar
- Fixed cached scrobble times for Subsonic API 2.1.0 Mar 19 Features
- Adaptation to Liquid Glass
- Equalizer support
- Support for replay gain received from server
- Settings: configure transcoding format separately for WiFi and Cellular
- Added pause quick action for music and podcast playback
- Added audio visualizer and spectrum analyzer in player view
- Display bitrate and audio format of the currently playing track in player view
- Settings: configure light/dark mode
- Songs: sort by "Date Added" for Subsonic API

Bug Fixes
- Fixed shuffle algorithm issue
- Fixed crash on playlist update
- Fixed crash when clicking "Random" on an empty radios list
- Fixed scrobble timer
- Fixed favorite swipe action color 2.0.0 11/10/2025 Features
- Radios: add support for Ampache API and Subsonic API
- Player: support gapless playback for appropriate media file formats
- Performance: reduce CPU consumption for API requests and player
- Artworks: downloaded artworks can be deleted in Settings
- Playlists: add multiple library element to playlist via edit
- Playlists: delete multiple songs at once from playlist
- Playlists: add songs to multiple playlists at once
- Playlists: show alert when duplicates are about to get added
- Siri-Shortcut: add "Play Random Songs" intent
- Tables: align columns and add ellipsis to playables
- Cache: display alert before deleting cache
- Transcoding: add option to let server decide which codec to use
- Player: improved error handling
- Artworks: create light and dark mode versions of default artworks
- Player: hide player mode change button if user hides podcasts from library category list
- X-Callback-URL Docu: add example copy button
- Player: reduce button count (move buttons inside options menu)
- General: multiple performance improvements

BugFixes
- Album: fix queuing albums sorted by track number
- PopupPlayer: fix moving elements after App opening
- Siri-Shortcut: fix failing play request due to long response times (fetch only playlist before play)
- Subsonic API: handle 404 status codes
- Subsonic API: fix empty albums due to missing isDir attribute
- Album collection: fix clipping title label
- Swipe & Preview: refresh cell when favorite and cache is changed
- Collections: fix duration overflow
- Preview: favorite and rating was interactable when in offline mode
- Preview: fix detail size 1.2.3 05/10/2025 Features
- macOS Catalyst: add platform support
- Lyrics (subsonic only): unsynced and synced lyrics are supported
- Theme: add theme colours
- Artists: support album artists filter
- Albums: display as collection (grid size is adjustable) or as table
- Sync: initial sync is skippable
- CarPlay: add "Cached" tab
- CarPlay: trigger artwork download and display on completion
- Songs: sort by starred date sort setting for favourite songs (Subsonic only)
- Songs: press to play songs add next songs to queue too
- OfflineMode: notify user at each start that Offline Mode is active
- SleepTimer: add option for 2 and 4 hours
- X-Callback: add action for rating and favourite
- Siri: log request and response in EventLogger

BugFixes
- Siri Intent: fetch elements before play
- Scrobble: cache failed sync scrobbles too
- Disabling shuffle mode in setting does not work everywhere
- Player: song progress wasn't kept when App crashed or mode changed
- Player: audio engine crash can be fixed by switching mode or play next song instead of App restart 1.2.2 12/02/2024 Features
- Transcoding: download and streaming
- Streaming: bitrate adjustable for WiFi/Cellular
- Cache: use file manager (reduce iCloud backup size)
- Siri: read out found request
- Scrobble: support NowPlaying
- Player: close player on swipe down
- Player: display remaining and total playtime in options
- Search Tab: improved search results
- Player: toggle playlist style via artwork button press
- Player: option to start audio playback only via press on play
- Player: option to deactivate the shuffle button
- HapticFeedback: can be disabled in settings

BugFixes
- Siri Shortcut: trigger correctly when Amperfy is terminated
- AudioSession: playback paused under certain circumstances when in background
- Albums: display section header and index titles correct
- Initial Sync: ignore xml errors to continue with the sync
- Settings: use large titles on main view to match other tabs
- PopupPlayer: remove player bar background on settings page
- Podcasts: skipForward rather than playNext with remote command
- DownloadManager: memory overflow due to always loading download data into memory 1.2.1 06/23/2024 Features
- UI: new Player and view styling
- iPad UI: use sidebar, improved cells and additional mini player buttons
- Newest Albums: fetch and display during scrolling
- Recently Played Albums: now supported, they are fetched and displayed during scrolling
- Detail View: use iOS Preview to display details and actions
- Home Screen Quick Actions: search, play song/podcast and start in Offline Mode
- Search: track search history
- Scrobble: optional activate scrobble for streamed items
- KeyCommand: add navigation add keyboard shortcuts
- CarPlay: rework UI, update on library changes and support player queue
- Directories: add play/shuffle button and preview
- Playlist: improve perfomance via cached artworks
- Remote Control: change playback rate
- Remote Control: support change playback position and change favorite
- Podcast: add sheet view to display description
- Siri: use fuzzy search to improve search results
- NotificationBanner: display only one banner
- Supported iOS version 15.0 and higher

Bug Fixes
- CarPlay: fix termination on disconnect
- PlayRandom: improve performance
- Album: fetch artwork even if the track number is displayed
- Downloads: crash due to locked semaphore
- MiniPlayer: fix flashing progress bar
- PlaylistDetail: fix UI glitches when changing order or remove itemes
- Siri: support command "play music" 1.2.0 04/22/2024 Features
- Siri voice commands: "Play title" (Siri voice commands are always localised)
- Player: Variable playback rate
- Settings: Screen lock prevention
- Siri Shortcut and CallbackURL: support play by ID
- Settings: display duration of artists/albums/songs
- Sleep Timer: accessible via player
- Sleep Timer: pause at end of song/podcast episode
- Artists, Albums, Songs, Playlists: sort by duration
- Albums: sort by year
- Artists, Albums, Songs: indicate favourites via icon
- Settings: skip backward/forward can optionally be displayed in music player
- Settings: display additional information like element id and copy it to clipboard

Bug Fixes
- Subsonic API: local artists got removed when synced
- Ampache API: directory browsing resulted in crash 1.1.5 02/16/2024 Features:
- User can limit cache size in settings

Bug Fixes:
- Short songs are not scrobbled correct
- UI improvement 1.1.4 01/10/2024 Features:
- User logout is possible
- User can trigger library resync

Bug Fixes:
- Player pauses on interruption (Siri, call, ...) and continues playback after interruption end 1.1.3 04/24/2023 Features:
- CarPlay: complete rework
- Library: elements can be ordered and hidden
- Library: navigate directly to favorite/recent elements
- Sleep Timer: pause playback after time interval expires
- Recent Songs/Albums: sorted by recently added order
- Player: show album name in large mode
- Artists/Albums/Songs: download all as action
- Albums: sort by artist as sort option
- Songs/Albums: play and shuffle button added
- Artist details play: songs are sorted by album
- Songs: detail string shows bitrate
- Player: new background style
- Siri: added playRandomSongs

Bug Fixes:
- Playlists can be deleted again
- iPad: actions are displayed on button
- Crash due to slow internet connection 1.1.2 02/09/2023 Features:
- Siri shortcuts are available
- Keyboard shortcuts are available
- X-Callback-URL is available for Siri shortcuts

Bug Fixes:
- Local artists get removed due to duplicate scan
- Genres get deleted after restart
- App crash after library sync 1.1.1 07/18/2022 Features:
- Play context depending on song press
- CarPlay support: Playlists, Podcasts, Recent Songs, Recent Albums
- Player: music and podcast mode with separate queues
- Set and unset favorite for Artists, Albums, Songs
- Rate Artists, Albums, Songs with 0-5 stars
- Fully configurable swipes
- Animated bars indicate currently playing song or podcast episode
- Sync all library songs in background
- Artists, albums and songs can be sorted by rating
- Option to auto download latest songs and podcast episodes
- Option to cache all library song
- Option to cache all artworks
- Server URLs: add additional URLs for internal and external network usage
- Detail information about library elements via long press
- Icon beside artist name indicate cache status
- Play all songs in library function added
- Playlists sort option: sort by name, last change date and last played date
- Podcasts sort option: Showing all Podcast episodes sorted by release date
- Artists, Albums, Songs filter option: favorite
- Remote Control: support for repeat and shuffle changes
- Display track number in album details
- Player controls take up less space
- New default artworks for all library elements
- Hide player bar if empty

Bug Fixes:
- Remote deleted library elements creating error messages
- Remote deleted songs get hidden on album and artist sync
- Duplicated library elements are getting removed
- Multiple error notifications at once can't be suppressed
- Missing Artist names in some subsonic Albums
- Crash from wrong table view section sorting
- AirPlay: correct setup to stream audio
- Songs: hide 0kb size song files
- Long press gestures are not working after first login
- Settings: password change lead to crash 1.1.0 06/03/2022 Features:
- Add songs to player queue via swipe
- Scrobble: notify server about played songs
- Extract artwork form ID3 tag
- Request delete of podcast episode on server
- Display only available podcast episodes

Bug Fixes:
- Ampache: fix published date on podcast episodes
- Crash on background check for new podcast episodes
- Podcast: clear html tags in title and description
- First podcasts update after a podcast has been deleted lead to crash
- From cache removed songs can't be downloaded again 1.0.8 02/17/2022 Features:
- Offline Mode
- Ampache directory view support
- Subsonic legacy login selectable at login
- Fetch latests Songs/Albums/Artists via pull down
- Library can be filtered for recently added entries
- Player has an increased playtime slider touch area for thumb

Bug Fixes:
- iOS 12.X crashes due to dependency issues
- Http status check leads to login denial
- Background crash due to failed podcasts update
- Login failed if root server website requires http basic authentication 1.0.7 10/28/2021 Features
- Added podcast support
- Background fetch updates podcast episodes
- User gets informed about new podcast episodes via notifications
- Displaying errors and infos in a banner
- Seeking is support via LockScreen player
- Tab on artist or song title in popup player navigate to detail views
- Artwork downloads are performed immediately and will be updated
- Elapsed and remaining time of player is updated on time slider movement
- Info box informs about synchronization and notifications
- Request playlist with 100 random songs
- Update account password possible

BugFixes
- All error events are saved in event log
- Remote deleted Playlists and Podcasts are deleted after sync too 1.0.6 09/02/2021 Features
- Added genre support
- Added directory support (Subsonic only)
- Full online sync (playlist interactions)
- Display playlists/albums play duration
- Improve initial library synchronisation performance
- Displaying API and other errors in alerts
- Display info if mime type of song is not playable
- Added support category to settings
- Added autoCachePlayedSong option to settings
- Added "send developer report" with detail information to settings
- Api can be selected manually at login

Changes
- Removed latest songs from library
- Display failed downloads
- Artist detail displays albums sorted by year
- Artist detail displays albums that contain songs of artist
- Songs are only displayed via search under library songs
- Hide search keyboard on song drag

BugFixes
- Crash due to invalid sized attribute values
- Player stops instead of replay a song
- Show artist/album detail even if not available
- Artworks are not correctly assigned (Subsonic) 1.0.5 06/10/2021 New player features:
- Large and compact display style with transition animation
- Background color is animated
- Songs are grouped in previous and next songs
- Predownload the next three songs
- Directly start playback via stream

New other features:
- DefaultArtwork: Use mosaic as default artwork
- Ampache: Smart playlists are supported
- Subsonic: Authentication via token is default auth method
- Subsonic: Improve initial fetch performance
- Settings: Button to report issues added
- Library: Elements are fetched asynchronous
- Library: Additional information is displayed
- Library: Showing spinner during data fetch
- Settings: Display server and client API version
- Sync: Screen will be kept alive during sync
- ActionOnSongTab: "Insert as next song to play" added
- Downloads: Grouping by status

Bug fixes:
- Player: Wrong song is played if songs are reordered or deleted
- Song cell: Artist label is always blue
- Song download failed: Race condition during multiple song download
- Amperfy crashed at App reset if a song download was triggered
- Player: remove identical song from player playlist causes next song to play 1.0.4 04/19/2021 New Features:
- Song: blue artist name indicates cached song
- Artists: adding search bar
- Albums: adding search bar
- Songs: adding search bar
- Playlists: adding search bar
- Search: playlists are searchable too
- iPad: Optimize views for bigger screens
- Settings: display app version, build number, server url, username and backend API
- Navigate from songs to their artist and album
- The action performed on a song tab is configurable
- Detailed error messages at login failure

Bug fixes:
- Syncing: fix progress bar length
- Login: login form has correct background color 1.0.3 02/25/2021 1.0.2 02/09/2021