PyQxtGlobalShortcut provides cross-platform global hotkey / shortcuts for python using PyQt.
PyQxtGlobalShortcut 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 within a proper namespace.
Minimal for working:
For building from source:
None of them could be installed automatic, please download and install them manually.
If you install them from a package manager, please also install development packages (if exist).
$ pip install PyQxtGlobalShortcut
or
$ setup.py install
(Target Qt version can be specified by environment variable QT_SELECT,
valid values are 4 or 5.)
See examples/simple.py
$ python simple.py
Ctrl+Alt+G - activate shortcutCtrl+Alt+Q - quit applicationNOTE: Ctrl maps to COMMAND on macs!!!! Yeah this is crazy confusing. But it's Qt not me :)
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
- py35-pyqt4
- py35-pyqt5
- py36-pyqt4
- py36-pyqt5
PyQxtGlobalShortcut uses
Thanks!
PyQxtGlobalShortcut - Python bindings to libqxt's QxtGlobalShortcut using SIP and PyQt. In other words, global hotkeys for PyQt.
You may use PyQxtGlobalShortcut 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.