Turntable

Scrobble your music

Keep track of your listening habits by scrobbling them to last.fm, ListenBrainz, Libre.fm and Maloja at the same time using your favorite music app's, favorite music app! Turntable comes with a highly customizable and sleek design that displays information about the currently playing song and allows you to control your music player, allowlist it for scrobbling and manage your scrobbling accounts. All MPRIS-enabled apps are supported.

Not interested in the GUI but still want to scrobble your MPRIS-enabled players? Turntable comes with a CLI, allowing you to scrobble in the background! Try it out using flatpak run dev.geopjr.Turntable --help.

Install

Official

Release

From Source

Dependencies

Package Name	Required
meson	✅
valac	✅
libadwaita-1.0-dev	✅
libsecret-1-dev	❌
libjson-glib-dev	❌
libsoup3.0-dev	❌

Scrobbling

Scrobbling will only be enabled if last.fm tokens are provided. The optional deps are only required then. Read meson_options.txt on how to generate one. Please avoid using the official debug or release tokens.

Makefile

$ make
$ make install

GNOME Builder

• Clone
• Open in GNOME Builder

FaQ

• XYZ player is missing controls

• Most likely MPRIS doesn't give us enough info about whether the player supports it or is inaccurate.

• What's MBID?

• MusicBrainz is, among other things, a big database for song metadata. Enabling the option on Turntable, will check if the song to-be scrobbled exists and will fix its metadata.

• When does a scrobble get sent?

• A song will be scrobbled either when it hits 4 minutes of playtime or half the playtime, whichever one comes first. Playtime does not count while the song is not playing.

• What if I have multiple Turntable windows open?

• Turntable was built with multiple windows open in mind. The scrobbling manager will make sure to filter out requests so only 1 instance of an MPRIS client will be counted.

• CLI can't find any accounts

• Use the GUI to set them up. They require validation and callbacks which the GUI can handle.

• Flatpak can't access my player's cover

• Due to the way the sandbox works, Turntable has to get access to its files. Please open an issue or give the flatpak access to your host filesystem.

Sponsors

Contributing

1. Read the Code of Conduct
2. Fork it ( https://codeberg.org/GeopJr/Turntable/fork )
3. Create your feature branch (git checkout -b my-new-feature)
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create a new Pull Request