A single source of application-specific scripts
Clone a fork of this repository in a directory inside of your user
directory, such as community
.
If you wish to develop on these scripts, run in the project root:
python3 setup.py install
To install linters and formatter
apps/
folder is "single script per app, named by the app", nothing goes in the apps folder unless it's a script supporting exactly one app with a context properly scoped to the app (unscoped scripts are fine for now for apps like spectacle, though probably note down the app's bundle identifier in the script so we can detect if it's running later)lang/
, generic text insertion goes in text/
, anything else goes in misc/
tab close
is more expressive than totch
and is prefixed with the tab
scope. voicecode's grammar can be bolted on later / as a separate set of scripts. "voicecode compatibility" is something of an opposite goal to coming up with a consistent grammar.ctx = Context()
, ctx.keymap({})
instead of using a separate dict unless you have a good reasonWhen adding new commands, try to scope their context as narrowly as possible.
The implementation of a flexible way to determine context activtion is a work in progress. For the time being:
is_filetype
helper in utils.py. This helper relies on the file type appearing in the window title. If you wish to use file type specific commands in an application that does not display the file type in the window title, either remove that application's bundle id from the file type sensitive bundles group, or add something that will match the window title to the list of file types for that context."comma": ","
to ",": ","
.speech_toggle.py
: Note the 'dictation mode', which behaves similarly to dragon mode, but keeps Talon in control. It is a workaround for the inability of Dragon in 'dragon mode' to maintain focus on the front most application in some situations.keeper.py
: The phrase
command will only preserve literally the first part of the utterance. Anything that might be a command after the first word will be interpreted as such. keeper
tries to preserve everything.The following have been empirically determined, could change at any point, and are not to be relied on: