whatido :Presentation of the application

General information

It is a utility that allows you to see on the screen the actions you do on the mouse (click / right / left / middle and the actions forward / back on the wheel of the mouse as well as actions on the keyboard (except numeric keypad).

The visualization is done through 2 transparent images of the mouse and the keyboard which remains in window always visible (except for some contextual menus where Windows is priority, but it is not very inconvenient).

The software also works on Linux and certainly also on OS X (not tested by me on OS X, keyboard mapping to do), see in the appendix of this document how to realize a complete mapping if this software does not work correctly with your Micro / OS / keyboard. There may be deviations from the Windows / AZERTY mapping .

This software is based on the Library JNativeHook available at Github site : https://github.com/kwhat/jnativehook

The binary code is avaible on Maven Repo, I use the Version 2.1.0 :

https://mvnrepository.com/artifact/com.1stleg/jnativehook/2.1.0

A video showing whaido at work : https://youtu.be/UVeElF26KB8

An overview of the product on this document

The launch screen, which will be explained in detail later in the document .

An image of the product in action:

We see a blue round on the Print-Screen key when I made the screenshot!

You can choose whether to display the keyboard or not, you can activate the sound that describes the actions performed on the mouse and keyboard. There 3 sizes for the image of the Keyboard ( Normal, Medium, Small), usefull for learnig keystroke to beginners.

For the mouse, there are 4 sizes to choose from (Large, Medium, Small, Tiny) and being mobile for the 3 smallest sizes and being fixed for the 3 largest sizes.

For mice of the fixed type, the black button in the middle makes it possible to move it in another part of the screen when it impedes.

Use cases of the product

Whatido works well with video projectors.

Possible uses are:

• Introduction to computers for the presentation of mouse actions and the keyboard

• Live software presentation by viewing all mouse and keyboard actions

  • ex : Navigation in file explorer, copying / pasting mechanisms, use of office tools ...

• Creation of video tutorials by recording the screen with whatido activated.

Tip: you can run the product twice:

• Once with a fixed Large or Medium mouse

• The other time with the Tiny / Mobile mouse that will follow the Windows cursor during its movements.

The two mice will show the actions performed.

Limitation with Powerpoint in Slideshow mode, the product (mouse image and / or keyboard image) does not appear in the foreground and can not be used in this case, it is necessary to remain in editing mode.

Installation

Prerequisites

Whatido requires the presence of a recent Java Virtual Machine version greater than 1.8.0_121.
The 32-bit JRE version can be installed from the Oracle site:

http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html

Check the acceptation of the License.

Choose the 32-bit version download (i586)

After downloading, it will be necessary to launch the corresponding .exe file in administrator mode (right click on the file, and choose launch in administrator mode). The version must be the last available version on Oracle site.

Once installed, you should be able to see your JRE as shown below:

Installation of Whatido

The product is in the form of a zip whatido archive <Version> Exe.zip ex whatido3Exe.zip this archive is available at the root of https://github.com/PASTJL/whatido3

We assume for the rest of the installation that there is a C: \opt directory on your computer, otherwise you will create it or you will adapt the procedure described below.

• Position the whatido3Exe.zip archive under C:\opt and unzip

• Open the file C:\opt\whatido\script\whatido.cmd and adapt paths to red

Set PROJECT_HOME=C:\opt\whatido

Set CLASSPATH=%PROJECT_HOME%\lib\jnativehook-2.1.0.jar;.;%PROJECT_HOME%\lib\whatido-3.0.0.jar;

Set JAVA_HOME=C:\Program Files (x86)\Java\jre1.8.0_121\bin

start "" "%JAVA_HOME%\javaw" -Droot=%PROJECT_HOME% -Dhome=%PROJECT_HOME% -cp %CLASSPATH% com.jlp.whatido.Main

Exit

• Open the file C:\ opt\whatido\script\testingMouseKeyBoard.cmd and adapt paths to red

Set PROJECT_HOME=C:\opt\whatido

Set CLASSPATH=%PROJECT_HOME%\lib\jnativehook-2.1.0.jar;.;%PROJECT_HOME%\lib\whatido-3.0.0.jar;

Set JAVA_HOME=C:\Program Files (x86)\Java\jre1.8.0_121\bin

"%JAVA_HOME%\java" -Droot=%PROJECT_HOME% -Dhome=%PROJECT_HOME% -cp %CLASSPATH% com.jlp.whatido.MyMouseKeyboardListener

• Make a shortcut on the desktop for the file C:\opt\whatido\script\whatido.cmd

• An icon whatidoIco.ico is available in the folder C:\opt\whatido\script\ to decorate the shortcut.

• Click on the shortcut to launch whatido.