From efdee48e63e86e42fb69996d97ba77f75c503aba Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 29 Dec 2025 10:50:52 -0700 Subject: [PATCH 01/16] Explain mouse grid --- docs/Basic Usage/basic_usage.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 39ef5082..858cfcc3 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -110,6 +110,8 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) ## Mouse Commands +### Clicking + | Command | Description | | ------------ | --------------------------------------- | | `touch` | single click | @@ -120,6 +122,17 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) | `curse no` | shows the mouse cursor | | `righty` | right click | +### Mouse Grid + +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. + +| Command | Description | +| ------------------------- | --------------------------------------------------------------------------------- | +| `mouse grid` | open the mouse grid | +| `grid win` | open the mouse grid on the window | +| `grid screen ` | open the mouse grid on the specified screen | +| `grid +` | open the mouse grid and narrow it using the numbers from the dictated number keys | + ## Scrolling | Command | Description | From c64f7cb30f94d2a74cbe9fa834152e666cb63710 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 29 Dec 2025 11:04:52 -0700 Subject: [PATCH 02/16] Describe character insertion --- docs/Basic Usage/basic_usage.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 858cfcc3..e634b90c 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -33,6 +33,8 @@ To keep track of what mode you are in with a visual icon, enable the [mode indic ## Dictating Text +### Formatters + Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in command mode | Formatter | Description | @@ -45,6 +47,12 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co | `kebab` | dashes instead of spaces | | `help formatters` | show all available formatters | +### Dictating Individual Characters + +`help symbols` shows the commands for dictating symbols. Numbers can be dictated in command or dictation mode by saying `numb `, 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 `, 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`. + +In dication mode, lower case letters can be dictated by saying `spell` and then the letters, such as `spell air bat cap` to dictate `abc`. Keys can be pressed by saying `press` and then the key stroke. This can allow dictating symbols, such as `press tilde` to dictate `~`. + ## Customize Talon 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. From d036d14d8dc838f92e96b6321992c44488ef24c3 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 29 Dec 2025 11:10:40 -0700 Subject: [PATCH 03/16] Explained shared commands --- docs/Basic Usage/basic_usage.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index e634b90c..49391839 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -49,9 +49,14 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co ### Dictating Individual Characters +#### Dictating Characters in Command Mode + `help symbols` shows the commands for dictating symbols. Numbers can be dictated in command or dictation mode by saying `numb `, 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 `, 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`. -In dication mode, lower case letters can be dictated by saying `spell` and then the letters, such as `spell air bat cap` to dictate `abc`. Keys can be pressed by saying `press` and then the key stroke. This can allow dictating symbols, such as `press tilde` to dictate `~`. +#### Dictating Characters in Dictation Mode +In dication mode, lower case 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. + +The commands for dictating upper case letters and numbers are the same as in command mode and are documented in the previous section. ## Customize Talon From abdfc639b9561ee7b3a749ffbe5f467ba4de81a9 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 29 Dec 2025 11:59:33 -0700 Subject: [PATCH 04/16] Explain basics of dictation mode --- docs/Basic Usage/basic_usage.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 49391839..e3406814 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -58,6 +58,22 @@ In dication mode, lower case letters can be dictated by saying `spell` and then The commands for dictating upper case letters and numbers are the same as in command mode and are documented in the previous section. +### Dictating Words in Dictation Mode +In dictation mode, words that are not commands are typed 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`. + +The following commands are available for overwriting the default formatting + +| Command | Description | +| ----------------------------------------- | --------------------------------------------------------- | +| `cap` | capitalize the next word | +| `no cap` or `no caps` | make the next word lowercase | +| `no space` | do not put a space before the next word | +| `cap that` | make the first word of the last dictated text capitalized | +| `no cap that` or `no caps that` | make the first word of the last dictated text lowercase | +| `formatted ` | apply formatter to the dictated text | + +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`. + ## Customize Talon 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. From c90d978a057c0f8bfbdc1cde3598d3eaed1fc704 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 29 Dec 2025 12:32:40 -0700 Subject: [PATCH 05/16] Start documenting keys --- docs/Basic Usage/basic_usage.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index e3406814..85b43e5f 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -74,6 +74,15 @@ The following commands are available for overwriting the default formatting 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`. +## Pressing Keys +Letter keys are referred to using the Talon alphabet. Saying `help alphabet` shows the command for each letter. + +Saying `help symbols` shows the command for each symbol key. + +Keys can be combined with modifier keys, i.e saying `shift up` presses shift and up. Saying `help modifiers` shows the command for each modifier key. + +In a keystroke, number keys can be dictated without prefix. For instance, saying `control-1` presses the control and 1 keys at the same time. + ## Customize Talon 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. From 081c5747f5e04a9245e1daba5a451a6aa33250e1 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 08:33:59 -0700 Subject: [PATCH 06/16] Document the rest of the keys --- docs/Basic Usage/basic_usage.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 85b43e5f..5a968262 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -75,14 +75,22 @@ The following commands are available for overwriting the default formatting 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`. ## Pressing Keys -Letter keys are referred to using the Talon alphabet. Saying `help alphabet` shows the command for each letter. +Saying `help alphabet` shows the command for each letter key. Saying `help symbols` shows the command for each symbol key. -Keys can be combined with modifier keys, i.e saying `shift up` presses shift and up. Saying `help modifiers` shows the command for each modifier key. +Keys can be combined with modifier keys, i.e saying `shift up` presses shift and up. 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` key on Windows and offers one way to refer to the `command` key on MacOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control-1` presses the control and 1 keys at the same time. +Keys can be pressed in dictation mode by saying `press` followed by the key stroke, such as saying `press shift up` to press shift and up. 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 control key. + +Saying `help arrows` shows the names for referring to 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. + +Saying `help special keys` shows the commands for other keys you can press, such as pageup and escape. + +Function keys, like `f1`, can be dictated by saying `f` and then the key number. + ## Customize Talon 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. From 264f03ad11004c94bc61f599ee9c861be4a5ab1b Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 08:56:30 -0700 Subject: [PATCH 07/16] Document dictation mode editing and navigation --- docs/Basic Usage/basic_usage.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 5a968262..aa8f9776 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -91,6 +91,30 @@ Saying `help special keys` shows the commands for other keys you can press, such Function keys, like `f1`, can be dictated by saying `f` and then the key number. +### Dictation Mode Editing +Dictation mode provides some convenience commands for editing text. + +| Command | Description | +| ------------------------------------------------------- | ------------------------------------------------------------------------------------ | +| `scratch that` | delete the last dictated phrase assuming the cursor has not moved after dictating it | +| `select that` | select the last dictated phrase assuming the cursor has not moved after dictating it | +| `go line start` | move the cursor to the start of the line | +| `go line end` | move the cursor to the end of the line | +| `go up (line or lines)` | move the cursor up the specified number of lines | +| `go down (line or lines)` | move the cursor down the specified number of lines | +| `go left (word or words)` | move the cursor left the specified number of words | +| `go right (word or words)` | move the cursor right the specified number of words | +| `select left (word or words)` | select the specified number of words to the left | +| `select right (word or words)` | select the specified number of words to the right | +| `select left (character or characters)` | select the specified number of characters to the left | +| `select right (character or characters)` | select the specified number of characters to the right | +| `clear left (word or words)` | delete the specified number of words to the left | +| `clear right (word or words)` | delete the specified number of words to the right | +| `clear left (character or characters)` | delete the specified number of characters to the left | +| `clear right (character or characters)` | delete the specified number of characters to the right | + +For example, saying `go up 10 lines` moves the cursor up 10 lines. + ## Customize Talon 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. From 8c1a4dea6a3d555655c78a3d393baadd1035282a Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 08:57:02 -0700 Subject: [PATCH 08/16] Improve title --- docs/Basic Usage/basic_usage.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index aa8f9776..c484e5cb 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -91,8 +91,8 @@ Saying `help special keys` shows the commands for other keys you can press, such Function keys, like `f1`, can be dictated by saying `f` and then the key number. -### Dictation Mode Editing -Dictation mode provides some convenience commands for editing text. +### Dictation Mode Editing and Navigation +Dictation mode provides some convenience commands for editing and navigating text. | Command | Description | | ------------------------------------------------------- | ------------------------------------------------------------------------------------ | From fe0c9c1406a7d6b16dec374a3417686d826609b3 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 09:32:58 -0700 Subject: [PATCH 09/16] Start on documenting navigation and editing --- docs/Basic Usage/basic_usage.md | 38 +++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index c484e5cb..0658ad94 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -115,6 +115,44 @@ Dictation mode provides some convenience commands for editing and navigating tex For example, saying `go up 10 lines` moves the cursor up 10 lines. +### Command Mode Editing and Navigation + +Command mode provides flexible editing and navigation commands where an editing/navigation command can be followed by a modifier to apply it to. + +| Action | Description | +| --------------------------- | ------------------------------------------------- | +| select | select the target | +| go before | go before the target | +| go after | go after the target | +| copy | copy the text at the target | +| paste | paste the contents of the clipboard to the target | +| clear | delete the target | + +| Modifier | Description | +| ----------------------------- | ------------------------------------------------- | +| all | apply the action to the document | +| paragraph | apply the action to the paragraph | +| line | apply the action to the line | +| line start | apply the action to the start of line | +| way left | apply the action to the start of line | +| line end | apply the action to the end of line | +| way right | apply the action to the end of line | +| file start | apply the action to the start of file | +| way up | apply the action to the start of file | +| file end | apply the action to the end of file | +| way down | apply the action to the end of file | + +| Repeatable Modifier | Description | +| ----------------------------- | -------------------------------------- | +| word | apply the action to the specified number of words +| word left | apply the action to the specified number of words left +| word right | apply the action to the specified number of words right +| up | apply the action to the specified number of lines up | +| down | apply the action to the specified number of lines down | +| left | apply the action to the specified number of characters to the left | +| right | apply the action to the specified number of characters to the right | + + ## Customize Talon 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. From 186260d4325c18b61d92233ab88a62268d9f020a Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 10:56:40 -0700 Subject: [PATCH 10/16] Document edit --- docs/Basic Usage/basic_usage.md | 44 +++++++++++++++++---------------- 1 file changed, 23 insertions(+), 21 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 0658ad94..84fdd8c5 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -119,6 +119,8 @@ For example, saying `go up 10 lines` moves the cursor up 10 lines. Command mode provides flexible editing and navigation commands where an editing/navigation command can be followed by a modifier to apply it to. +Saying the name of one of these actions followed by the name of a modifier applies the action to the target referred to by the modifier. 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. + | Action | Description | | --------------------------- | ------------------------------------------------- | | select | select the target | @@ -128,29 +130,29 @@ Command mode provides flexible editing and navigation commands where an editing/ | paste | paste the contents of the clipboard to the target | | clear | delete the target | -| Modifier | Description | +| Modifier | What the action gets applied to | | ----------------------------- | ------------------------------------------------- | -| all | apply the action to the document | -| paragraph | apply the action to the paragraph | -| line | apply the action to the line | -| line start | apply the action to the start of line | -| way left | apply the action to the start of line | -| line end | apply the action to the end of line | -| way right | apply the action to the end of line | -| file start | apply the action to the start of file | -| way up | apply the action to the start of file | -| file end | apply the action to the end of file | -| way down | apply the action to the end of file | - -| Repeatable Modifier | Description | +| all | the document | +| paragraph | the paragraph | +| line | the line | +| line start | the start of line | +| way left | the start of line | +| line end | the end of line | +| way right | the end of line | +| file start | the start of file | +| way up | the start of file | +| file end | the end of file | +| way down | the end of file | + +| Repeatable Modifier | The action gets applied to the specified number of | | ----------------------------- | -------------------------------------- | -| word | apply the action to the specified number of words -| word left | apply the action to the specified number of words left -| word right | apply the action to the specified number of words right -| up | apply the action to the specified number of lines up | -| down | apply the action to the specified number of lines down | -| left | apply the action to the specified number of characters to the left | -| right | apply the action to the specified number of characters to the right | +| word left | words to the left of the cursor | +| word right | words to the right of the cursor | +| word | words to the right of the cursor | +| up | lines up starting at the cursor | +| down | lines down starting at the cursor | +| left | characters to the left of the cursor | +| right | characters to the right of the cursor | ## Customize Talon From e6132e5d0e98710b116a723e53cfd2fa3d840485 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 11:05:33 -0700 Subject: [PATCH 11/16] Reorganize --- docs/Basic Usage/basic_usage.md | 100 ++++++++++++++++---------------- 1 file changed, 49 insertions(+), 51 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 84fdd8c5..7110aaa1 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -117,6 +117,8 @@ For example, saying `go up 10 lines` moves the cursor up 10 lines. ### Command Mode Editing and Navigation +#### Edit/Navigation Actions and Modifiers + Command mode provides flexible editing and navigation commands where an editing/navigation command can be followed by a modifier to apply it to. Saying the name of one of these actions followed by the name of a modifier applies the action to the target referred to by the modifier. 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. @@ -154,28 +156,33 @@ Saying the name of one of these actions followed by the name of a modifier appli | left | characters to the left of the cursor | | right | characters to the right of the cursor | +#### Scrolling -## Customize Talon - -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. - -| Command | Description | -| ---------------------------- | ------------------------------------------------- | -| `customize additional words` | add additional words that Talon will recognize | -| `customize words to replace` | remap or reformat words that Talon will recognize | -| `customize alphabet` | change the default Talon alphabet | -| `customize websites` | add websites that can be opened with Talon | +| Command | Description | +| -------------- | -------------------------------------- | +| `page down` | press the page down key | +| `page up` | press the page up key | +| `scroll down` | scroll down | +| `scroll up` | scroll up | +| `wheel down` | scroll down | +| `wheel up` | scroll up with the mouse | +| `wheel left` | scroll left with the mouse | +| `wheel gaze` | scroll according to the mouse position | +| `wheel upper` | continually scroll up with the mouse | +| `wheel downer` | continually scroll down with the mouse | +| `wheel stop` | stop scrolling | -## Working with applications +#### Working with text -| Command | Description | -| ------------------- | ----------------------------------------------------------------- | -| `focus "app name"` | say "focus chrome" for example, to switch active window to chrome | -| `running list` | see all active applications | -| `launch "app name"` | say "launch chrome" for example, to open chrome | -| `window close` | closes the currently active window | +| Command | Description | +| -------------- | ------------------------------------------------------------------------- | +| `copy that` | copy selection | +| `paste that` | paste | +| `cut that` | cut selection | +| `undo that` | undo | +| `redo that` | redo | -## Working with tabs +#### Working With Tabs | Command | | ----------------- | @@ -187,7 +194,7 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) | `go tab ` | | `go tab final` | -## Working with media +#### Working With Media | Command | | --------------- | @@ -196,7 +203,29 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) | `play previous` | | `media play` | -## Controlling the Tobii eye tracker +## Customize Talon + +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. + +| Command | Description | +| ---------------------------- | ------------------------------------------------- | +| `customize additional words` | add additional words that Talon will recognize | +| `customize words to replace` | remap or reformat words that Talon will recognize | +| `customize alphabet` | change the default Talon alphabet | +| `customize websites` | add websites that can be opened with Talon | + +## Working with applications + +| Command | Description | +| ------------------- | ----------------------------------------------------------------- | +| `focus "app name"` | say "focus chrome" for example, to switch active window to chrome | +| `running list` | see all active applications | +| `launch "app name"` | say "launch chrome" for example, to open chrome | +| `window close` | closes the currently active window | + +## Mouse Commands + +### Controlling the Tobii eye tracker | Commands | Description | | ----------------- | ------------------------------------ | @@ -205,21 +234,6 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) | `zoom mouse` | Toggle Control Mouse (Zoom). | | `control off` | Turn the eye tracker off | -## Working with text - -| Command | Description | -| -------------- | ------------------------------------------------------------------------- | -| `copy that` | | -| `control cap` | copy via the keyboard shortcut using the Talon alphabet (`cap` for `c`) | -| `paste that` | | -| `control vest` | paste via the keyboard shortcut using the Talon alphabet (`vest` for `v`) | -| `cut that` | | -| `undo that` | | -| `redo that` | | -| `scratch that` | undo Talon dictation | - -## Mouse Commands - ### Clicking | Command | Description | @@ -242,19 +256,3 @@ The mouse grid lets you move the mouse by dictating numbers. You use one of the | `grid win` | open the mouse grid on the window | | `grid screen ` | open the mouse grid on the specified screen | | `grid +` | open the mouse grid and narrow it using the numbers from the dictated number keys | - -## Scrolling - -| Command | Description | -| -------------- | -------------------------------------- | -| `page down` | press the page down key | -| `page up` | press the page up key | -| `scroll down` | scroll down | -| `scroll up` | scroll up | -| `wheel down` | scroll down | -| `wheel up` | scroll up | -| `wheel left` | scroll left | -| `wheel gaze` | scroll according to the mouse position | -| `wheel upper` | continually scroll up | -| `wheel downer` | continually scroll down | -| `wheel stop` | stop scrolling | From 52541e68ba80df73283911ec951c849893978d95 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Tue, 30 Dec 2025 18:09:24 +0000 Subject: [PATCH 12/16] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/Basic Usage/basic_usage.md | 110 +++++++++++++++++--------------- 1 file changed, 57 insertions(+), 53 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 7110aaa1..e0488598 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -33,7 +33,7 @@ To keep track of what mode you are in with a visual icon, enable the [mode indic ## Dictating Text -### Formatters +### Formatters Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in command mode @@ -51,15 +51,17 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co #### Dictating Characters in Command Mode -`help symbols` shows the commands for dictating symbols. Numbers can be dictated in command or dictation mode by saying `numb `, 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 `, 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`. +`help symbols` shows the commands for dictating symbols. Numbers can be dictated in command or dictation mode by saying `numb `, 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 `, 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`. #### Dictating Characters in Dictation Mode -In dication mode, lower case 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. + +In dication mode, lower case 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. The commands for dictating upper case letters and numbers are the same as in command mode and are documented in the previous section. ### Dictating Words in Dictation Mode -In dictation mode, words that are not commands are typed 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`. + +In dictation mode, words that are not commands are typed 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`. The following commands are available for overwriting the default formatting @@ -72,29 +74,31 @@ The following commands are available for overwriting the default formatting | `no cap that` or `no caps that` | make the first word of the last dictated text lowercase | | `formatted ` | apply formatter to the dictated text | -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`. +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`. ## Pressing Keys -Saying `help alphabet` shows the command for each letter key. + +Saying `help alphabet` shows the command for each letter key. Saying `help symbols` shows the command for each symbol key. -Keys can be combined with modifier keys, i.e saying `shift up` presses shift and up. 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` key on Windows and offers one way to refer to the `command` key on MacOS. +Keys can be combined with modifier keys, i.e saying `shift up` presses shift and up. 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` key on Windows and offers one way to refer to the `command` key on MacOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control-1` presses the control and 1 keys at the same time. Keys can be pressed in dictation mode by saying `press` followed by the key stroke, such as saying `press shift up` to press shift and up. 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 control key. -Saying `help arrows` shows the names for referring to 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. +Saying `help arrows` shows the names for referring to 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. Saying `help special keys` shows the commands for other keys you can press, such as pageup and escape. -Function keys, like `f1`, can be dictated by saying `f` and then the key number. +Function keys, like `f1`, can be dictated by saying `f` and then the key number. ### Dictation Mode Editing and Navigation -Dictation mode provides some convenience commands for editing and navigating text. -| Command | Description | +Dictation mode provides some convenience commands for editing and navigating text. + +| Command | Description | | ------------------------------------------------------- | ------------------------------------------------------------------------------------ | | `scratch that` | delete the last dictated phrase assuming the cursor has not moved after dictating it | | `select that` | select the last dictated phrase assuming the cursor has not moved after dictating it | @@ -121,40 +125,40 @@ For example, saying `go up 10 lines` moves the cursor up 10 lines. Command mode provides flexible editing and navigation commands where an editing/navigation command can be followed by a modifier to apply it to. -Saying the name of one of these actions followed by the name of a modifier applies the action to the target referred to by the modifier. 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. - -| Action | Description | -| --------------------------- | ------------------------------------------------- | -| select | select the target | -| go before | go before the target | -| go after | go after the target | -| copy | copy the text at the target | -| paste | paste the contents of the clipboard to the target | -| clear | delete the target | - -| Modifier | What the action gets applied to | -| ----------------------------- | ------------------------------------------------- | -| all | the document | -| paragraph | the paragraph | -| line | the line | -| line start | the start of line | -| way left | the start of line | -| line end | the end of line | -| way right | the end of line | -| file start | the start of file | -| way up | the start of file | -| file end | the end of file | -| way down | the end of file | - -| Repeatable Modifier | The action gets applied to the specified number of | -| ----------------------------- | -------------------------------------- | -| word left | words to the left of the cursor | -| word right | words to the right of the cursor | -| word | words to the right of the cursor | -| up | lines up starting at the cursor | -| down | lines down starting at the cursor | -| left | characters to the left of the cursor | -| right | characters to the right of the cursor | +Saying the name of one of these actions followed by the name of a modifier applies the action to the target referred to by the modifier. 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. + +| Action | Description | +| --------- | ------------------------------------------------- | +| select | select the target | +| go before | go before the target | +| go after | go after the target | +| copy | copy the text at the target | +| paste | paste the contents of the clipboard to the target | +| clear | delete the target | + +| Modifier | What the action gets applied to | +| ---------- | ------------------------------- | +| all | the document | +| paragraph | the paragraph | +| line | the line | +| line start | the start of line | +| way left | the start of line | +| line end | the end of line | +| way right | the end of line | +| file start | the start of file | +| way up | the start of file | +| file end | the end of file | +| way down | the end of file | + +| Repeatable Modifier | The action gets applied to the specified number of | +| ------------------- | -------------------------------------------------- | +| word left | words to the left of the cursor | +| word right | words to the right of the cursor | +| word | words to the right of the cursor | +| up | lines up starting at the cursor | +| down | lines down starting at the cursor | +| left | characters to the left of the cursor | +| right | characters to the right of the cursor | #### Scrolling @@ -174,13 +178,13 @@ Saying the name of one of these actions followed by the name of a modifier appli #### Working with text -| Command | Description | -| -------------- | ------------------------------------------------------------------------- | -| `copy that` | copy selection | -| `paste that` | paste | -| `cut that` | cut selection | -| `undo that` | undo | -| `redo that` | redo | +| Command | Description | +| ------------ | -------------- | +| `copy that` | copy selection | +| `paste that` | paste | +| `cut that` | cut selection | +| `undo that` | undo | +| `redo that` | redo | #### Working With Tabs @@ -248,7 +252,7 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) ### Mouse Grid -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. +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. | Command | Description | | ------------------------- | --------------------------------------------------------------------------------- | From 7cc4b1a9a06ad2a6cac3f0ac6a9e04ff23105df9 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 11:23:55 -0700 Subject: [PATCH 13/16] Fix some things --- docs/Basic Usage/basic_usage.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index e0488598..496ea8c5 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -168,9 +168,10 @@ Saying the name of one of these actions followed by the name of a modifier appli | `page up` | press the page up key | | `scroll down` | scroll down | | `scroll up` | scroll up | -| `wheel down` | scroll down | +| `wheel down` | scroll down with the mouse | | `wheel up` | scroll up with the mouse | | `wheel left` | scroll left with the mouse | +| `wheel right` | scroll right with the mouse | | `wheel gaze` | scroll according to the mouse position | | `wheel upper` | continually scroll up with the mouse | | `wheel downer` | continually scroll down with the mouse | @@ -198,15 +199,6 @@ Saying the name of one of these actions followed by the name of a modifier appli | `go tab ` | | `go tab final` | -#### Working With Media - -| Command | -| --------------- | -| `media mute` | -| `play next` | -| `play previous` | -| `media play` | - ## Customize Talon 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. @@ -260,3 +252,12 @@ The mouse grid lets you move the mouse by dictating numbers. You use one of the | `grid win` | open the mouse grid on the window | | `grid screen ` | open the mouse grid on the specified screen | | `grid +` | open the mouse grid and narrow it using the numbers from the dictated number keys | + +## Working With Media + +| Command | +| --------------- | +| `media mute` | +| `play next` | +| `play previous` | +| `media play` | From 7d606d876721781e1f7bce43ddf63da2074d90fc Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Tue, 30 Dec 2025 11:30:51 -0700 Subject: [PATCH 14/16] Move curse commands --- docs/Basic Usage/basic_usage.md | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 496ea8c5..725a6b2c 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -232,15 +232,13 @@ These commands will open up a CSV or [Talon list](Customization/talon_lists.md) ### Clicking -| Command | Description | -| ------------ | --------------------------------------- | -| `touch` | single click | -| `duke` | double click | -| `trip click` | triple click | -| `drag` | hold down the mouse. Repeat to release | -| `curse yes` | hides the mouse cursor for eye tracking | -| `curse no` | shows the mouse cursor | -| `righty` | right click | +| Command | Description | +| ------------ | -------------------------------------- | +| `touch` | single click | +| `duke` | double click | +| `trip click` | triple click | +| `drag` | hold down the mouse. Repeat to release | +| `righty` | right click | ### Mouse Grid @@ -253,6 +251,15 @@ The mouse grid lets you move the mouse by dictating numbers. You use one of the | `grid screen ` | open the mouse grid on the specified screen | | `grid +` | open the mouse grid and narrow it using the numbers from the dictated number keys | +### Cursor Hide/Show Commands + +| Command | Description | +| ------------ | --------------------------------------- | +| `curse yes` | hides the mouse cursor for eye tracking | +| `curse no` | shows the mouse cursor | + +These commands require activating the `user.mouse_cursor_commands_enable` tag (see community settings.talon). + ## Working With Media | Command | From 4ad694d9a08d8d17bec5bf3043500c3d0ddf7b0a Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Tue, 30 Dec 2025 18:31:08 +0000 Subject: [PATCH 15/16] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/Basic Usage/basic_usage.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 725a6b2c..b6f70016 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -253,10 +253,10 @@ The mouse grid lets you move the mouse by dictating numbers. You use one of the ### Cursor Hide/Show Commands -| Command | Description | -| ------------ | --------------------------------------- | -| `curse yes` | hides the mouse cursor for eye tracking | -| `curse no` | shows the mouse cursor | +| Command | Description | +| ----------- | --------------------------------------- | +| `curse yes` | hides the mouse cursor for eye tracking | +| `curse no` | shows the mouse cursor | These commands require activating the `user.mouse_cursor_commands_enable` tag (see community settings.talon). From 2d5acfbbccab740e266adddeb9755dfa1fede740 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Fri, 9 Jan 2026 19:38:04 -0700 Subject: [PATCH 16/16] Capitalize community --- docs/Basic Usage/basic_usage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index b6f70016..1c28ab49 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -258,7 +258,7 @@ The mouse grid lets you move the mouse by dictating numbers. You use one of the | `curse yes` | hides the mouse cursor for eye tracking | | `curse no` | shows the mouse cursor | -These commands require activating the `user.mouse_cursor_commands_enable` tag (see community settings.talon). +These commands require activating the `user.mouse_cursor_commands_enable` tag (see Community settings.talon). ## Working With Media