{"id":14069829,"url":"https://github.com/BLeeEZ/amperfy","last_synced_at":"2025-07-30T06:33:07.437Z","repository":{"id":39665912,"uuid":"174733460","full_name":"BLeeEZ/amperfy","owner":"BLeeEZ","description":"Amperfy is an iOS/iPadOS/macOS app to play songs from an Ampache or Subsonic server","archived":false,"fork":false,"pushed_at":"2025-07-19T20:07:46.000Z","size":25389,"stargazers_count":897,"open_issues_count":136,"forks_count":58,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-07-19T22:57:57.242Z","etag":null,"topics":["ampache","ios","ipados","macos","music-player","subsonic","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BLeeEZ.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["paypal.me/BLeeEZ25"]}},"created_at":"2019-03-09T18:48:46.000Z","updated_at":"2025-07-19T20:07:51.000Z","dependencies_parsed_at":"2023-02-09T16:45:45.031Z","dependency_job_id":"18ecb7e8-ff91-490d-b864-f6cf02711cd5","html_url":"https://github.com/BLeeEZ/amperfy","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/BLeeEZ/amperfy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BLeeEZ%2Famperfy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BLeeEZ%2Famperfy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BLeeEZ%2Famperfy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BLeeEZ%2Famperfy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BLeeEZ","download_url":"https://codeload.github.com/BLeeEZ/amperfy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BLeeEZ%2Famperfy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267822922,"owners_count":24149721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ampache","ios","ipados","macos","music-player","subsonic","swift"],"created_at":"2024-08-13T07:07:16.383Z","updated_at":"2025-07-30T06:33:07.417Z","avatar_url":"https://github.com/BLeeEZ.png","language":"Swift","readme":"# ![Logo](https://github.com/BLeeEZ/amperfy/blob/master/AmperfyKit/Assets/Assets.xcassets/AppIcon.appiconset/Icon-40.png) Amperfy\n\n## Basics\n\nAmperfy is an iOS/iPadOS/macOS app written in Swift to interact with an [Ampache](http://ampache.github.io) or [Subsonic](http://www.subsonic.org) server.\n\n### iOS\n\n\u003ca href=\"https://apps.apple.com/app/amperfy-music/id1530145038#?platform=iphone\"\u003e\n  \u003cimg src=\".github/AppStore/Download_on_the_App_Store_Badge_US-UK_RGB_blk_092917.svg\" height=\"45\" /\u003e\n\u003c/a\u003e\n\n\u003cimg src=\".github/Screenshots/Player.jpg\" width=\"250\" alt=\"Screenshot of the Amperfy player\" /\u003e \u0026nbsp;\n\u003cimg src=\".github/Screenshots/AlbumDetail.jpg\" width=\"250\" alt=\"Screenshot of the Amperfy artist detail view\" /\u003e \u0026nbsp;\n\u003cimg src=\".github/Screenshots/Library.jpg\" width=\"250\" alt=\"Screenshot of the Amperfy library view\" /\u003e\n\n### macOS\n\n\u003ca href=\"https://apps.apple.com/app/amperfy-music/id1530145038#?platform=mac\"\u003e\n  \u003cimg src=\".github/AppStore/Download_on_the_Mac_App_Store_Badge_US-UK_RGB_blk_092917.svg\" height=\"45\" /\u003e\n\u003c/a\u003e\n\n\u003cimg src=\".github/Screenshots/macOS-Playlist.png\" width=\"750\" alt=\"Screenshot of the Amperfy playlist view in macOS\" /\u003e\n\n## Features\n\n- Offline support\n- Support for music and podcasts\n- CarPlay support\n- Equalizer\n- Replay gain\n- Syncing the database after first login\n- Update library in background\n- Siri voice commands: \"play \\\u003cexample artist\\\u003e\"\n- Siri shortcuts: play id, search and play\n- Player interaction from lock screen\n- Sleep timer\n- Adjustable playback rate\n- Home Screen Quick Actions\n- Remote controlable\n- Dark mode support\n\n## Requirements\n\n* Xcode 16, Swift 6\n\n## Getting Started\n\n1. Check out the latest version of the project:\n  ```\n  git clone https://github.com/BLeeEZ/amperfy.git\n  cd amperfy\n  ```\n\n3. Open the `Amperfy.xcodeproj` file.\n\n4. Build and run the \"Amperfy\" scheme\n\n  \u003eReal 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`.\n\n## Beta test releases\n\nFor more information, and to participate in the public beta releases, please visit [Amperfy Beta](https://github.com/BLeeEZ/amperfy/issues/25).\n\n## Contribution\n\nPull requests are always welcome. Please execute `AmperfyKitTests` to ensure code quality. Running tests will trigger [SwiftFormat](https://github.com/nicklockwood/SwiftFormat) to apply the [Google Swift Style Guide](https://google.github.io/swift), as configured by [Google-SwiftFormat-Config](https://github.com/NoemiRozpara/Google-SwiftFormat-Config). You can also apply the code style manually by executing `./BuildTools/applyFormat.sh`.\n\n## Attributions\n\n- [AudioStreaming](https://github.com/dimitris-c/AudioStreaming) by [Dimitris C.](https://github.com/dimitris-c) is licensed under [MIT License](https://github.com/dimitris-c/AudioStreaming/blob/main/LICENSE)\n- [LNPopupController](https://github.com/LeoNatan/LNPopupController) by [LeoNatan](https://github.com/LeoNatan) is licensed under [MIT License](https://github.com/LeoNatan/LNPopupController/blob/master/LICENSE)\n- [MarqueeLabel](https://github.com/cbpowell/MarqueeLabel) by [Charles Powell](https://github.com/cbpowell) is licensed under [MIT License](https://github.com/cbpowell/MarqueeLabel/blob/master/LICENSE)\n- [NotificationBanner](https://github.com/Daltron/NotificationBanner) by [Dalton Hinterscher](https://github.com/Daltron) is licensed under [MIT License](https://github.com/Daltron/NotificationBanner/blob/master/LICENSE)\n- [ID3TagEditor](https://github.com/chicio/ID3TagEditor) by [Fabrizio Duroni](https://github.com/chicio) is licensed under [MIT License](https://github.com/chicio/ID3TagEditor/blob/master/LICENSE.md)\n- [CoreDataMigrationRevised-Example](https://github.com/wibosco/CoreDataMigrationRevised-Example) by [William Boles](https://github.com/wibosco) is licensed under [MIT License](https://github.com/wibosco/CoreDataMigrationRevised-Example/blob/master/LICENSE)\n- [VYPlayIndicator](https://github.com/obrhoff/VYPlayIndicator) by [Dennis Oberhoff](https://github.com/obrhoff) is licensed under [MIT License](https://github.com/obrhoff/VYPlayIndicator/blob/master/LICENSE)\n- [CallbackURLKit](https://github.com/phimage/CallbackURLKit) by [Eric Marchand](https://github.com/phimage) is licensed under [MIT License](https://github.com/phimage/CallbackURLKit/blob/master/LICENSE)\n- [DominantColors](https://github.com/DenDmitriev/DominantColors) by [Den Dmitriev](https://github.com/DenDmitriev) is licensed under [MIT License](https://github.com/DenDmitriev/DominantColors/blob/main/LICENSE)\n- [AudioVisualizerKit](https://github.com/Kyome22/AudioVisualizerKit) by [Takuto NAKAMURA (Kyome)](https://github.com/Kyome22) is licensed under [MIT License](https://github.com/Kyome22/AudioVisualizerKit/blob/main/LICENSE)\n- [Alamofire](https://github.com/Alamofire/Alamofire) by [Alamofire](https://github.com/Alamofire) is licensed under [MIT License](https://github.com/Alamofire/Alamofire/blob/master/LICENSE)\n- [Ifrit](https://github.com/ukushu/Ifrit) by [Andrii Vynnychenko](https://github.com/ukushu) is licensed under [MIT License](https://github.com/ukushu/Ifrit/blob/main/LICENSE.md)\n- [swift-collections](https://github.com/apple/swift-collections) by [Apple](https://github.com/apple) is licensed under [Apache License 2.0](https://github.com/apple/swift-collections/blob/main/LICENSE.txt)\n- [iOS-swiftUI-spotify-equalizer](https://github.com/urvi-k/iOS-swiftUI-spotify-equalizer) by [urvi koladiya](https://github.com/urvi-k) is licensed under [MIT License](https://github.com/urvi-k/iOS-swiftUI-spotify-equalizer/blob/main/LICENSE)\n\n**Amperfy license:** [GPLv3](https://github.com/BLeeEZ/Amperfy/blob/master/LICENSE)\n\n**Special thanks:** [Dirk Hildebrand](https://apps.apple.com/us/developer/dirk-hildebrand/id654444924)\n","funding_links":["paypal.me/BLeeEZ25"],"categories":["Swift"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBLeeEZ%2Famperfy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBLeeEZ%2Famperfy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBLeeEZ%2Famperfy/lists"}