You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -45,6 +47,173 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co
45
47
|`kebab`| dashes instead of spaces |
46
48
|`help formatters`| show all available formatters |
47
49
50
+
`help formatters` shows 2 types of formatters: prose formatters and code formatters. Code formatters are primarily for formatting identifiers and values in computer code. Prose formatters are primarily for ordinary text and are shown with a \* after them. When dictating text with a prose formatter, you can say the following in the middle of dictation.
|`no cap` or `no caps`| the next word is in lowercase |
56
+
|`no space`| no space is inserted before the next word |
57
+
|`numb <number>`| insert the specified number |
58
+
59
+
These formatting options are also available in dictation mode with the same effects.
60
+
61
+
Prose formatters also allow punctuation in the middle of dictation. For example, say `say it helps comma so go ahead period` to insert "it helps, so go ahead.". Say `help punctuation` to see the punctuation commands. Prose formatters offer additional features, which we plan on documenting in the near future.
62
+
63
+
### Dictating Individual Characters
64
+
65
+
#### Dictating Characters in Command Mode
66
+
67
+
`help symbols` shows the commands for dictating symbols. Numbers can be dictated in command or dictation mode by saying `numb <number>`, i.e. `numb 2000` to dictate "2000". Individual letters can be dictated with the alphabet commands, which can be seen by saying `help alphabet`. A single capital letter can be dictated by saying `shift <user.letter>`, such as saying `shift air` to dictate "A". Multiple capital letters can be dictated in command or dictation mode by saying `ship` before the letters, such as saying `ship air bat cap` to dictate "ABC".
68
+
69
+
If you want to insert numbers in command mode without needing to say `numb` before every number, you can enable the user.unprefixed_numbers tag. To do this, first open settings.talon by saying `customize settings`. Look for the line with the text "# tag(): user.unprefixed_numbers" and remove the "#" and space at the start of the line. Now save the file by saying `file save`. You can read more about tags in the [the tags customization page](../Customization/Talon%20Framework/tags.md).
70
+
71
+
#### Dictating Characters in Dictation Mode
72
+
73
+
In dictation mode, lowercase letters can be dictated by saying `spell` and then the letters, such as `spell air bat cap` to dictate "abc". Keys can be pressed in dictation mode by saying `press` and then the key stroke. This can allow dictating symbols, such as `press tilde` to dictate "~". `help punctuation` shows how to dictate punctuation symbols in dictation mode without the press prefix.
74
+
75
+
The commands for dictating uppercase letters and numbers are the same as in command mode and are documented in the previous section.
76
+
77
+
### Dictating Words in Dictation Mode
78
+
79
+
In dictation mode, words that are not commands are inserted as text. To dictate words that would otherwise get interpreted as dictation mode commands, you can say `escape` followed by the words you want transcribed, such as saying `escape press air` to dictate the text "press air".
80
+
81
+
The following commands are available for overriding the default formatting:
|`no cap` or `no caps`| make the next word lowercase |
87
+
|`no space`| do not put a space before the next word |
88
+
|`cap that`| make the first word of the last dictated text capitalized |
89
+
|`no cap that` or `no caps that`| make the first word of the last dictated text lowercase |
90
+
|`formatted <user.formatters> <user.text>`| apply formatter to the dictated text |
91
+
92
+
The formatted command works with the formatters documented above. To give an example, saying `formatted title this is dictation` inserts the text "This Is Dictation".
93
+
94
+
To improve automatic spacing and capitalization in dictation mode, you can enable the user.context_sensitive_dictation setting. You can enable this globally in the settings.talon file, which you can open by saying `customize settings`. Context sensitive dictation may be slow and may not work in some applications because it relies on selecting and copying the text near the cursor, so you may want to enable this on a per-application basis. See [this page on .talon files](Customization/talon-files.md) if you want to understand how to modify settings on a per context basis and create custom commands.
95
+
96
+
## Pressing Keys
97
+
98
+
In command mode, saying `help alphabet` shows spoken forms for letter keys. Saying `help symbols` shows spoken forms for symbol keys.
99
+
100
+
Keys can be combined with modifier keys, i.e., saying `shift up` presses <kbd>Shift</kbd> and the up arrow key <kbd>↑</kbd>. Saying `help modifiers` shows the word to refer to each modifier key. The `super` key refers to the operating system-specific modifier. This is used for the Windows logo key on Windows and offers one way to refer to the <kbd>Command</kbd> key on macOS.
101
+
102
+
In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` presses the <kbd>Control</kbd> and <kbd>1</kbd> keys at the same time.
103
+
104
+
Keys can be pressed in dictation mode by saying `press` followed by the keystroke, such as saying `press shift up` to press <kbd>Shift</kbd> and the up arrow key <kbd>↑</kbd>. The `press` command can also be used in command or dictation mode to press modifier keys by themselves, such as `press control` to press the <kbd>Control</kbd> key.
105
+
106
+
Saying `help arrows` shows spoken forms for the arrow keys, which are just the direction names up, down, left, right. These can be used with a modifier or the `press` command but not by themselves.
107
+
108
+
Saying `help special keys` shows spoken forms for other keys you can `press`, such as <kbd>Page Up</kbd> and <kbd>Escape</kbd>.
109
+
110
+
Function keys, like <kbd>f1</kbd>, can be dictated by saying `f` and then the key number.
111
+
112
+
### Dictation Mode Editing and Navigation
113
+
114
+
Dictation mode provides some convenience commands for editing and navigating text.
|`scratch that`| delete the last dictated phrase assuming the cursor has not moved after dictating it |
119
+
|`select that`| select the last dictated phrase assuming the cursor has not moved after dictating it |
120
+
|`go line start`| move the cursor to the start of the line |
121
+
|`go line end`| move the cursor to the end of the line |
122
+
|`go up <number_small> (line or lines)`| move the cursor up the specified number of lines |
123
+
|`go down <number_small> (line or lines)`| move the cursor down the specified number of lines |
124
+
|`go left <number_small> (word or words)`| move the cursor left the specified number of words |
125
+
|`go right <number_small> (word or words)`| move the cursor right the specified number of words |
126
+
|`select left <number_small> (word or words)`| select the specified number of words to the left |
127
+
|`select right <number_small> (word or words)`| select the specified number of words to the right |
128
+
|`select left <number_small> (character or characters)`| select the specified number of characters to the left |
129
+
|`select right <number_small> (character or characters)`| select the specified number of characters to the right |
130
+
|`clear left <number_small> (word or words)`| delete the specified number of words to the left |
131
+
|`clear right <number_small> (word or words)`| delete the specified number of words to the right |
132
+
|`clear left <number_small> (character or characters)`| delete the specified number of characters to the left |
133
+
|`clear right <number_small> (character or characters)`| delete the specified number of characters to the right |
134
+
135
+
For example, saying `go up 10 lines` moves the cursor up 10 lines.
136
+
137
+
### Command Mode Editing and Navigation
138
+
139
+
#### Edit/Navigation Actions and Modifiers
140
+
141
+
Command mode provides flexible editing and navigation commands.
142
+
143
+
Saying an action name followed by a modifier applies the action to the modifier's target. For instance, saying `select line` selects the current line. A number between 1 and 99 can be dictated between the name of an action and a repeatable modifier to apply that modifier the specified number of times. For instance, saying `copy 3 right` copies the three characters to the right of the cursor.
|`tab restore`| reopen the most recently closed tab |
214
+
|`go tab <number>`| go to the tab specified by the dictated number |
215
+
|`go tab final`| go to the final tab |
216
+
48
217
## Customize Talon
49
218
50
219
These commands will open up a CSV or [Talon list](Customization/talon_lists.md) file in your default text editor that you can edit to customize voice commands without needing to write Talon scripts.
@@ -65,28 +234,9 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md)
65
234
|`launch "app name"`| say "launch chrome" for example, to open chrome |
66
235
|`window close`| closes the currently active window |
|`curse yes`| hides the mouse cursor for eye tracking |
120
-
|`curse no`| shows the mouse cursor |
121
-
|`righty`| right click |
260
+
The mouse grid lets you move the mouse by dictating numbers. You use one of the below commands to open the grid. This divides the area you made the grid around into 9 rectangles. Picking one of the numbers recreates the grid within that rectangle and moves the mouse to the center of that rectangle. The clicking commands and `grid close` close the mouse grid.
0 commit comments