Amperfy" class="reference-link"> Amperfy

Basics

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

iOS

macOS

Features

• Offline support
• Support for music and podcasts
• CarPlay support
• Syncing the database after first login
• Update library in background
• Siri voice commands: “play \“
• 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

Requirements

• Xcode 16, Swift 6

Getting Started

1. Check out the latest version of the project:

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

2. Open the Amperfy.xcodeproj file.

3. 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

• LNPopupController by LeoNatan 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
• 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

Amperfy license: GPLv3

Special thanks: Dirk Hildebrand