Dkey allows entering of text using a limited number of input keys or buttons. It speaks the text as it entered and on being accepted is pasted into the Window with focus as if it had been entered directly with the keyboard. At this version text input is via the keyboard numeric keypad and settings are done via the pointer.

Speech is provided using  the current WIndows Speech voice. XP and Vista each come with a sample voice already installed and others can be obtained (look for SAPI 5 voices).

Dkey has been tested on Windows XP and Vista and required numeric keypad as provided on desktop keyboards  (laptops can be a problem) or On Screen Keyboard programs like Grid 2.

DKey is Open Source Software and is Licensed under the GPL (2).

Installing

Download the latest installer from the Files section of this space and run it (e.g DKey-0.0.3.exe). This will create a Dkey item in the Start menu and optionally on the desktop and/or quick launch bar.

Settings

You can get at the settings by right clicking in the space between buttons (and right clicking again to return). Options are

• Font - used for all text in Dkey
• Text colour & BG colour - text and background colours for text in Dkey
• Sel Text colour & Sel BG colour - for selected items in the wordlist
• Spell, Say word, spell and Word - how words are spoken as they are formed (are always spoken in full when accepted)
• Show Labels & Hide Labels  - show or hide labels above Text Output and Word List

You can also change the size and postion of the DKey window by dragging as usual. The size of the Text Output and world list controls can be altered by dragging the ...... markers next to them. All settings are rembered.

Speech can be adjusted using the windows settinsg using the link in Start menu -> Dkey or through WIndows' Control Panel -> Speech -> Text to Speech.

The current settings are stored in a file .dkeyrc that can be found in C:\Documents and Settings\<Username>\Application Data\Dkey (also known as %appdata%\DKey). It is hand editable and can be deleted to reset to defaults.

Operation

Run DKey and adjust settings as above (you may get no speech the very first time you run DKey, so try running again before looking for sound problems) . Run the program you want to enter text into and ensure the correct window has focus (has blinking I in it). Dkey remains floating above all other Windows.

Ensure Num Lock is on so the keypad acts as numbers and not cursor movement. Use the number pad to operate. Keys are as follows.

7 - abc        8 - def       9 - ghi

4 - jkl        5 - mno     6 - pqrs

1 - tuv        2 - wxyz      3  -  .

0 - Accept    Del - Delete  + - Next in list

As you type letters a selection of possible words are presented in the word list window. The top one is selected and spoken. You can use '+ next' to select other words. '0 - Accept' is used to type the word in the other program and also empties the output window and wordlist. Use '3 .' to end the sentence, using . ! or ? as available in the Word List window.

Word lists

The words that DKey makes available are generate from the file wordlist.txt. You can edit this and then run the program 'make_dict' which you can find in C:\Program Files\DKey. Exit Dkey befoe you do this.

The default worlds list contains a lot of words but a much smaller one is also provided as wordlist2.txt. In order to use this rename it to be wordlist.txt and then run 'make_dict' (rename wordlist.txt first).

Developer Notes

You can get the latest source from Subversion and can run dkey.py directly.

You will need the following Python modules:

• pywin32
• pyhook
• pygtk
• gladewin32
• SendKeys

The installer is created by running mkdkey.bat and you will need py2exe and Inno Setup (don't forget to edit the version number in setup.py and dkey.iss).