From 512edf978cac3b6ba21d2b805c2a9eb51147c0aa Mon Sep 17 00:00:00 2001
From: ronzulu <75528127+ronzulu@users.noreply.github.com>
Date: Tue, 1 Oct 2024 15:42:56 +1000
Subject: [PATCH 1/3] First pass
---
docs/Quickstart/Hardware/hardware.md | 10 ++-
docs/Quickstart/getting_started.md | 81 +++++++++++++++----
docs/Quickstart/troubleshooting.md | 2 +-
static/img/talon_menu_speech_recognition.png | Bin 0 -> 23395 bytes
4 files changed, 77 insertions(+), 16 deletions(-)
create mode 100644 static/img/talon_menu_speech_recognition.png
diff --git a/docs/Quickstart/Hardware/hardware.md b/docs/Quickstart/Hardware/hardware.md
index 84bab2fd..e61c5ac5 100644
--- a/docs/Quickstart/Hardware/hardware.md
+++ b/docs/Quickstart/Hardware/hardware.md
@@ -1,4 +1,12 @@
-# Hardware
+# Hardware & OS
+
+## Operating System
+
+| System | Requirement |
+| ------------- | -------------------------------------------------------------------------------------------- |
+| `macOS` | High Sierra (10.13) or newer. Talon is a universal2 build with native Apple Silicon support. |
+| `Linux / X11` | (Ubuntu 18.04+, and most modern distros), Wayland support is currently limited to XWayland |
+| `Windows` | Windows 8 or newer |
## Microphones
diff --git a/docs/Quickstart/getting_started.md b/docs/Quickstart/getting_started.md
index 5b57bc3f..230c4454 100644
--- a/docs/Quickstart/getting_started.md
+++ b/docs/Quickstart/getting_started.md
@@ -4,44 +4,97 @@ sidebar_position: 1
# Getting Started
-:::note
+## 1: Check System Requirements
-You can also install and run Talon by following the [official installation instructions](https://talonvoice.com/docs/). This info supplements that page.
+Talon has various [system requirements](Hardware/hardware.md), covering the computer hardware, operating system and microphone hardware.
-:::
-## 1: [Download Talon](https://talonvoice.com/)
+## 2: Download & Install Talon
- Notes for Linux Users
- - Talon, like many tools for automation or accessibility, __does not support Wayland__
+ Linux Users
+ - Download [Talon for Linux](https://talonvoice.com/dl/latest/talon-linux.tar.xz)
+ - Install by **To be completed**
+
+:::note
+- Talon, like many tools for automation or accessibility, __does not support Wayland__
- You will have to select an X11 session from your login manager.
- This is supported by Gnome and Plasma and many others, but some environments like sway are explicitly Wayland-only.
- To install the speech engine, you must use Talon's tray icon:
* If you use stock Gnome, you need to install [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) to see it
* If you use i3 or a system tray that doesn't support the `StatusNotifierItem` protocol, install [snixembed](https://git.sr.ht/~steef/snixembed) to add support.
+:::
+
+
+
+
+ Mac Users
+ - Download [Talon for Mac](https://talonvoice.com/dl/latest/talon-mac.dmg)
+ - Install by **To be completed**
+
+
+
+
+ Windows Users
+ - Download [Talon for Windows](https://talonvoice.com/dl/latest/talon-windows.exe)
+ - Install Talon by running `talon-windows.exe`
+
+:::note
+It is recommended that Talon is installed as described above.
+However, please note that the application is also available as a [portable zip file](https://talonvoice.com/dl/latest/talon-windows.zip)
+:::
+
+
+
+
+
+## 3: Install a speech recognition engine
+
+Talon uses a local speech recognition engine that translates voice audio to text.
+
+One recognition engine that comes with Talon is known as `Conformer D`. To install it:
+- Run the Talon app
+- Click the Talon tray icon and select `Speech Recognition → Conformer D`.
+
+
+ Screenshot
+
-## 2: Install a speech recognition engine
+:::note
+For other engine options, see the [speech engine page](./Speech%20Engines/speech%20engines.md)
+:::
+
+## 4: Install a Talon user file set
+
+:::important
+Talon does not come with voice commands out of the box. So at this point in the installation process,
+Talon can not do anything useful.
-Talon uses a local speech recognition engine that translates voice audio to text. To install your speech engine, click the Talon tray icon and select `Speech Recognition → Conformer D`. For other engine options, see the [speech engine page](./Speech%20Engines/speech%20engines.md)
+It requires a `user file set` and
+for beginners, we strongly recommend that you use the [Talon Community](https://github.com/talonhub/community) user file set.
-## 3: Install a Talon user file set
+The whole wiki assumes this repository is used if not otherwise noted.
+:::
-Talon does not come with voice commands out of the box. To start, we strongly recommend that you use the [Talon Community](https://github.com/talonhub/community) user file set. The whole wiki assumes this repository is used if not otherwise noted.
See the [Talon Community README](https://github.com/talonhub/community?tab=readme-ov-file#installation) for installation instructions.
-In addition to [Talon Community](https://github.com/talonhub/community), you may want to consider installing any of the [essential Talon integrations](../Integrations/essential-tools.md)
-## 4: Test your Talon Setup
+
+## 5: Test your Talon Setup
- Try a few [basic commands](../Basic%20Usage/basic_usage.md).
+
+## 6: Next steps
+
- If needed, try ways to [improve recognition accuracy](improving_recognition_accuracy.md)
- [Customize Talon](../Customization/basic_customization.md): learn about how to configure Talon to your liking.
+- In addition to [Talon Community](https://github.com/talonhub/community), you may want to consider installing any of the [essential Talon integrations](../Integrations/essential-tools.md)
+- If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.
- For earlier access to new features, priority support, and access to additional [speech engines](./Speech%20Engines/speech%20engines.md), install the [beta version](beta_talon.md).
-## Join the Talon Slack
-If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.
diff --git a/docs/Quickstart/troubleshooting.md b/docs/Quickstart/troubleshooting.md
index 3f798d8e..fa56da2b 100644
--- a/docs/Quickstart/troubleshooting.md
+++ b/docs/Quickstart/troubleshooting.md
@@ -49,7 +49,7 @@ After you have started the Talon application, look for the Talon icon in the men
Talon's icon should show up in the menu bar in the upper right corner of your screen:
diff --git a/static/img/talon_menu_speech_recognition.png b/static/img/talon_menu_speech_recognition.png
new file mode 100644
index 0000000000000000000000000000000000000000..973605b999019efc9592c82be15a7987aa3e60a2
GIT binary patch
literal 23395
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
We`tK^DUh0dL|4l|vryydzyAaBD`1=e
literal 0
HcmV?d00001
From 56259bbe3d7dd497229f37680a8fee1bddaac24a Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
<66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 1 Oct 2024 06:11:31 +0000
Subject: [PATCH 2/3] [pre-commit.ci] auto fixes from pre-commit.com hooks
for more information, see https://pre-commit.ci
---
docs/Quickstart/getting_started.md | 33 ++++++++++++------------------
1 file changed, 13 insertions(+), 20 deletions(-)
diff --git a/docs/Quickstart/getting_started.md b/docs/Quickstart/getting_started.md
index 230c4454..bfd71e96 100644
--- a/docs/Quickstart/getting_started.md
+++ b/docs/Quickstart/getting_started.md
@@ -8,7 +8,6 @@ sidebar_position: 1
Talon has various [system requirements](Hardware/hardware.md), covering the computer hardware, operating system and microphone hardware.
-
## 2: Download & Install Talon
@@ -17,13 +16,14 @@ Talon has various [system requirements](Hardware/hardware.md), covering the comp
- Install by **To be completed**
:::note
-- Talon, like many tools for automation or accessibility, __does not support Wayland__
- - You will have to select an X11 session from your login manager.
- - This is supported by Gnome and Plasma and many others, but some environments like sway are explicitly Wayland-only.
-- To install the speech engine, you must use Talon's tray icon:
- * If you use stock Gnome, you need to install [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) to see it
- * If you use i3 or a system tray that doesn't support the `StatusNotifierItem` protocol, install [snixembed](https://git.sr.ht/~steef/snixembed) to add support.
-:::
+
+- Talon, like many tools for automation or accessibility, **does not support Wayland**
+ - You will have to select an X11 session from your login manager.
+ - This is supported by Gnome and Plasma and many others, but some environments like sway are explicitly Wayland-only.
+- To install the speech engine, you must use Talon's tray icon:
+ - If you use stock Gnome, you need to install [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) to see it
+ - If you use i3 or a system tray that doesn't support the `StatusNotifierItem` protocol, install [snixembed](https://git.sr.ht/~steef/snixembed) to add support.
+ :::
@@ -40,22 +40,20 @@ Talon has various [system requirements](Hardware/hardware.md), covering the comp
- Install Talon by running `talon-windows.exe`
:::note
-It is recommended that Talon is installed as described above.
+It is recommended that Talon is installed as described above.
However, please note that the application is also available as a [portable zip file](https://talonvoice.com/dl/latest/talon-windows.zip)
:::
-
-
-
## 3: Install a speech recognition engine
Talon uses a local speech recognition engine that translates voice audio to text.
One recognition engine that comes with Talon is known as `Conformer D`. To install it:
+
- Run the Talon app
-- Click the Talon tray icon and select `Speech Recognition → Conformer D`.
+- Click the Talon tray icon and select `Speech Recognition → Conformer D`.
Screenshot
@@ -64,7 +62,7 @@ One recognition engine that comes with Talon is known as `Conformer D`. To insta
/>
-:::note
+:::note
For other engine options, see the [speech engine page](./Speech%20Engines/speech%20engines.md)
:::
@@ -75,16 +73,13 @@ Talon does not come with voice commands out of the box. So at this point in the
Talon can not do anything useful.
It requires a `user file set` and
-for beginners, we strongly recommend that you use the [Talon Community](https://github.com/talonhub/community) user file set.
+for beginners, we strongly recommend that you use the [Talon Community](https://github.com/talonhub/community) user file set.
The whole wiki assumes this repository is used if not otherwise noted.
:::
-
See the [Talon Community README](https://github.com/talonhub/community?tab=readme-ov-file#installation) for installation instructions.
-
-
## 5: Test your Talon Setup
- Try a few [basic commands](../Basic%20Usage/basic_usage.md).
@@ -96,5 +91,3 @@ See the [Talon Community README](https://github.com/talonhub/community?tab=readm
- In addition to [Talon Community](https://github.com/talonhub/community), you may want to consider installing any of the [essential Talon integrations](../Integrations/essential-tools.md)
- If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.
- For earlier access to new features, priority support, and access to additional [speech engines](./Speech%20Engines/speech%20engines.md), install the [beta version](beta_talon.md).
-
-
From f2c4ba8ebcd64d651e38b5457456648793ac8fea Mon Sep 17 00:00:00 2001
From: ronzulu <75528127+ronzulu@users.noreply.github.com>
Date: Tue, 1 Oct 2024 19:13:44 +1000
Subject: [PATCH 3/3] Attempt to fix: Expected the closing tag ``
either after the end of `directiveContainer`
---
docs/Quickstart/getting_started.md | 6 ------
1 file changed, 6 deletions(-)
diff --git a/docs/Quickstart/getting_started.md b/docs/Quickstart/getting_started.md
index 230c4454..b94d86a8 100644
--- a/docs/Quickstart/getting_started.md
+++ b/docs/Quickstart/getting_started.md
@@ -15,7 +15,6 @@ Talon has various [system requirements](Hardware/hardware.md), covering the comp
Linux Users
- Download [Talon for Linux](https://talonvoice.com/dl/latest/talon-linux.tar.xz)
- Install by **To be completed**
-
:::note
- Talon, like many tools for automation or accessibility, __does not support Wayland__
- You will have to select an X11 session from your login manager.
@@ -24,27 +23,22 @@ Talon has various [system requirements](Hardware/hardware.md), covering the comp
* If you use stock Gnome, you need to install [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) to see it
* If you use i3 or a system tray that doesn't support the `StatusNotifierItem` protocol, install [snixembed](https://git.sr.ht/~steef/snixembed) to add support.
:::
-
Mac Users
- Download [Talon for Mac](https://talonvoice.com/dl/latest/talon-mac.dmg)
- Install by **To be completed**
-
Windows Users
- Download [Talon for Windows](https://talonvoice.com/dl/latest/talon-windows.exe)
- Install Talon by running `talon-windows.exe`
-
:::note
It is recommended that Talon is installed as described above.
However, please note that the application is also available as a [portable zip file](https://talonvoice.com/dl/latest/talon-windows.zip)
:::
-
-