iComand Files

This is README file for iComand.
iComand home page: http://icomand.sourceforge.net
Copyright 2009 Ajibola Aiyedogbon (ajibolaaiyedogbon@yahoo.com)

	 
1	Hardware Requirements

•	At least 512 MB of RAM should be available on the system. Although the application takes up about 200MB, there should be enough for smooth operations. 
•	The CPU should have a speed of at least 1.6GHz.
•	An AC’97 compatible sound card with the latest driver installed.
•	A microphone that is ideal for speech, with a boom (extended mouth piece).

2	Assumptions and Dependencies

•	MS Windows operating system
•	Java JVM Version 1.6 Update 11
•	Sphinx 4 libraries (included)
•	FreeTTS libraries (included)
•	Java Speech API setup
•	Configured Microphone

3	How to Install
In order to setup and run this program, a user will need to have the following steps: 

1.	Install Microsoft Windows 2000 or newer version of Operating System.
2.	Install the Java Runtime Environment version 1.6.11.
3.	Copy the files from the libraries folder into the lib folder of iComand (~:iComand\lib).
4.	Ensure there is a data folder in the program folder (~:iComand\data)
5.	Run the microphone setup wizard from Control Panel -> Sound and Devices -> Voice; 
6.	Increase the microphone volume, and select boost mic from advanced settings.

4. How to Use

   When the program runs, you see the GUI with 4 main buttons:-
   
   Record - This is used to initialize recording of user actions, and the recording will continue forever until when stopped.
   Stop	  - This is used to explicitly stop the recording of user actions taken from the mouse and keyboard.
   Play   - This is used to replay a specific command file.
   View Commands - This is used to open the available commands list.
   
   When the command list is open, you can interact with elements of the list by first left clicking to select, 
   and then right clicking to reveal the popup menu.
   
5. List of Voice Commands recognized

   The program can be interacted with using only voice commands. A speech recognition microphone and proper diction would 
   help improve recognition results.
   
   Begin Recording - This is same as pressing the Record button.
   Finish Recording - This is same as pressing the stop button.
   Play File - This is same as pressing the Play button.
   Show Commands - This is same as pressing the View Commands button.
   Close Commands - This disposes of the command list window.
   Delay Operation - This pauses the currently running operation.
   Resume Operation - This resumes the previously running operation.
   Finish Operation - This terminates the currently running operation.
   
   A previously stored command name can be recalled only by saying the voice command. A confirmation prompt will come up,
   and there is a 3 second timeout associated with it. You can either say YES to accept or NO to reject the execution of 
   the command. 
   
   While a command is running, you can wiggle the mouse pointer and it will be interrupted. 
   You can include a request for a time delay, or discarding the mouse position (for keyboard operations) from the command properties window.