Tool for scraping the song data from MPRIS enabled media players under Linux for use in streaming applications like OBS.
Branch: master
Clone or download
Latest commit c255628 Oct 7, 2018


Tool for scraping the song data from MPRIS enabled media players under Linux for use in streaming applications like OBS.

Requires qdbus and ImageMagick to run. Supports any MPRIS enabled media player.

WIP! There are a few bugs, and it is not entirely finished.

Outputs the song title, artist, and album data, as well as the album art to the 'Output' subdirectory. If no album art is found, a generic one is substituted in. The album art is always converted to a 500x500px AlbumArt.jpg so as to keep your OBS scene composition uniform between data updates.


./ <player>

Keep in mind that you must have your player of choice running or the script will produce errors.


./ pithos
./ audacious
./ clementine
./ vlc
./ NuvolaAppSpotify

The script will remember the last player specified, so it can be run without having to specify the player each time.



Determines whether or not the song data is saved as multiple individual files, or in a single line in a single file. Default is "false". This value is stored.


Sets the formatting used for when ONELINE is set to 'true'. If set via command line, formatting MUST be enclosed in single quotes. Valid parameters are $t (title), $a (artist), and $i (album), and can be seperated via spaces, other letters and/or symbols. Default is ' $a: $t - $i '. This value is stored.


Determines whether or not the song data is displayed in the terminal window. Defaults to "true". This value is stored.

OUTPUT_DIR=<Desired directory>

Sets the folder where song data gets saved. Default is the "Output" subdirectory. This value is stored.


When "true", the files generated by the script will be removed on exit. This value is stored.


VERBOSE=true ./
VERBOSE=true ./ pithos
VERBOSE=false OUTPUT_DIR=Output2 ./
OUTPUT_DIR=OtherOutput ./
VERBOSE=true ONELINE=true ./
VERBOSE=true ONELINE=true ONELINER_FORMAT=' $t - $a - $i ' ./
RM_OUTPUT=true ./

A utility is included which will list the available players' arguments, so you don't have to guess. It can also be paired with the 'watch -t' command to give a real(ish)-time update, so as to avoid having to rerun the utility each time a new media player is started.


watch -t ./

Setting up OBS:

In OBS, add the necessary text and/or image sources, and point them to their respective files in the 'Output' subdirectory. OBS will automatically reload the sources each time updates them.


If you would like to contribute, please feel free to fork the project on GitHub.

Found a bug? Have a suggestion?

If you find a bug, something is broken, or you want to suggest a new feature or improvement, you can post it either here:

or here, in the 'bugs' or 'suggestions' room, respectively: