Crate mpris

mpris

mpris is an idiomatic library for dealing with MPRIS2-compatible media players over D-Bus.

This would mostly apply to the Linux-ecosystem which is a heavy user of D-Bus.

Getting started

Some hints on how to use this library:

1. Look at the examples under examples/.
2. Look at the PlayerFinder struct.

Structs

InvalidLoopStatus

LoopStatus had an invalid string value.

InvalidPlaybackStatus

PlaybackStatus had an invalid string value.

Metadata

A structured representation of the Player metadata.

Player

A MPRIS-compatible player.

PlayerEvents

Iterator that blocks forever until the player has an Event.

PlayerFinder

Used to find Players running on a D-Bus connection.

PlayerIter

An iterator that lazily iterates over all of the found Players. Useful for efficiently searching for a specific player.

Progress

Struct containing information about current progress of a Player.

ProgressTick

Return value of ProgressTracker::tick, which gives details about the latest refresh.

ProgressTracker

Controller for calculating Progress and maintaining a TrackList (if supported) for a given Player.

TrackID

Represents the MPRIS Track_Id type.

TrackList

Represents a MediaPlayer2.TrackList.

Enums

DBusError

Something went wrong when communicating with the D-Bus. This could either be an underlying D-Bus library problem, or that the other side did not conform to the expected protocols.

Event

Represents a change in Player state.

EventError

Errors that can occur while processing event streams.

FindingError

This enum encodes possible error cases that could happen when finding players.

LoopStatus

A Player’s looping status.

MetadataValue

Holds a dynamically-typed metadata value.

MetadataValueKind

PlaybackStatus

The Player’s playback status

ProgressError

Errors that can occur while refreshing progress.

TrackListError

TrackList-related errors.