joshuarli/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
• Support for music and podcasts
• CarPlay support
• Syncing the database after first login
• Update library in background
• Siri voice commands: "play <example artist> in Amperfy"
• Siri shortcuts: play id, search and play
• Player interaction from lock screen
• Sleep timer
• Adjustable playback rate
• Remote controlable
• Dark mode support

Requirements

• Xcode 12, swift 5

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

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

Special thanks: Dirk Hildebrand