org.gnome.Music.png

Music

Simple music player

Contents

  1. Installing
    1. Flatpak
      1. Installing stable builds
      2. Installing nightly (unstable) builds
    2. Packages
    3. Building from source
  2. Getting help
    1. Getting logs
    2. Available content
    3. Metadata cache
    4. Available metadata
    5. Tracker cheatsheet
  3. Getting in touch
  4. Bug reporting
  5. Contributing
    1. Programming

Installing

Flatpak

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 https://flathub.org/repo/flathub.flatpakrepo
$ flatpak install flathub org.gnome.Music

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

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, 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:

Contributing

Creating or improving:

Programming

Contribute code to fix existing bugs:

Apps/Music/Resources (last edited 2021-06-11 10:16:18 by JeanFelder)