codecopy / amperfy

Amperfy is an iOS app to play songs from an Ampache or Subsonic server

Amperfy

Basics

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

   

Features

• Offline support
• Syncing the database after first login
• Update library via search API
• Player interaction from lock screen
• Remote controlable
• Dark mode support

Requirements

• Xcode 12, swift 5
• Carthage

Getting Started

1. Check out the latest version of the project:

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

2. In the Amperfy directory, fetch and build the projects dependencies via Carthage:

cd amperfy
./update-carthage.sh

3. Open the Amperfy.xcodeproj file.

4. Build and run the "Amperfy" scheme

Real device testing: Amperfy has Apple CarPlay support. To test it on a real device a developer certificate with granted access to com.apple.developer.playable-content is requiered. To test Amperfy without Apple CarPlay clear the entitlement signing entry under Amperfy -> Targets: Amperfy -> Build Settings -> Signing -> Code Signing Entitlements (clear Amperfy/Entitlements.plist)

Beta test releases

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

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
• PromiseKit by Max Howell is licensed under MIT License
• PMKAlamofire by Max Howell is licensed under MIT License
• Font Awesome by Font Awesome is licensed under Font Awesome Free License
• iOS 11 Glyphs by Icons8 is licensed under Good Boy License

Amperfy license: GPLv3