Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Python bindings to libqxt's QxtGlobalShortcut

Project Description

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

Requirements

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

Install from Source Code

$ pip install PyGlobalShortcut

or

$ setup.py install

(Target Qt version can be specified by environment variable QT_SELECT, valid values are 4 or 5.)

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.

The file name of binary packages contains name of corresponding PyQt binary package (behind ‘-for-‘), if that package 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, 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 :)

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

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

Release History

Release History

This version
History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
PyGlobalShortcut-0.2.3.zip (44.6 kB) Copy SHA256 Checksum SHA256 Source Nov 5, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting