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

var spotify = AstalMpris.Player.new("spotify")

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

Installation

1. install dependencies

   Arch

   sudo pacman -Syu meson vala valadoc json-glib gobject-introspection gdk-pixbuf2 libsoup3

   Fedora

   sudo dnf install meson vala valadoc json-glib-devel gobject-introspection-devel gdk-pixbuf2-devel libsoup3-devel

   Ubuntu

   sudo apt install meson valac valadoc libjson-glib-dev gobject-introspection libgdk-pixbuf-2.0-dev libsoup-3.0-dev

2. clone repo

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

3. install

   meson setup build
   meson install -C build