Music

Installing

1. Flatpak

Music is available as Flatpak:

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

1.1. Installing stable builds

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

1.2. Installing nightly (unstable) builds

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

2. Packages

Your software distribution may offer you packages for Music:

• Arch Linux: gnome-music

• Debian: gnome-music

• Fedora: gnome-music

• openSUSE: gnome-music

• Ubuntu: gnome-music

3. 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

• Read user documentation offline by selecting Help in application menu

• Read user documentation online

• See also Getting in touch and Bug reporting

1. Getting logs

To see detailed info on Music, set the G_MESSAGES_DEBUG environment variable:

$ G_MESSAGES_DEBUG=org.gnome.Music gnome-music

2. 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

3. 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.

4. 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

5. 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:

• Chat: #gnome-music at irc.gnome.org and Riot

• Discourse forum

Bug reporting

Test Music and its development version and report bugs:

• View and submit issues

Contributing

Creating or improving:

• Design

• Documentation

• Localization

• Packaging: make the latest releases available for your distribution

1. Programming

Contribute code to fix existing bugs:

• Read Newcomers guide to get started

• Browse the source