Problem Reporting Guide

How to document a problem with AutoKey including generating a trace

When AutoKey does something unfortunate, document your problem by specifying:

exactly what you did, including a copy of your script or phrase,

what it did,

what you expected it to do,

and

providing us with a trace log and a description of:

your OS/version

desktop manager/version

AutoKey version - Be sure to specify whether you're using autokey or autokey-py3 along with the version number.

and anything else you think might be relevant.

Quit AutoKey if it is currently running.

Start AutoKey from a terminal window:

autokey-gtk -l or autokey-qt -l

(Depending on which version of autokey you have installed. That's a lower case "ell".)

Then, do the minimum required to recreate your issue and then stop AutoKey.

This will produce a log in the terminal window of what AutoKey is doing.

It will probably show you what is wrong.

If it doesn't make sense or you have further questions, copy and paste the log output from the terminal window into a post to our list

and we'll take a look at it.

You can also use this information to create a new issue or document an existing one.

Provide feedback