android, FOSS, nextcloud

Stream you music with Nextcloud Music and Power Ampache

This is a little guide on how to stream music from your Nextcloud instance to a computer or Android phone.

Currently there are two different music apps available in Nextcloud, and both support playing music from our browser

Of the two, I recommend Nextcloud Music because it also provides an Ampache backend, but I will provide more detail about the two in the last section.

Ampache is a music server written in PHP with a web interface frontend so that we can stream music to our browser. It has been around since 2001, so there are a lot of supported clients that are able to access our music through the Ampache backend, such as VLC, Kodi, Plex, Amarok and others.

Instead of actually  installing an Ampache server, we can use the Ampache API that the Music app exposes to connect to those clients. In order to stream to our phone, we will use Power Ampache for Android.

Step 1

Install the Music app from your Apps panel. Then, open the app and scan your music folder, which can take several minutes for large collections. After this you will be able to stream to any computer.


Step 2

In the Music app, name and generate a token for the Ampache backend.


Copy the password somewhere because there will be no way to retrieve it if you navigate away. We will use this password to access from our Android phone.

Step 3

Install Power Ampache from F-Droid. Like everything else in F-Droid, this is a free and open source app.

Step 4

In the app, login with

  • this URL: <cloud_url>/index.php/apps/music/ampache
  • your Nextcloud username. Not the token name, the nextcloud user name.
  • the token that we copied earlier.

That’s it! Now we can also stream to our phone through the Ampache backend.


Music or Audio Player

When it comes to comparing both apps, we have to say first that both do the job and they are quite similar. I thought that the Audio Player is more usable because you can filter your collection by genre, artist and others which can really help if you have a big collection. You don’t have this option in the Music app, so I opened a feature request for this in their Github page.

Regarding the Music app, it integrates into the Files app, so you can browse your music by folder according to your own folder hierarchy, and a player will pop up. Audio Player does play a song if you click on it from the Files app, but it doesn’t offer reproduction controls so it is not very practical for real use.

The web interface can be quite slow to load for big collections because it loads everything in one long scrollable box in the browser, but nothing too dramatic. The authors mention 50,000 file collection to be about the higher limit the app backend can handle.

The Music app was able to scan my 35,000 file collection, even though it took a bit, whereas the Audio Player failed to recognize more than 250, and threw the following warning (reported on github)

But the bigger deal winner for me was Ampache support. The Audio Player author wants to keep the app simple, and prefers to extend functionality through plugins or combinations of apps. For instance, you can install an  additional app to make Audio Player capable of editing ID3 tags. So far nobody has come forward to provide an Ampache plugin.

I couldn’t even scan 10% of my collection, plus there is no way to stream to my phone, so I decided to stick to Nextcloud Music.

Author: nachoparker

Humbly sharing things that I find useful [ github dockerhub ]

17 Comments on “Stream you music with Nextcloud Music and Power Ampache

    1. Sadly Power Ampache doesn’t works properly in my phone! (doesn’t works at all. It gets stuck)
      I’ll try another ways!
      But Music is installed in my NextCloud instance.

      1. Hi Victor,

        That is unfortunate. There are other Ampache clients in F-Droid. Ampache comes to mind…

        There’s another reader that told me the same thing. Do you have a huge collection? In general I like the app… maybe will be worth it to report this so it can be fixed.

      2. A good alternative on FDroid is the old Just Player with Ampache plugin.

        Bonus, It could stream and accept video, unlike the current Power Ampache, 🙂

  1. tested both apps in another phone and works fine both!
    Finally in my phone installed Amdroid and that works fine.
    Thanks for the tutorial!
    Time to investigate how to play that music from VLC in my laptop! 😉

  2. Hey guys, I’m the developer for Power Ampache, I know I haven’t released any update for a few months, I’ve been very busy with work (unfortunately I need to pay my bills too).
    Please let me know if there’s any bug I can fix or if you have any feature request. Use the “developer email” in the play store or fdroid.
    by the way the app has a filter, check the menu.

    1. Hola Antonio,

      Thanks for your App and for dropping by. It is great to see that the App is not abandoned and keeps going. I have a couple suggestions, and only one issue: if I scroll very fast on my (huge) collection view the App completely hangs, so I have to use the search function. I tried accessing you issue tracker but I got “Permission Denied”.

      Un saludo

  3. Hi,
    thanks for the nice guide.

    I´ve tested creating the token with a non admin account. This doesn´t work. Maybe this what you want do add.

    1. This really shouldn’t be the case. As the developer of the onwCloud/Nextcloud Music app, I’m mostly testing the Ampache API with a non-admin account, and it definitely works for me.

      Do you mean that you can’t create the token or that after creating the token, your Ampache client can’t connect to the server using the token? If you are certain it’s not an “user error”, then maybe you have found a bug and it should be reported to

Leave a Reply to victorhck Cancel reply

Your email address will not be published. Required fields are marked *