BLeeEZ/amperfyPublic

NotificationsYou must be signed in to change notification settings
Fork50
Star715

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

License

GPL-3.0 license

715 stars 50 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 884 Commits
.github		.github
Amperfy.xcodeproj		Amperfy.xcodeproj
Amperfy		Amperfy
AmperfyKit		AmperfyKit
AmperfyKitTests		AmperfyKitTests
AppKitIntegration		AppKitIntegration
BuildTools		BuildTools
Design		Design
Helper		Helper
.gitignore		.gitignore
.gitmodules		.gitmodules
.swiftformat		.swiftformat
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md

Repository files navigation

Amperfy

Basics

Amperfy is an iOS/iPadOS/macOS app written in Swift to interact with anAmpache orSubsonic 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 <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

Requirements

Xcode 16, Swift 6

Getting Started

Check out the latest version of the project:

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

Open theAmperfy.xcodeproj file.
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.

Beta test releases

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

Contribution

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.