Metadata-Version: 1.1
Name: osxmmkeys
Version: 0.0.3
Summary: Easily handle media keys on OS X.
Home-page: https://github.com/pushrax/osxmmkeys
Author: Justin Li
Author-email: jli@j-li.net
License: MIT
Description: =========
        osxmmkeys
        =========
        
        osxmmkeys is a simple Python library for handling media keys on OS X.
        Key presses can be observed with no side effects, or have their default
        behaviours overridden entirely.
        
        Installation
        ------------
        
        To install osxmmkeys with pip, use:
        
        .. code:: bash
        
            $ pip install pyobjc-core
            $ pip install osxmmkeys
        
        The extra install command is due to an issue_ in pyobjc.
        It will work without it, but will be quite a bit slower.
        
        .. _issue: https://bitbucket.org/ronaldoussoren/pyobjc/issue/21
        
        Usage
        -----
        
        Simple example:
        
        .. code:: python
        
            import osxmmkeys
        
            def handler():
                print("Play/pause key was pressed")
        
            tap = osxmmkeys.Tap()
            tap.on('play_pause', handler)
            tap.run()
        
        Threaded example:
        
        .. code:: python
        
            import osxmmkeys, time
        
            def handler():
                print("Play/pause key was pressed")
        
            tap = osxmmkeys.Tap()
            tap.on('play_pause', handler)
            tap.start()
        
            try:
                while True:
                    time.sleep(1)
            except (KeyboardInterrupt, SystemExit):
                tap.stop()
        
        Supported key names:
        
        - ``play_pause``
        - ``next_track``
        - ``prev_track``
        - ``mute``
        - ``volume_down``
        - ``volume_up``
        - ``backlight_down``
        - ``backlight_up``
        - ``kb_backlight_down``
        - ``kb_backlight_up``
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia
