wojtryb / Shortcut-Composer

Krita plugin for creating complex keyboard shortcuts
GNU General Public License v3.0
261 stars 9 forks source link
art digital-painting keyboard-shortcuts krita krita-plugin painting pie plugin python3

Shortcut composer v1.5.4

python Code style: black License: GPLv3 wojtryb website wojtryb twitter wojtryb portfolio


Extension for painting application Krita, which allows to create custom, complex keyboard shortcuts.

The plugin adds new shortcuts of the following types:

Important links

Download the latest version of the plugin, or visit its github page.


Changelog videos

PIE MENUS - introducing Shortcut Composer

PIE MENUS - introducing Shortcut Composer

PIE MENUS - release video

Requirements

OS support state:

Note On Linux the only officially supported version of Krita is .appimage, which ships with all required dependencies. Running the plugin on Krita installed from Snap or distribution repositories is not recommended as it may not work out of the box and may require extra dependency-related work.

How to install or update the plugin:

Installation steps are THE SAME for installing the plugin for the first time and for updating it to the new version:

  1. Download the plugin:
    • Use the direct link for stable or development release.
    • Alternatively, on github page switch from main to any of the unstable versions, click the green button code and pick the download zip option.
  2. In krita's topbar, open Tools > Scripts > Import Python Plugin From File and pick the downloaded .zip file
  3. Restart krita.
  4. Set custom shortcuts in Settings > Configure Krita > Keyboard Shortcuts under Scripts > Shortcut Composer: ... sections. By intention, there are no default bindings.

Warning Some keyboard buttons like Space, R, Y, V, 1, 2, 3, 4, 5, 6 are reserved for Krita's Canvas Inputs. Assigning those keys to actions (including those from the plugin) may result in conflicts and abnormal behavior different for each OS. Either avoid those keys, or remove their bindings in Settings > Configure Krita > Canvas Input Settings.

For krita plugin programmers

Some parts of plugin code solve general problems, which can apply outside of Shortcut Composer. Those solutions were placed in separate packages that can be copy-pasted into any other plugin and reused there.

They depend only on original Krita API and PyQt5 with which krita is shipped.