Repository files navigation

Amperfy is an iOS/iPadOS/macOS app written in Swift to interact with anAmpache orSubsonic server.

• Offline support
• Support for music and podcasts
• CarPlay support
• Syncing the database after first login
• Update library in background
• Siri voice commands: "play <example artist>"
• Siri shortcuts: play id, search and play
• Player interaction from lock screen
• Sleep timer
• Adjustable playback rate
• Home Screen Quick Actions
• Remote controlable
• Dark mode support

• Xcode 16, Swift 6

1. Check out the latest version of the project:

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

3. Open theAmperfy.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 tocom.apple.developer.playable-content andcom.apple.developer.siri is required. To test Amperfy without Apple CarPlay and Siri clear all entries inAmperfy/Amperfy.entitlements.

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

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

• LNPopupController byLeoNatan is licensed underMIT License
• MarqueeLabel byCharles Powell is licensed underMIT License
• NotificationBanner byDalton Hinterscher is licensed underMIT License
• ID3TagEditor byFabrizio Duroni is licensed underMIT License
• CoreDataMigrationRevised-Example byWilliam Boles is licensed underMIT License
• VYPlayIndicator byDennis Oberhoff is licensed underMIT License
• CallbackURLKit byEric Marchand is licensed underMIT License
• Alamofire byAlamofire is licensed underMIT License
• Ifrit byAndrii Vynnychenko is licensed underMIT License
• swift-collections byApple is licensed underApache License 2.0

Amperfy license:GPLv3

Special thanks:Dirk Hildebrand