Simple music player



Music is available as Flatpak:

/!\ Your host system needs to have at least Tracker 3.0 available for Music to run as flatpak.

Installing stable builds

$ flatpak remote-add --from flathub
$ flatpak install flathub org.gnome.Music

Installing nightly (unstable) builds

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


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, set the G_MESSAGES_DEBUG environment variable:

$ G_MESSAGES_DEBUG=org.gnome.Music gnome-music

Available content

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

XDG_MUSIC_DIR directory can be changed:

$ xdg-user-dirs-update --set MUSIC /path/to/music/collection

Then, Tracker needs to index this new directory:

$ tracker3 index -ar /path/to/music/collection

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.

Available metadata

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

$ tracker3 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 available id3v2 editors

Tracker cheatsheet

  • Check your indexed files:

$ tracker3 status
  • Index Music folder:

$ tracker3 index -ar ~/Music
  • Look for your indexed albums:

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

$ tracker3 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 2021-06-11 10:16:18 by JeanFelder)