blob: 6bbe17e0a1bcb3f9d578b32afb8397fa17bbbcce (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
# Media Player Remote Interfacing Specification
The Media Player Remote Interfacing Specification (MPRIS) 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.
## View the specification
The specification can be [[viewed online|http://specifications.freedesktop.org/mpris-spec/]]. The latest version is [[2.2|http://specifications.freedesktop.org/mpris-spec/2.2/]].
All versions with the same major number (eg: 2.x) are backwards compatible.
Version 1 of the specification is [[fatally flawed|http://mailman.videolan.org/pipermail/mpris/2010-June/000084.html]] and should not be used.
## Specification source
The specification is maintained as [[D-Bus|Software/dbus]] introspection XML annotated with [[Telepathy extensions|http://telepathy.freedesktop.org/wiki/DbusSpec]]. It can be found in a [[git repository|http://cgit.freedesktop.org/xdg/mpris-spec]] along with tooling to build the HTML version of the specification.
Git URL: git://anongit.freedesktop.org/git/xdg/mpris-spec
## Mailing list
Discussion happens at [[mpris@lists.freedesktop.org|http://lists.freedesktop.org/mailman/listinfo/mpris]].
[[Archives from 2011 and earlier|http://mailman.videolan.org/pipermail/mpris/]] can be found on the VideoLAN site.
## Testing
In order to check that your media player conforms to the specification, one of the developers of MPRIS has created a compliance-testing tool. It can be [[found on GitHub|http://github.com/randomguy3/mpristester/]].
## Miscellany
* [[History of MPRIS|http://wiki.xmms2.xmms.se/index.php/Media_Player_Interfaces]]
|