Power Ampache 2



GitHub Version GitHub last commit
Telegram

Android music client for Ampache

Power Ampache 2 is a complete Android Music Streaming App suite, presented in Material You style.
Connects to Ampache, Nextcloud Music and compatible backends. (Ampache API 4 and above).

Telegram badge Mastodon badge GPLv3 badge
[//]: #![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/7614a6a7-898b-4a8c-b891-9a07505529be) # Screenshots (Dark, Light and MaterialYou) | | | | | | ----------- | ----------- | ----------- | ----------- | | **Home Screen** | | **Music Player pull-up view** | **Powerful Offline-Mode** | | ![dark_home1](https://github.com/icefields/Power-Ampache-2/assets/149625124/405579fd-617d-4d55-b7fa-20b457dcd373) | ![light_home2](https://github.com/icefields/Power-Ampache-2/assets/149625124/1e4da7c5-a659-4363-ad7f-7907d21952fe) | ![photo_2024-04-03_09-55-06](https://github.com/icefields/Power-Ampache-2/assets/149625124/ccc13c17-3bde-4b27-8510-d98284b6ee65) | ![light_home_offline](https://github.com/icefields/Power-Ampache-2/assets/149625124/8f3e991c-3752-48f3-adc2-cd6e9c91ea4c) | | | | | | | **Artist view, with info and discography** | **Single Album view, with info and songs** | | **Advanced Search** | | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/de081122-23db-4ef7-810f-95fe925dcc29") | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/b435281f-8f59-4b6a-927f-9e4a43999123) | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/ccee4cfd-c21d-421f-bce9-0b5efc4f7c33) | ![light_search](https://github.com/icefields/Power-Ampache-2/assets/149625124/0f687f40-37ce-4852-92ab-9153dcb2b707) | | | | | | | **Album Screen** | **Albums from collection** | **Artists** | | | ![photo_2024-04-03_09-55-26](https://github.com/icefields/Power-Ampache-2/assets/149625124/b169d991-cdb0-4bef-b1c4-2ac7abd9dbba) | ![dark_library_albums](https://github.com/icefields/Power-Ampache-2/assets/149625124/6b70e21e-58f4-4572-8038-c3a4f65e8613) | ![dark_library_artists](https://github.com/icefields/Power-Ampache-2/assets/149625124/ce2ef9d0-e484-48e2-a4b5-46a362fa014f) | ![dark_genre](https://github.com/icefields/Power-Ampache-2/assets/149625124/09d7a6d3-632c-471e-b017-20fc66bf487e) | | | | | | | **Queue from bottom drawer** | **Lyrics** |**Edit Queue, Playlists. Remove/Add Playlists** | | | ![photo_2024-04-03_09-55-16](https://github.com/icefields/Power-Ampache-2/assets/149625124/e291aadc-ccb4-4e80-9011-348ccfcacd64) | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/3c8693f1-6ceb-43ed-b231-eebbbe557315) | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/a33fbe04-375e-419a-a9b7-10587dc897eb) | ![light_genres](https://github.com/icefields/Power-Ampache-2/assets/149625124/be943ba3-8e9f-4857-87c6-69c1fef0ba85) | | | | | | | **Playlists**| **Notification with player controls** | **Notification on lock screen**| | | ![light_library_playlists](https://github.com/icefields/Power-Ampache-2/assets/149625124/db68dd56-5a09-46d0-9c12-4d6f099ef440) | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/cf66b7f9-634d-4245-b187-6b0f08171829) | ![image](https://github.com/icefields/Power-Ampache-2/assets/149625124/4527632c-e1ec-4147-964c-43317e984e26) | ![dark_queue](https://github.com/icefields/Power-Ampache-2/assets/149625124/75242864-0e19-413b-8936-71afad0db614) | | | | | | ## Features Feature rich music client for Ampache, Nextcloud Music and compatible backends, provides all the features found in other mainstream music player (such as Spotify, Youtube Music, Apple Music and so on) and more, like "actually" downloading and exporting music files, lyrics, multiaccount. Plus no ads, no tracking, no bloatware. - MaterialYou Themes, the colour of the app will automatically match the colour scheme of your device, alternatively choose or create your own theme. - Unique generated playlists (smartlists) - Dark & light mode with adaptive interface colors - Fade out/in on pause/resume/next/previous - Media keys support - Every Bluetooth functionality is avaibable in the app. - Song notifications with play controls. Also on lock screen. - Album, Artist, Songs collections - Advanced search - Offline mode - Create, edit, share your playlists
## Contributing Power Ampache 2 is developed using Clean Architecture on top of MVVM, following SOLID principles.
***A complete contribution readme coming soon***. In the meantime, before starting any contribution, please contact me for an overview of the design patterns, code style and libraries used. **What I'm working on right now and what's next** - [x] Improve Notifications Screen - [x] Multi-account - [ ] UI for Tablets - [x] bulk-delete downloaded songs - [x] playlist edit dran and drop - [ ] Android TV version - [ ] Android widget - [ ] implement share with app scheme - [ ] Android Auto
**📱 CONNECT TO AMPACHE MUSIC SERVERS** With Power Ampache 2, you can effortlessly connect to Ampache servers and freely listen to music, without any tracker or ads. You can even download the music you want for offline use, or share with friends. **🚀 LIGHTNING-FAST AND LIGHTWEIGHT:** Despite its powerful features, Power Ampache 2 boasts a remarkable performance, making it quick and easy to listen music at full quality (FLAC support coming soon), create your own playlists (public or private) and queue. Experience speed and efficiency while enjoying your favourite music. **🔐 ENHANCED PRIVACY:** Your data is not collected and sold, there are no ads in the app. **🔍 EFFICIENT SONG SEARCH:** Power Ampache 2 provides a quick and efficient search for finding songs/albums/artists/playlists. Find what you need, when you need it. **🌈 MODERN DESIGN & USER-FRIENDLY INTERFACE:** Enjoy a clean, modern design with a user-friendly interface. The app features a material3 design, MaterialYou and other themes, providing a visually appealing and comfortable user experience. **🌐 OPEN-SOURCE TRANSPARENCY:** Power Ampache app is completely free of ads and does not request unnecessary permissions. Moreover, it is fully open-source, providing you with peace of mind, as you have access to the source code for security and privacy audits. ## PlayStore version coming soon [Get it on GitHub](https://github.com/icefields/Power-Ampache-2/releases) [Get it on Telegram Channel](https://t.me/powerampache) [Get it on F-Droid](https://f-droid.org/packages/luci.sixsixsix.powerampache2.fdroid/) F-Droid releases can not upgrade to other releases and it is compiled, signed and distributed uniformly by [F-Droid](https://f-droid.org/docs/FAQ_-_General/). Github, PlayStore and Telegram releases are signed by me. * * * ## Demo You can select a demo instance from the login screen or login into your own server. * * * ## Translations The app is currently translated in the following languages: English Czech Work in progress: French Italian Japanese
In the future I will automate translation contributions, right now you have 3 options.
- If you're an Android developer just create the resource directories and files and open a PR (`strings.xml` is where translatable strings are located). - If you're not familiar with Android development and don't know how to create translation resources, but you are able to edit XML files: you can just grab `strings.xml`, edit it and send it back to me. I'll review it and will include it in the app in the next release. Example (italian translation): - If you're not familiar with Android development and also not sure how to edit xml files, just send me a text document with the translations and I will take care of it. * * * ## Ending Note - Consider giving the repo a ⭐ if you liked the project! - Consider sponsoring me to help me build more projects like this.