Metadata-Version: 1.1
Name: mpris2
Version: 1.0.1
Summary: Python mpris2 definition
Home-page: https://github.com/hugosenari/mpris2
Author: hugosenari
Author-email: hugosenari@gmail.com
License: GPL
Description: ====================================
        Python usable definiton of MPRIS2
        ====================================
        
        This is my lib to help developers work with MPRIS2 and python
        
        See Mpris2 site (http://specifications.freedesktop.org/mpris-spec/2.2/)
        
        See also:
        ========
        
        pympris (https://github.com/wistful/pympris)
        
        
        Example:
        ========
        
        Here is some examples, that shows how to work with this lib.
        
        
        Configure dbus and mainloop
        ---------------------------
        
        >>> # configure mainloop (not required if you wont expect signals)
        >>> from dbus.mainloop.glib import DBusGMainLoop
        >>> DBusGMainLoop(set_as_default=True)
        
        
        Discover your player mpris uri 
        ------------------------------
        
        >>> # you can use get_players_uri to get current running players uri
        >>> from mpris2 import get_players_uri
        >>> # next raise StopIteration if not found
        >>> uri = next(get_players_uri())
        
        
        Connect to player
        -----------------
        
        >>> # create you player
        >>> from mpris2 import Player
        >>> player = Player(dbus_interface_info={'dbus_uri': uri})
        
        
        Call methods
        ------------
        
        
        >>> player.Next() # play next media
        
        
        Get attributes
        --------------
        
        >>> print(player.Metadata) #current media data
        
        
        Wait signal
        -----------
        
        
        >>> def another_handler(self, *args, **kw):
        >>>     print(args, kw)
        >>> 
        >>> player.PropertiesChanged = another_handler
        >>> # python3
        >>> import gi.repository.GLib
        >>> mloop = gi.repository.GLib.MainLoop()
        >>> mloop.run()
        
        
        Other examples:
        ---------------
        
        >>> # old versions mainloop
        >>> import gobject
        >>> mloop = gobject.MainLoop()
        
        >>> # list all running players
        >>> from mpris2 import get_players_uri
        >>> print([uri for uri in get_players_uri()])
        >>> # get_players_uri can be called with filter parameter
        >>> get_players_uri('.+rhythmbox')
        >>> # you can set it yourself
        >>> uri = 'org.mpris.MediaPlayer2.gmusicbrowser'
        >>> # or use one predefined
        >>> from mpris2 import SomePlayers, Interfaces
        >>> uri = '.'.join([Interfaces.MEDIA_PLAYER, SomePlayers.GMUSICBROWSER])
        
        >>> # test other interfaces
        >>> from mpris2 import MediaPlayer2
        >>> mp2 = MediaPlayer2(dbus_interface_info={'dbus_uri': uri})
        >>> # not all players implement this:
        >>> from mpris2 import Playlists, TrackList
        >>> pls = Playlists(dbus_interface_info={'dbus_uri': uri})
        >>> tl = TrackList(dbus_interface_info={'dbus_uri': uri})
        
Keywords: dbus,mpris2
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
