SourceGetting started
Introduction
Overview
Talon aims to bring programming, realtime video gaming, command line, and full desktop computer proficiency to people who have limited or no use of their hands, and vastly improve productivity and wow-factor of anyone who can use a computer.
Join the Slack to talk, get hyped, or for help with Talon.
NOTE: This Talon release is very new and is not fully documented yet! Please ask any questions in the #help channel on the Slack linked above.
- System requirements:
Windows 8 or newer
macOS High Sierra (10.13) or newer
Linux / X11 (Ubuntu 18.04+, and most modern distros if you switch to an X11 session). Wayland compositors lack the APIs necessary for Talon and Wayland support is not planned.
Powerful voice control - Talon comes with a free speech recognition engine, and it is also compatible with Dragon with no additional setup.
Multiple algorithms for eye tracking mouse control (depends on a single Tobii 4C, Tobii 5 or equivalent eye tracker)
Noise recognition system (pop and hiss). Many more noises coming soon.
Scriptable with Python 3 (via embedded CPython, no need to install or configure Python on your host system).
Talon is very modular and adaptable - you can use eye tracking without speech recognition, or vice versa.
Getting Started
Download and install Talon for your operating system.
Run the Talon app.
Open the Talon Home directory. This is
%APPDATA%\Talonon Windows, and~/.talonon macOS/Linux. (Talon has a menu in your system tray near the clock, you can useScripting -> Open ~/.talonas a shortcut open Talon Home).Add some scripts to
~/.talon/userto add voice commands and other behaviour to Talon (see the Getting Scripts section below). Your user scripts control all of the voice commands in Talon, so Talon won’t recognize any commands until you add some scripts.Install Conformer using Talon’s Speech Recognition menu.
Go to
Scripting -> View Login the menu for debug output, orScripting -> Open REPLfor a Python command line.
Getting Scripts
The best way to get started right now is to clone talonhub/community into your ~/.talon/user directory. Ask in #help on Slack if you run into any problems.
Learning Talon
These are some resources to help you learn to use and customize Talon:
Where to Find Things in Talon
The Talon Menu
You can open the Talon menu when Talon is running by clicking the Talon icon.

The location of the icon depends on your operating system. - macOS: you can find the icon on the top of the screen in the menubar. If you have too many apps with menubar icons, the Talon icon may not be visible. - Windows: you can find the Talon icon in the tray icons by clicking an upward pointing arrow in the bottom right of the screen. - Linux: This will depend on your distro.
Features available in the menu include: the ability to quit Talon, turning speech recognition on and off, picking the speech engine, and picking the microphone.
Talon Home Directory
The Talon home directory has your Talon related files. You can open the Talon home directory from the Talon menu by clicking Scripting and then the first option from the top of the Scripting menu. The text will depend on your operating system but will start with Open.
If you choose to save recordings through the Talon menu, you can find them in the recordings subdirectory.
Talon configuration files go in the user subdirectory. This will include all of your voice commands and any custom scripts.