icefields / Power-Ampache-2

Android Music Streaming App suite in Material You style.
 Connects to Ampache, Nextcloud Music and compatible backends (Ampache API 4 and above).
https://power.ampache.dev
GNU General Public License v3.0
72 stars 5 forks source link
android audio audio-player audio-streaming music music-player nextcloud nextcloud-app nextcloud-apps self-hosted streaming streaming-audio

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)

## Download
Get it on F-Droid Get it on F-Droid Telegram badge
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.

Donate to support the project

Become a patreon Donate - Paypal Donate Bitcoin

# 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
**📱 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, 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. * * * ## Contributing Power Ampache 2 is developed using Clean Architecture on top of MVVM, following SOLID principles.
Contribution guidelines here: https://power.ampache.dev/contributing.html
Before starting any contribution, read the above document and if necessary 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
* * * ## 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 German Spanish French Italian Japanese
Some translations are not complete, since I keep adding new features all the time.
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.