Overview

pygs provides cross-platform global hotkey / shortcuts for python using PyQt.

pygs is a wrapper for libqxt’s QxtGlobalShortcut.

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

$ pip install PyGlobalShortcut

$ setup.py install

$ pip install <filepath.whl>

Usage

See examples/simple.py

$ python simple.py

NOTE: Ctrl maps to COMMAND on macs!!!! Yeah this is crazy confusing. But it’s Qt not me :)

Testing

There is a minimal test suite that check the compilation process for various environments and ensure QxtGlobalShortcut can be properly imported and used.

To run the tests, you must first install tox:

$ pip install tox

Then you can run the tests by running the following command:

$ tox

To run the tests against a specific environment, use the -e option. E.g. to run tests with Python 2.7 and PyQt4, you would run:

$ tox -e py27-pyqt4

Here is the list of available test environments:

• py27-pyqt4

• py27-pyqt5

• py32-pyqt4

• py32-pyqt5

• py33-pyqt4

• py33-pyqt5

• py34-pyqt4

• py34-pyqt5

Acknowledgements

pygs uses

• Digia’s Qt

• Riverbank Computing Limited’s SIP

• Riverbank Computing Limited’s PyQt

• libqxt

Thanks!

License

pygs - Python bindings to libqxt’s QxtGlobalShortcut using SIP and PyQt. In other words, global hotkeys for PyQt.

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