skip to navigation
skip to content

PyGlobalShortcut 0.2.1

Python bindings to libqxt's QxtGlobalShortcut

Latest Version: 0.2.3


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.



Minimal for working:

For building from source:

None of them could be installed automatic, please download and install them manually.

Install from Source Code

pip install PyGlobalShortcut

or install

Install from Binary Package

WARNING: Binary package probably only work with corresponding PyQt binary package.

Binary package can be found at release page, 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 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.


See examples/


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 :)


pygs uses



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.

File Type Py Version Uploaded on Size (md5) Source 2014-05-01 42KB