A beautiful, feature-rich music player.

Listen more, Discover more, Relax more

View project on GitHub

Using Multiple Players

RompЯ supports using multiple players, which can be on different computers. You could have one in each room of your house to create a multi-room audio setup.

All the players can be used simultaneously, but they will not play in sync. The idea is that a person in one room can use one player and a person in another room can use a different player. All the players share the same Music Collection so Playcounts, Podcasts, Tags, Ratings, etc are shared across all of them.

Multiroom Audio

If you want to have multiroom audio with all rooms playing the same music, in sync, then RompЯ has full support for controlling Snapcast

Defining Players

You can add new players from the configuration menu. This opens a dialog box.

Click the + icon to add a new player.

The Name can be anything that is meaningful to you.

Remember that ‘localhost’ in a player definition means ‘the computer running the web server’.

If you’re using players that are on different computers from the web server you should also read this guide.

Selecting Players

To select a player to use, just select it in the Configuration menu and that browser will use it whenever you open RompЯ.

On the Phone and Tablet skins, you can also select players from the Volume Control dropdown

When switching players you will be given the option to transfer your Play Queue to the new Player. Selecting ‘Yes’ will do this and playback will continue from the point where it left off.

You can also choose a player by adding a ‘currenthost’ parameter to the URL, eg


this permits you to store a bookmark for each player you use, or add an icon for each player to the home screen of your phone, for instance.


  • Do NOT try to control multiple players from multiple tabs in the same browser. I cannot stop this or detect it and it WILL result in data corruption.
  • If you’re logged in to Last.FM, the same Last.FM user is used across all Players.

Local Music Databases

If you’re using local music, all players must have the same music files stored in the same directory path. The easiest way is to put your music on a network share somewhere.

With MPD

MPD has a ‘satellite’ players feature that you can use for this purpose. See the MPD documentation.

With Mopidy

With Mopidy, one solution to this is to use mopidy-local-sqlite and put the database on a network share where all the players can access it. However this can be very slow to load when you start Mopidy.

Another is to use mopidy-beets instead, with one centralised Beets server.

However, the best solution is to use ‘Remote’ Mode on all but one of your Players. This relies on you having Mopidy’s ‘file’ backend installed, which is enabled by default in all recent versions of Mopidy. The file backend does not require Mopidy’s local music database, so it can be used to add local music.

Using Remote Mode

Decide on one Player to be your main Player. This will be the one on which you Update your Music Collection. The local files database can be stored locally on this Player, the others do not need to have access to it. You will not be allowed to update the Music Collection when using any of the Remote Players.

Then enable the ‘REMOTE’ option on all your other Players, as in the screenshot above.

You must also set the path to your local music files as described for Album Art.

Now when you add a local track to one of your Remote Players, Rompr will automatically use the file backend instead of the local backend. All of Rompr’s other functions - including Playcounts, Tagging, and Rating - will continue to work as normal.

Suggested Setup

All that was rather complicated, so here’s an example setup.

  • One computer in room 1, running Mopidy and RompЯ.
    • Music is stored on an external USB drive which is mounted on /media/USBDrive.
    • /media/USBDrive is shared on the network
  • Another computer in room 2, running Mopidy
    • The shared /media/USBDrive from above is mounted on /media/USBDrive
    • This Player is configured as a Remote
  • All Mopidys must have the same backends installed and configured.

With this configuration, all your data is kept in sync and all Players can play all your music. Further players can simply copy room 2.

Using Different Player Types


There is now some support for mixing Mopidy and MPD. You can have some players as MPD and some as Mopidy but there are several caveats:

  • You can only update your Music Collection when you are using the same type of player that was used to create it.
  • You must be using Mopidy’s ‘local’ (or ‘local-sqlite’) backend for your local files. Using ‘file’ is not supported.
  • Obviously, attempting to add tracks from spotify, gmusic, etc to MPD will not work.
  • Transferring the Play Queue between players will work, but only if all tracks are local or streams. If the Play Queue contains tracks that cannot be played by MPD and you switch to MPD, the results will be unpredictable.
  • Any MPD players will need to keep their local music database updated. If you use a Mopidy Player to create your Music Collection (and you should), then you will need to use another MPD client for this (for example, Sonata).
  • All players must have their local tracks mounted on the same path, as described above.
  • Adding tracks to stored MPD playlists is not supported in this configuration
  • The Tags and Ratings panel will currently not work correctly if you are using a different type of Player than the one that is used to create your Music Collection

Supported Features

  • Playback of local files on all players
  • Playback of Podcasts and Radio Stations on all players
  • Transfer of local files, radio stations, and podcasts when switching players
  • Tagging, Rating, and Playcounts shared across all players
  • Personalised Radio (only for local files when using MPD)