Mpris

Library and CLI tool for interacting and monitoring media players exposing an mpris interface through dbus.

An alternative for playerctl that better integrates with astal.

Usage

You can browse the Mpris reference.

CLI

astal-mpris --help

Library

JavaScript

import Mpris from "gi://AstalMpris"

const spotify = Mpris.Player.new("spotify")

if (spotify.available)
    print(spotify.title)

Python

from gi.repository import AstalMpris as Mpris

spotify = Mpris.Player.new("spotify")

if spotify.get_available():
    print(spotify.get_title())

Lua

local Mpris = require("lgi").require("AstalMpris")

local spotify = Mpris.Player.new("spotify")

if spotify.available then
    print(spotify.title)
end

Vala

// Not yet documented

Installation

1. install dependencies

Arch

sudo pacman -Syu meson vala valadoc gvfs json-glib gobject-introspection

Fedora

sudo dnf install meson vala valadoc gvfs json-glib-devel gobject-introspection-devel

Ubuntu

sudo apt install meson valac valadoc gvfs libjson-glib-dev gobject-introspection

2. clone repo

git clone https://github.com/aylur/astal.git
cd astal/lib/mpris

3. install

meson setup --prefix /usr build
meson install -C build

WARNING

In order for network cover art urls to be cached (spotify for example) make sure gvfs is enabled.

configuration.nix

services.gvfs.enable = true;