Simple music player



Music is available via Flatpak:

Installing nightly builds

$ flatpak remote-add --from gnome-nightly
$ flatpak remote-add --from gnome-apps-nightly
$ flatpak install gnome-apps-nightly org.gnome.Music


Your software distribution may offer you packages for Music:

Building from source

Download tarballs of latest stable release.

Alternatively, clone latest development code using git:

git clone

See file for futher instructions.

Getting help

Getting logs

To see detailed info on Music execution run it with -d

$ gnome-music -d

Avaliable content

Music plays content from the XDG_MUSIC_DIR directory. It queries Tracker for relevant content in this location.

Metadata cache

Music uses Tracker to harvest and cache metadata about the content coming from the above sources. It uses SPARQL as the query language, and the tracker command can be used to control and interface with the Tracker services. Tracker's manual for application developers covers SPARQL extensively.

Avaliable metadata

For local content, check the metadata of the file extracted by Tracker:

$ tracker info song.mp3

Music needs at least album-artist, song name, and album name to use the file. You need to use an id3v2 tag editor to add/edit that info. See avaliable id3v2 editors

Tracker cheatsheet

  • Check your indexed files:

$ tracker status
  • Index Music folder:

$ tracker index --file ~/Music
  • Look for your indexed albums:

$ tracker search --music-albums
  • See tracker detecting changes on metadata

$ tracker daemon -w

Getting in touch

Talk with our user and developer community via our:

Bug reporting

Test Music and its development version and report bugs:


Creating or improving:


Contribute code to fix existing bugs:

Apps/Music/Resources (last edited 2018-03-21 07:49:06 by MarinusSchraal)