10 releases (6 stable)

2.0.1 Jun 15, 2023
2.0.0 Nov 15, 2022
2.0.0-rc3 Sep 12, 2022
2.0.0-rc2 Feb 15, 2020
0.1.0 Dec 28, 2017

#62 in Unix APIs

Download history 287/week @ 2023-11-20 250/week @ 2023-11-27 194/week @ 2023-12-04 236/week @ 2023-12-11 270/week @ 2023-12-18 213/week @ 2023-12-25 235/week @ 2024-01-01 353/week @ 2024-01-08 258/week @ 2024-01-15 243/week @ 2024-01-22 258/week @ 2024-01-29 352/week @ 2024-02-05 376/week @ 2024-02-12 392/week @ 2024-02-19 358/week @ 2024-02-26 349/week @ 2024-03-04

1,550 downloads per month
Used in 15 crates

Apache-2.0

485KB
10K SLoC

JavaScript 5.5K SLoC // 0.1% comments Rust 3K SLoC // 0.0% comments Python 1K SLoC // 0.2% comments Shell 50 SLoC // 0.2% comments

mpris

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

Crates.io Documentation Build Status Actively developed

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

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-2022 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

~7MB
~148K SLoC