From efdee48e63e86e42fb69996d97ba77f75c503aba Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 29 Dec 2025 10:50:52 -0700 Subject: [PATCH 01/41] 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/41] 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/41] 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/41] 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/41] 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/41] 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/41] 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/41] 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/41] 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/41] 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/41] 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/41] [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/41] 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/41] 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/41] [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/41] 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 From d6943868e802f109db94e21ce0b37f4dc486b09f Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 17 Jan 2026 12:37:07 -0500 Subject: [PATCH 17/41] Apply suggestions from code review --- docs/Basic Usage/basic_usage.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 1c28ab49..23480ec7 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -57,13 +57,13 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co 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. +The commands for dictating uppercase 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 +The following commands are available for overriding the default formatting: | Command | Description | | ----------------------------------------- | --------------------------------------------------------- | @@ -84,9 +84,9 @@ 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. -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. +In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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. +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 the up arrow key. 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. @@ -164,8 +164,8 @@ Saying the name of one of these actions followed by the name of a modifier appli | Command | Description | | -------------- | -------------------------------------- | -| `page down` | press the page down key | -| `page up` | press the page up key | +| `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 with the mouse | From 2fc19090e183b1ee5cabc9bd5efc8e0d52d2259c Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 17 Jan 2026 12:37:26 -0500 Subject: [PATCH 18/41] Update docs/Basic Usage/basic_usage.md --- 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 23480ec7..3efe4603 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -90,7 +90,7 @@ Keys can be pressed in dictation mode by saying `press` followed by the key stro 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. +Saying `help special keys` shows the commands for other keys you can press, such as Page Up and Escape. Function keys, like `f1`, can be dictated by saying `f` and then the key number. From 026edcfd77e058a1aa5227dc0385ac7931cbcf2c Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 17 Jan 2026 12:37:36 -0500 Subject: [PATCH 19/41] Update docs/Basic Usage/basic_usage.md --- 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 3efe4603..2040fd11 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -55,7 +55,7 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co #### 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 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. The commands for dictating uppercase letters and numbers are the same as in command mode and are documented in the previous section. From 28820988087f4305c302195b26730155da921495 Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 17 Jan 2026 12:37:44 -0500 Subject: [PATCH 20/41] Update docs/Basic Usage/basic_usage.md --- 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 2040fd11..dc4dd42e 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -82,7 +82,7 @@ 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 the up arrow key. 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 Command key on MacOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` presses the control and 1 keys at the same time. From 83d6f64912eb66ea5ced1c52a679b0e2505613ec Mon Sep 17 00:00:00 2001 From: Samuel Dianda <107892169+FireChickenProductivity@users.noreply.github.com> Date: Sat, 17 Jan 2026 14:23:16 -0700 Subject: [PATCH 21/41] Update docs/Basic Usage/basic_usage.md Co-authored-by: Nicholas Riley --- 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 dc4dd42e..4238b812 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -51,7 +51,7 @@ 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 From d53a36bbcb99d8f8d5789d66a9de481425b6ae40 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 17 Jan 2026 14:36:47 -0700 Subject: [PATCH 22/41] Reserve back tics for spoken forms and tag names --- docs/Basic Usage/basic_usage.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 4238b812..8ab426d5 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -55,13 +55,13 @@ Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in co #### Dictating Characters in Dictation Mode -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. +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. The commands for dictating uppercase 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 overriding the default formatting: @@ -74,7 +74,7 @@ The following commands are available for overriding 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 @@ -82,17 +82,17 @@ 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 the up arrow key. 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 Command key on MacOS. +Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key. 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 theCommand key on MacOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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 the up arrow key. 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. +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 the up arrow key. 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 Page Up and Escape. +Saying `help special keys` shows the commands for other keys you can press, such as Page Up 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 From 83c2f34f10a35205bc5b7c346639da0b909a1b54 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 17 Jan 2026 14:40:27 -0700 Subject: [PATCH 23/41] Document close grid command inside table --- docs/Basic Usage/basic_usage.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 8ab426d5..d769df61 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -250,6 +250,7 @@ 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 | +| `grid close` | close the mouse grid | ### Cursor Hide/Show Commands From 2348c7fd3af56d05ae2af6be173a74342b9fc8c9 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sat, 17 Jan 2026 21:41:15 +0000 Subject: [PATCH 24/41] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- 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 d769df61..1aeabd34 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -250,7 +250,7 @@ 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 | -| `grid close` | close the mouse grid | +| `grid close` | close the mouse grid | ### Cursor Hide/Show Commands From b9bef0a3a4d0a0c7a8474b3a081d1db0ef3511be Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 17 Jan 2026 15:03:03 -0700 Subject: [PATCH 25/41] Document media and tab commands --- docs/Basic Usage/basic_usage.md | 40 +++++++++++++++++---------------- 1 file changed, 21 insertions(+), 19 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 1aeabd34..b34d94b4 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -82,17 +82,17 @@ 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 the up arrow key. 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 theCommand key on MacOS. +Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key. 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 thecommand key on MacOS. -In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` presses the control and 1 keys at the same time. +In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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 the up arrow key. 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. +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 the up arrow key. 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 Page Up 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 @@ -189,15 +189,15 @@ Saying the name of one of these actions followed by the name of a modifier appli #### Working With Tabs -| Command | -| ----------------- | -| `tab new` | -| `tab last` | -| `tab next` | -| `tab close` | -| `tab restore` | -| `go tab ` | -| `go tab final` | +| Command | Description | +| ----------------- | -------------- | +| `tab new` | open a new tab | +| `tab last` | go to the previous tab | +| `tab next` | go to the next tab | +| `tab close` | close the current tab | +| `tab restore` | reopen the most recently closed tab | +| `go tab ` | go to the tab specified by the dictated number | +| `go tab final` | go to the final tab | ## Customize Talon @@ -263,9 +263,11 @@ These commands require activating the `user.mouse_cursor_commands_enable` tag (s ## Working With Media -| Command | -| --------------- | -| `media mute` | -| `play next` | -| `play previous` | -| `media play` | +| Command | Description | +| --------------- | --------------------------------------- | +| `volume mute` | toggle muting sound | +| `volume up` | increase volume | +| `volume down` | decrease volume | +| `play next` | press the next key | +| `play previous` | press the prev key | +| `media play` | play or pause media | From 9906d33bd8756ac6711ce49b8dbb451708650eb7 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sat, 17 Jan 2026 22:03:15 +0000 Subject: [PATCH 26/41] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/Basic Usage/basic_usage.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index b34d94b4..ec5ca6bc 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -189,15 +189,15 @@ Saying the name of one of these actions followed by the name of a modifier appli #### Working With Tabs -| Command | Description | -| ----------------- | -------------- | -| `tab new` | open a new tab | -| `tab last` | go to the previous tab | -| `tab next` | go to the next tab | -| `tab close` | close the current tab | -| `tab restore` | reopen the most recently closed tab | +| Command | Description | +| ----------------- | ---------------------------------------------- | +| `tab new` | open a new tab | +| `tab last` | go to the previous tab | +| `tab next` | go to the next tab | +| `tab close` | close the current tab | +| `tab restore` | reopen the most recently closed tab | | `go tab ` | go to the tab specified by the dictated number | -| `go tab final` | go to the final tab | +| `go tab final` | go to the final tab | ## Customize Talon @@ -263,11 +263,11 @@ These commands require activating the `user.mouse_cursor_commands_enable` tag (s ## Working With Media -| Command | Description | -| --------------- | --------------------------------------- | -| `volume mute` | toggle muting sound | -| `volume up` | increase volume | -| `volume down` | decrease volume | +| Command | Description | +| --------------- | ----------------------------- | +| `volume mute` | toggle muting sound | +| `volume up` | increase volume | +| `volume down` | decrease volume | | `play next` | press the next key | | `play previous` | press the prev key | -| `media play` | play or pause media | +| `media play` | play or pause media | From 4cafed534fd1358610f17afcfeae8fa64d9b5060 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 24 Jan 2026 09:31:13 -0700 Subject: [PATCH 27/41] Document context sensitive dictation and make some refinements --- docs/Basic Usage/basic_usage.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index ec5ca6bc..abb8d7e9 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -76,17 +76,19 @@ The following commands are available for overriding 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". +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. + ## Pressing Keys 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 the up arrow key. 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 thecommand key on MacOS. +Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key. 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 theCommand key on MacOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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 the up arrow key. 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. +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 the up arrow key ⇧. 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. From dc502fb7599ebe629e030c6b170cdd668bd22502 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 24 Jan 2026 09:55:20 -0700 Subject: [PATCH 28/41] Remove arrow --- 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 abb8d7e9..a7aa3215 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -88,7 +88,7 @@ Keys can be combined with modifier keys, i.e., saying `shift up` presses Sh In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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 the up arrow key ⇧. 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. +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 the up arrow key. 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. From 54ac9de120853772bdb20584654dd58abd43d8bc Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 24 Jan 2026 09:56:09 -0700 Subject: [PATCH 29/41] Put the up arrow key back --- 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 a7aa3215..abb8d7e9 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -88,7 +88,7 @@ Keys can be combined with modifier keys, i.e., saying `shift up` presses Sh In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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 the up arrow key. 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. +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 the up arrow key ⇧. 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. From a99f61a857d444d0c214ce2b8767938163131205 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Sat, 24 Jan 2026 09:58:08 -0700 Subject: [PATCH 30/41] Add the other arrow key --- 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 abb8d7e9..643bc794 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -84,7 +84,7 @@ 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 the up arrow key. 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 theCommand key on MacOS. +Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key ⇧. 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 theCommand key on MacOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` presses the control and 1 keys at the same time. From 49f37949d3e301f2961757ae96978decf37902e1 Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 31 Jan 2026 12:47:41 -0500 Subject: [PATCH 31/41] Apply suggestions from code review --- docs/Basic Usage/basic_usage.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 643bc794..0fdf3785 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -35,7 +35,7 @@ To keep track of what mode you are in with a visual icon, enable the [mode indic ### Formatters -Say a formatter then the text. (i.e. `say "hello world"`) to dictate while in command mode +Say a formatter then the text. (i.e. `say hello world`) to dictate while in command mode | Formatter | Description | | ----------------- | --------------------------------------- | @@ -61,7 +61,7 @@ The commands for dictating uppercase letters and numbers are the same as in comm ### 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 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". The following commands are available for overriding the default formatting: @@ -80,15 +80,13 @@ To improve automatic spacing and capitalization in dictation mode, you can enabl ## Pressing Keys -Saying `help alphabet` shows the command for each letter key. +In command mode, saying `help alphabet` shows spoken forms for letter keys. Saying `help symbols` shows spoken forms for symbol keys. -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 the up arrow key ↑. 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 Command key on MacOS. -Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key ⇧. 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 theCommand key on MacOS. +In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` presses the Control and 1 keys at the same time. -In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` 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 the up arrow key ⇧. 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. +Keys can be pressed in dictation mode by saying `press` followed by the keystroke, such as saying `press shift up` to press Shift and the up arrow key ↑. 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. From e68c6f0dce88f6201e3ba632c6ff8eed6b5eb4f9 Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 2 Feb 2026 19:56:27 -0700 Subject: [PATCH 32/41] Explain unprefixed numbers --- docs/Basic Usage/basic_usage.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 0fdf3785..1ac702c1 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -53,6 +53,8 @@ Say a formatter then the text. (i.e. `say hello world`) to dictate while in comm `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". +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). + #### Dictating Characters in Dictation Mode 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. From c899c46f15352b1a20bf2d1902c80b8981a5c0ac Mon Sep 17 00:00:00 2001 From: Fire Chicken Date: Mon, 2 Feb 2026 20:26:32 -0700 Subject: [PATCH 33/41] Explain prose formatters --- docs/Basic Usage/basic_usage.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 1ac702c1..5fe80369 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -47,6 +47,17 @@ Say a formatter then the text. (i.e. `say hello world`) to dictate while in comm | `kebab` | dashes instead of spaces | | `help formatters` | show all available formatters | +`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. + +| Prose formatting options | Description | +| ----------------- | --------------------------------------- | +| `cap` | capitalize the next word | +| `no cap` or `no caps` | the next word is in lowercase | +| `no space` | no space is inserted before the next word | +| `numb ` | insert the specified number | + +These formatting options are also available in dictation mode with the same effects. + ### Dictating Individual Characters #### Dictating Characters in Command Mode From 98223b926b03fab4723cd8ce6adc8197603f97be Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Tue, 3 Feb 2026 03:34:45 +0000 Subject: [PATCH 34/41] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/Basic Usage/basic_usage.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/Basic Usage/basic_usage.md b/docs/Basic Usage/basic_usage.md index 5fe80369..390ea88a 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -47,16 +47,16 @@ Say a formatter then the text. (i.e. `say hello world`) to dictate while in comm | `kebab` | dashes instead of spaces | | `help formatters` | show all available formatters | -`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. +`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. -| Prose formatting options | Description | -| ----------------- | --------------------------------------- | -| `cap` | capitalize the next word | -| `no cap` or `no caps` | the next word is in lowercase | -| `no space` | no space is inserted before the next word | -| `numb ` | insert the specified number | +| Prose formatting options | Description | +| ------------------------ | ----------------------------------------- | +| `cap` | capitalize the next word | +| `no cap` or `no caps` | the next word is in lowercase | +| `no space` | no space is inserted before the next word | +| `numb ` | insert the specified number | -These formatting options are also available in dictation mode with the same effects. +These formatting options are also available in dictation mode with the same effects. ### Dictating Individual Characters @@ -64,7 +64,7 @@ These formatting options are also available in dictation mode with the same effe `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". -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). +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). #### Dictating Characters in Dictation Mode From fcfd9830bdb5911ebeb1baa85817ec0e28249f8d Mon Sep 17 00:00:00 2001 From: Samuel Dianda <107892169+FireChickenProductivity@users.noreply.github.com> Date: Sat, 7 Feb 2026 09:26:35 -0700 Subject: [PATCH 35/41] Apply suggestion from @chdoc Co-authored-by: Christian Doczkal <20443222+chdoc@users.noreply.github.com> --- 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 390ea88a..d42e6117 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -274,7 +274,7 @@ The mouse grid lets you move the mouse by dictating numbers. You use one of the These commands require activating the `user.mouse_cursor_commands_enable` tag (see Community settings.talon). -## Working With Media +## Media and Volume Control | Command | Description | | --------------- | ----------------------------- | From 71d4af24baa1cf5ff5c2f22943d7223a6ff696c1 Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 7 Feb 2026 13:02:21 -0500 Subject: [PATCH 36/41] Update docs/Basic Usage/basic_usage.md --- 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 d42e6117..34c0526a 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -35,7 +35,7 @@ To keep track of what mode you are in with a visual icon, enable the [mode indic ### Formatters -Say a formatter then the text. (i.e. `say hello world`) to dictate while in command mode +Say a formatter then the text. (e.g., `say hello world`) to dictate while in command mode | Formatter | Description | | ----------------- | --------------------------------------- | From 1d35b45ff38b0cb9e02cdc7bba5af34802955d2e Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 7 Feb 2026 13:02:33 -0500 Subject: [PATCH 37/41] Update docs/Basic Usage/basic_usage.md --- 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 34c0526a..25a24709 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -95,7 +95,7 @@ To improve automatic spacing and capitalization in dictation mode, you can enabl In command mode, saying `help alphabet` shows spoken forms for letter keys. Saying `help symbols` shows spoken forms for symbol keys. -Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key ↑. 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 Command key on MacOS. +Keys can be combined with modifier keys, i.e., saying `shift up` presses Shift and the up arrow key ↑. 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 Command key on macOS. In a keystroke, number keys can be dictated without prefix. For instance, saying `control one` presses the Control and 1 keys at the same time. From 8dbe5764c7af5fc0fca871d777898c39e7c69e7f Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 7 Feb 2026 13:02:42 -0500 Subject: [PATCH 38/41] Update docs/Basic Usage/basic_usage.md --- 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 25a24709..e7a0f03f 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -101,7 +101,7 @@ In a keystroke, number keys can be dictated without prefix. For instance, saying Keys can be pressed in dictation mode by saying `press` followed by the keystroke, such as saying `press shift up` to press Shift and the up arrow key ↑. 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 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. Saying `help special keys` shows the commands for other keys you can press, such as Page Up and Escape. From f2c251277cbbe5dbb2632d3f8c335fa0caed3976 Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 7 Feb 2026 13:02:50 -0500 Subject: [PATCH 39/41] Update docs/Basic Usage/basic_usage.md --- 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 e7a0f03f..fd32179e 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -103,7 +103,7 @@ Keys can be pressed in dictation mode by saying `press` followed by the keystrok 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. -Saying `help special keys` shows the commands for other keys you can press, such as Page Up and Escape. +Saying `help special keys` shows spoken forms for other keys you can `press`, such as Page Up and Escape. Function keys, like f1, can be dictated by saying `f` and then the key number. From ca15bfcba3f6f0a8c3a8dfd18f441d668a812872 Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 7 Feb 2026 13:02:59 -0500 Subject: [PATCH 40/41] Update docs/Basic Usage/basic_usage.md --- 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 fd32179e..32eaa959 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -136,7 +136,7 @@ For example, saying `go up 10 lines` moves the cursor up 10 lines. #### 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. +Command mode provides flexible editing and navigation commands. 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. From ccfed2a9351c469348f1009154f87d32389f3cf3 Mon Sep 17 00:00:00 2001 From: Nicholas Riley Date: Sat, 7 Feb 2026 13:03:06 -0500 Subject: [PATCH 41/41] Update docs/Basic Usage/basic_usage.md --- 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 32eaa959..0029677b 100644 --- a/docs/Basic Usage/basic_usage.md +++ b/docs/Basic Usage/basic_usage.md @@ -138,7 +138,7 @@ For example, saying `go up 10 lines` moves the cursor up 10 lines. Command mode provides flexible editing and navigation commands. -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. +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. | Action | Description | | --------- | ------------------------------------------------- |