Metadata-Version: 1.1
Name: PyGlobalShortcut
Version: 0.2.1
Summary: Python bindings to libqxt's QxtGlobalShortcut
Home-page: https://github.com/Asvel/pygs
Author: Asvel
Author-email: fe.asvel@gmail.com
License: GPLv3
Description: ====
        pygs
        ====
        
        .. image:: http://dl.dropbox.com/u/750959/pygs_strike.png
        
        
        Overview
        --------
        
        pygs provides cross-platform global hotkey / shortcuts for python using PyQt.
        
        pygs is a wrapper for `libqxt <http://www.libqxt.org/>`_'s `QxtGlobalShortcut <http://doc.libqxt.org/tip/qxtglobalshortcut.html>`_.
        
        My aim is to provide cross-platform support for global hotkeys (shortcuts) in python. Ideally I would like to remove the PyQt and libqxt dependency but that remains a (distant) future goal. I believe it is definitely possible and potentially quite useful though.
        
        This fork support PyQt4 / PyQt5 on Python 2.x / 3.x.
        
        
        Installation
        ------------
        
        Requirements
        ~~~~~~~~~~~~
        
        Minimal for working:
        
        * `PyQt <http://www.riverbankcomputing.co.uk/software/pyqt/intro>`_
        
        For building from source:
        
        * `Qt <http://qt-project.org/>`_
        * `SIP <http://www.riverbankcomputing.co.uk/software/sip/intro>`_
        
        *None of them could be installed automatic, please download and install them manually.*
        
        Install from Source Code
        ~~~~~~~~~~~~~~~~~~~~~~~~
        
        ``pip install PyGlobalShortcut``
        
        or
        
        ``setup.py install``
        
        Install from Binary Package
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        **WARNING**: *Binary package probably only work with corresponding PyQt binary package.*
        
        Binary package can be found at `release page <https://github.com/Asvel/pygs/releases>`_, please download an unzip it.
        
        There are some directories named in form '``<PyQt binary package name>-<first 6 characters of PyQt binary package sha1>``' in it, **open the one corresponding to the PyQt binary package installed**, if that directory does not exist or your PyQt is not installed from official binary package, **please install pygs from source code.**
        
        There is a `Wheel <https://pypi.python.org/pypi/wheel>`_ in it, just install it by:
        
        ``pip install <filepath.whl>``
        
        Again, *binary package probably only work with corresponding PyQt binary package*, please use it carefully.
        
        
        Usage
        -----
        
        **See examples/simple.py**
        
        ``python simple.py``
        
        | ``Ctrl+Alt+S`` - activate shortcut
        | ``Ctrl+Alt+F`` - quit application
        
        NOTE: Ctrl maps to COMMAND on macs!!!! Yeah this is crazy confusing. But it's Qt not me :)
        
        
        Acknowledgements
        ----------------
        
        pygs uses
        
        * `Digia <http://www.digia.com/>`_'s `Qt <http://qt-project.org/>`_
        
        * `Riverbank Computing Limited <http://www.riverbankcomputing.co.uk>`_'s `SIP <http://www.riverbankcomputing.co.uk/software/sip/intro>`_
        
        * `Riverbank Computing Limited <http://www.riverbankcomputing.co.uk>`_'s `PyQt <http://www.riverbankcomputing.co.uk/software/pyqt/intro>`_
        
        * `libqxt <http://www.libqxt.org/>`_
        
        Thanks!
        
        
        License
        -------
        
        pygs  - Python bindings to libqxt's QxtGlobalShortcut using SIP and PyQt. In other words, global hotkeys for PyQt.
        
        | Copyright (C) 2010  J. Matt Peterson
        | Copyright (C) 2014  Asvel
        
        You may use pygs under the terms of the General Public License (GPL) Version 3 or you may contact the author for permission or a commercial license. The commercial license option is specifically provided for those who are unable or unwilling to use the GPL.
        
        http://www.gnu.org/licenses/gpl-3.0.txt
        
Keywords: shortcut hotkey QxtGlobalShortcut libqxt qt
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Developers
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
