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 ]


    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

  4. Working great for me – testing on NC 19 and Android 7. This really will help people move away from corporate ecosystems. Thank you so much for this and all of your great guides, this is not the first time I’ve come here after searching for solutions 🙂

  5. Hey guys,

    unfortunately the connection does not work for me. On my Nextcloud (version 20) I have installed Music. Via web browser I can log in with the user “me” and my NC password and there I get to the music app.

    In the settings I created the password token like in the HowTo and installed Power Ampache from F-Droid.

    In Nextcloud -> Music -> Settings you find the URL:


    In the Toturial:


    I tried both, With the user “me” and the password token. On the mobile phone I get the error: “Something has gone wrong, try again”

    Where could the mistake lie?

    with best

    Translated with (free version)

  6. Hey guys,

    I have found that Power Ampache no longer works when I update Nextcloud (19 -> 20). The login then reports: Something has gone wrong.

    with best

    1. Nextcloud 20 had a bug which broke the Ampache support of the Music app. This has now been fixed in the Nextcloud version 20.0.5 and the Ampache API of the Music app works again.

  7. I tried DSUB and it didn’t work but I think it has something to do with an issue with LineageOS.
    Ultrasonic does work though and has been recently been updated.
    Alot of the Ampache and Subsonic player/clients on Fdroid seem to have not been updated for a while, years in some cases. I have been slowly working my way through them.

  8. Everything is working fine so far, except that I don’t see any Artists. I’ve tried both ID3 tags, Artist and Album Artist, but none of them appears in the app. What am I doing wrong?

  9. For me, Power Ampache doesn’t play files. It shows them, but just doesn’t play them.
    But Subsonic Music Streamer (available via regular Play Store) works very fine with Nextclouds Music App. 🙂

Leave a Reply

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