#dbus #mpris

mpris

Idiomatic MPRIS D-Bus interface library

7 releases (4 stable)

Uses old Rust 2015

2.0.0-rc2 Feb 15, 2020
2.0.0-rc1 Feb 6, 2019
1.1.2 Mar 6, 2019
1.1.1 Jan 4, 2019
0.1.0 Dec 28, 2017

#99 in Unix APIs

Download history 79/week @ 2021-02-25 60/week @ 2021-03-04 66/week @ 2021-03-11 64/week @ 2021-03-18 91/week @ 2021-03-25 69/week @ 2021-04-01 83/week @ 2021-04-08 84/week @ 2021-04-15 79/week @ 2021-04-22 91/week @ 2021-04-29 70/week @ 2021-05-06 72/week @ 2021-05-13 66/week @ 2021-05-20 75/week @ 2021-05-27 72/week @ 2021-06-03 83/week @ 2021-06-10

342 downloads per month
Used in 4 crates

Apache-2.0

465KB
9K SLoC

JavaScript 5K SLoC // 0.1% comments Rust 3K SLoC // 0.0% comments Python 1K SLoC // 0.2% comments Shell 49 SLoC // 0.2% comments

mpris

A Rust library for dealing with MPRIS2-compatible players over D-Bus.

Crates.io Documentation Build Status Actively developed

NOTE: Until it is possible to mark a minimum Rust version in the crate manifest, this library is only officially supported for "the latest stable Rust".

What is MPRIS2?

The Media Player Remote Interfacing Specification is a standard D-Bus interface which aims to provide a common programmatic API for controlling media players.

It provides a mechanism for discovery, querying and basic playback control of compliant media players, as well as a tracklist interface which is used to add context to the active media item.

From About, in the MPRIS2 specification.

Basically, you can use it to control media players on your computer. This is most commonly used to build media player applets, UIs or to pause other players before your own software performs some action.

You can also use it in order to query metadata about what is currently playing, or if something is playing.

How to use

extern crate mpris;

use mpris::PlayerFinder;

// Pauses currently playing media and prints metadata information about that
// media.
// If no player is running, exits with an error.
fn main() {
  let player = PlayerFinder::new()
    .expect("Could not connect to D-Bus")
    .find_active()
    .expect("Could not find any player");

  player.pause().expect("Could not pause");

  let metadata = player.get_metadata().expect("Could not get metadata for player");
  println!("{:#?}", metadata);
}

See the examples directory for more examples.

License

Copyright 2017-2018 Magnus Bergmark

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Dependencies

~2MB
~42K SLoC