Playing with D-Bus interface of Spotify for Linux

After a lot of requests from Linux users, Spotify developers have integrated D-Bus support in version So, what this means is simply and awesome! Now Linux developers could use this programmatic interface to interact with Spotify from other apps.

In other words, now is quite simple to send «play», «pause», «move next/previous song» events to Spotify and with this get Spotify fully integrate into our desktop.

I will explain how to introspect D-Bus interface and make some proof-concepts.

Take care that Spotify Linux client now implements to MPRIS2 Dbus support and almost the entire available libraries of D-Bus could interact with it.

So now we play around to “play” with D-Bus API of Spotify. But first of all we have to install one simple package (I’m using Ubuntu Maverick Merkat, take care of your linux distribution and version to find differences).

Now let’s find what is the Spotify D-Bus’s initial interface.

$ mdbus2|grep spotify

So, as you could see there are two interfaces to talk with, but looks like the second one is our desired central point. Let’s introspect it…

$ mdbus2 org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2
[METHOD]    org.mpris.MediaPlayer2.Raise() -> ()
[METHOD]    org.mpris.MediaPlayer2.Quit() -> ()
[PROPERTY] b:CanQuit )
[PROPERTY] b:CanRaise )
[PROPERTY] b:HasTrackList )
[PROPERTY] s:Identity )
[PROPERTY] s:DesktopEntry )
[PROPERTY] as:SupportedUriSchemes )
[PROPERTY] as:SupportedMimeTypes )
[METHOD]    org.mpris.MediaPlayer2.Player.Next() -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.Previous() -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.Pause() -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.PlayPause() -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.Stop() -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.Play() -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.Seek( x:Offset ) -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.SetPosition( o:TrackId, x:Position ) -> ()
[METHOD]    org.mpris.MediaPlayer2.Player.OpenUri( s:none ) -> ()
[SIGNAL]    org.mpris.MediaPlayer2.Player.Seeked( x:Position )
[PROPERTY] s:PlaybackStatus )
[PROPERTY]  org.mpris.MediaPlayer2.Player.readwrite( s:LoopStatus )
[PROPERTY]  org.mpris.MediaPlayer2.Player.readwrite( d:Rate )
[PROPERTY]  org.mpris.MediaPlayer2.Player.readwrite( b:Shuffle )
[PROPERTY] a{sv}:Metadata )
[PROPERTY]  org.mpris.MediaPlayer2.Player.readwrite( d:Volume )
[PROPERTY] x:Position )
[PROPERTY] d:MinimumRate )
[PROPERTY] d:MaximumRate )
[PROPERTY] b:CanGoNext )
[PROPERTY] b:CanGoPrevious )
[PROPERTY] b:CanPlay )
[PROPERTY] b:CanPause )
[PROPERTY] b:CanSeek )
[PROPERTY] b:CanControl )
[METHOD]    org.freedesktop.DBus.Properties.Get( s:interface_name, s:property_name ) -> ( v:value )
[METHOD]    org.freedesktop.DBus.Properties.Set( s:interface_name, s:property_name, v:value ) -> ()
[METHOD]    org.freedesktop.DBus.Properties.GetAll( s:interface_name ) -> ( a{sv}:values )
[METHOD]    org.freedesktop.DBus.Introspectable.Introspect() -> ( s:xml_data )

Interesting, isn’t it? It have a large D-Bus API to send events to Spotify. Among methods to control the playlist, one of my favourites is get MetaData from the playing song.
So now if you want to pause your actual song of Spotify you can issue at your terminal:

dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Pause

The next steps for Ubuntu users is use this API to integrate indicator-sound and get fully integrated Spotify in our system.
I’m looking forward Spotify developers to integrate LibNotify and show track information with desktop notifications.

Happy hacking!


For playing songs from a spotify url just issue the next command:

dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.OpenUri string:spotify:track:6JfGHYsw9LVH5FJMCh66Um

John Reese has created a gorgeous wrapper for integrating Spotify with media keys by taking the above explanations. Check it out


Exists a better way to connect Spotify with GNOME-shell, recently it was published a new extension for integrate Spotify with GNOME.

And according to the Spotify community forum in the coming months it could be a native integration. The Spotify for Linux client changelog says the next line:  “Linux only: Media key support in Gnome. Coming soon!”