Skip to content

Latest commit

 

History

History
96 lines (64 loc) · 5.42 KB

Installation.md

File metadata and controls

96 lines (64 loc) · 5.42 KB
Raw

Installation

YouTube Videos

Introduction

Caster currently supports the following speech recognition engines on Microsoft Windows Vista through Windows 10.

  • Windows Speech Recognition (WSR)
  • Dragon NaturallySpeaking (DNS) - *Caster only supports Dragon NaturallySpeaking 13 or higher.

1. Python

Make sure to select Add python to path. This can be done manually by searching for "edit environment variables for your account" and adding your Python27 folder to the list of Path values

2. NatLink

3. Caster

Third Download Caster and install dependencies.

  1. Download Caster from master branch. Note If you plan to develop Caster use the development branch.
  2. Open up the zip file downloaded
  3. Click on the file caster-master or caster-develop . Note Choose based on your speech recognition engine.
    • Dragon NaturallySpeaking (DNS) copy and paste its contents into An empty folder, this can be any folder but it is common to use user\Documents\NatLink.
    • Windows Speech Recognition (WSR) copy and paste its contents to a new folder. Suggested locations would be a folder on the desktop for ease of access.
  4. Check and install Caster dependencies by clicking on Pip Install Dependencies.bat in \caster\bin\inno\dependencies
    • This can be done manually by pip install dragonfly2, wxpython, pillow, future, toml

4. Setup and launch

  • Dragon NaturallySpeaking
    1. Open the start menu and search for "natlink", click the file called "Configure NatLink via GUI" and run it using python 2.7.
    2. Ensure that the details of your DNS setup are correct in the "info" tab.
    3. In the "configure" tab, under "NatLink" and "UserDirectory" click enable. When you are prompted for a folder, give it the location of your caster folder from step three (user\Documents\NatLink\caster-master).
    4. Reboot Dragon. NatLink should load at the same time, with caster commands available. To test this, open a notepad window and try saying "arch brov char delta".
  • Windows Speech Recognition double click on _caster.pyand it will launch WSR. Note Depending on your file associations it may launch an editor instead of running the file. Run the file using command prompt. Detailed instructions below.
    1. Change the directory to the to the file path you created in the step above. If the folder <YourFile> was named caster-master. Example cd C:\Users\<YourUsername>\Desktop\caster-master\
    2. Then python _caster.py

Troubleshooting FAQ

  • Commands work in some applications but not others that are supported by Caster. To fix verify that the program is not running an administrator/elevated privileges.

    Dragonfly grammars cannot interact with programs that have administrator/elevated privileges. A documented Proof of Concept work around but the project needs an active developer with C#.

  • Running "Configure NatLink via GUI" does not bring up the settings window - try running the program as an administrator:

    1. Open an administrator command prompt by searching for "cmd" in start and either right click, run as administrator or ctrl-shift-enter.
    2. Change directory to the folder where start_configurenatlink.py was installed. This is likely to be C:\NatLink\NatLink\confignatlinkvocolaunimacro so the command would be cd C:\NatLink\NatLink\confignatlinkvocolaunimacro.
    3. Run python start_configurenatlink.py.

  • To fix ImportError: No module named win32con Package win32con is out of date or not installed. Try pip install pywin32 Alternatively if the error persists use the Windows installer

  • To fix lost sys.stder use pywin32 for system wide features, such as registering COM objects or implementing Windows Services. So you must run the following command from an elevated command prompt:

python C:\Python27\Scripts\pywin32_postinstall.py -install

  • To fix ImportError: cannot import name RuleWrap

    ​ You likely either have the wrong version of Dragonfly installed, or don't have it installed at all. RuleWrap is a Dragonfly import. Try pip uninstall dragonfly (it's okay if it doesn't find the package) then pip install dragonfly2.

Extra information

Castor dependencies --installed by Dragonfly

  • pywin32
  • dragonfly2
  • setuptools
  • six
  • pyperclip
  • enum34
  • comtypes
  • regex

--installed by Caster

  • wxpython
  • pillow
  • toml
  • future

Alternative Speech Secognition Engines.

CMU Pocket Sphinx Install Instructions for dragonfly - Linux only - Currently not supported Caster but it is a work in progress.