Amperfy

Basics

Amperfy is an iOS/iPadOS/macOS app written in Swift to interact with an Ampache or Subsonic server.

iOS

<a href="https://apps.apple.com/app/amperfy-music/id1530145038#?platform=iphone"> <img src=".github/AppStore/Download_on_the_App_Store_Badge_US-UK_RGB_blk_092917.svg" height="45" /> </a>

<img src=".github/Screenshots/Player.jpg" width="250" alt="Screenshot of the Amperfy player" />   <img src=".github/Screenshots/AlbumDetail.jpg" width="250" alt="Screenshot of the Amperfy artist detail view" />   <img src=".github/Screenshots/Library.jpg" width="250" alt="Screenshot of the Amperfy library view" />

macOS

<a href="https://apps.apple.com/app/amperfy-music/id1530145038#?platform=mac"> <img src=".github/AppStore/Download_on_the_Mac_App_Store_Badge_US-UK_RGB_blk_092917.svg" height="45" /> </a> <img src=".github/Screenshots/macOS-Playlist.png" width="750" alt="Screenshot of the Amperfy playlist view in macOS" />

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

Requirements

• Xcode 26, Swift 6

Getting Started

1. Check out the latest version of the project:

git clone https://github.com/BLeeEZ/amperfy.git
cd amperfy

3. Open the Amperfy.xcodeproj file.

4. Build and run the "Amperfy" scheme

Real device testing: Amperfy has Apple CarPlay and Siri support. To test it on a real device a developer certificate with granted access to com.apple.developer.playable-content and com.apple.developer.siri is required. To test Amperfy without Apple CarPlay and Siri clear all entries in Amperfy/Amperfy.entitlements.

Beta test releases

For more information, and to participate in the public beta releases, please visit Amperfy Beta.

Contribution

Pull requests are always welcome. Please execute AmperfyKitTests to ensure code quality. Running tests will trigger SwiftFormat to apply the Google Swift Style Guide, as configured by Google-SwiftFormat-Config. You can also apply the code style manually by executing ./BuildTools/applyFormat.sh.

Attributions

• AudioStreaming by Dimitris C. is licensed under MIT License
• MarqueeLabel by Charles Powell is licensed under MIT License
• NotificationBanner by Dalton Hinterscher is licensed under MIT License
• ID3TagEditor by Fabrizio Duroni is licensed under MIT License
• CoreDataMigrationRevised-Example by William Boles is licensed under MIT License
• VYPlayIndicator by Dennis Oberhoff is licensed under MIT License
• CallbackURLKit by Eric Marchand is licensed under MIT License
• DominantColors by Den Dmitriev is licensed under MIT License
• AudioVisualizerKit by Takuto NAKAMURA (Kyome) is licensed under MIT License
• Alamofire by Alamofire is licensed under MIT License
• Ifrit by Andrii Vynnychenko is licensed under MIT License
• swift-collections by Apple is licensed under Apache License 2.0
• iOS-swiftUI-spotify-equalizer by urvi koladiya is licensed under MIT License

Amperfy license: GPLv3

Special thanks: Dirk Hildebrand