https://gitlab.gnome.org/GNOME/gnome-music/raw/master/data/icons/hicolor/256x256/apps/org.gnome.Music.png

Music

Simple music player


Installing

Flatpak

Music is available as Flatpak:

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

Installing stable builds

$ flatpak remote-add --from flathub https://flathub.org/repo/flathub.flatpakrepo
$ flatpak install flathub org.gnome.Music

Installing nightly (unstable) builds

$ flatpak remote-add --from gnome-nightly https://sdk.gnome.org/gnome-nightly.flatpakrepo
$ flatpak remote-add --from gnome-apps-nightly https://sdk.gnome.org/gnome-apps-nightly.flatpakrepo
$ flatpak install gnome-apps-nightly org.gnome.Music

Packages

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 https://gitlab.gnome.org/GNOME/gnome-music.git

See README.md 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:

Contributing

Creating or improving:

Programming

Contribute code to fix existing bugs:

Apps/Music/Resources (last edited 2018-04-01 08:32:25 by MarinusSchraal)