Multitap

Multitap is plugin, which is designed to generate different texts, numbers or characters using the remote control. Obtained string is sent for further processing as part of the event.

Modes of work

Multitap can operate in three different modes:

SMS
Numpad
Single Key

The user can choose, whether the obtained string is attached to the event as a suffix or as a payload.

Mode SMS

In this mode plugin works, just as when writing a mobile phone SMS. Inserting characters can be terminated by one of the following ways:

Enter action
Cancel action (in this case is not triggering an event)

Mode Numpad

In this mode, you can use the Multitap to create a multi-digit numbers. Inserting digits can be terminated in three ways:

When the time-out is reached
Enter action
Cancel action (in this case is not triggering an event)

Mode Single Key

In this mode, the user selects from the list of strings. Sends the string, whose sequence number corresponds to the number of pressing the appropriate keys. Selection of the string may be terminated by one of the following ways:

When the time-out is reached
Enter action
Another action of the same type
Cancel action (in this case is not triggering an event)

How to use the Multitap

The Lexibook ST600 universal remote, as a demonstration remote for this article

There are a large number of different remote controls, which can be used in conjunction with Eventghost. Therefore, it is not possible to do quite universal guidance applicable to all. For the following examples will be used infrared remote control Lexibook ST600 with Egon USB receiver . For the processing of events, generated by the receiver is used Serial port plugin. If all set correctly and press any buttons on the remote, the IR codes are displayed in the logger:

Egon.072207
Egon.072C07
Egon.071F07

Such events form is for further work very inconvenient. Help is easy, we can use of the option remap of events. This can be done as follows:

The cursor place on the plugin, for which we want to remap the events (in this case Serial port plugin)
Select the Configuration-->Add Action... menu item (or click on Add Action...) and select action Python Script (EventGhost folder)

The open dialogue typing the following (you of course use the IR codes for your remote control):

#For remote "LEXIBOOK ST600" (SAT023)
#====================================
timeout = 0.15
eventRemap = eg.result.Map
eventRemap("071E07", "Power", timeout)
eventRemap("071807", "Mute", timeout)
eventRemap("073507", "Num1", timeout)
eventRemap("072D07", "Num2", timeout)
eventRemap("072507", "Num3", timeout)
eventRemap("071D07", "Num4", timeout)
eventRemap("073407", "Num5", timeout)
eventRemap("072C07", "Num6", timeout)
eventRemap("072407", "Num7", timeout)
eventRemap("071C07", "Num8", timeout)
eventRemap("073307", "Num9", timeout)
eventRemap("072B07", "Num0", timeout)
eventRemap("072907", "OK", timeout)
eventRemap("072607", "Input", timeout)
eventRemap("071907", "<<", timeout)
eventRemap("072207", "Play", timeout)
eventRemap("073707", ">>", timeout)
eventRemap("002314", "Record", timeout)
eventRemap("073207", "Stop", timeout)
eventRemap("071B07", "Pause", timeout)
eventRemap("071F07", "Volume+", timeout)
eventRemap("071A07", "Volume-", timeout)
eventRemap("072807", "Channel+", timeout)
eventRemap("072A07", "Channel-", timeout)
eventRemap("072707", "Menu", timeout)
eventRemap("073007", "GoBack", timeout)

Click OK to complete editing and close the dialog. Check, that the just created action Python Script is located in configuration tree immediately below the plugin.
Restart EventGhost and try, how the remap working. If everything OK, events should now appear in the logger already in the new form:
```
Egon.Play
Egon.Num6
Egon.Volume+
```

Example 1 - keystroke emulation in SMS mode

In this example we show, how to configure EventGhost for emulate the writing of any strings through remote control (like as when writing an SMS on your mobile phone).

Step one - new profile of configuration

In the dialog Multitap plugin create a new profile and set the parameters. You can see it in the following picture.

Multitap plugin dialog

Step two - macros

In the configuration tree put the required number of Multitap macros and set it according to the following pictures.

Example of configuration tree:	Configuration dialog for key "Num2":

You obviously modify the configuration to your needs.

Step three - events

To all the newly created macro assign an event - see the next picture.

Example of configuration tree with events

Step four - a macro for events handling

The result of our effort to be keystroke emulation. Therefore it should be to create yet another macro. This macro will handle events, generated by the Multitap plugin.

Place the cursor on the place, where the new macro to be.
Select the Configuration-->Add Macro... menu item (or click on the icon Add Macro...), select action Emulate Keystrokes (Window folder) and in an open dialogue to write {eg.event.payload} and close the dialog.
Select the Configuration-->Add Event... menu item (or click on the icon Add Event...), in an open dialogue to write Multitap.SMS and close the dialog.
Often it may be necessary to macro supplement the action Find a window (ie window, to which to be send Keystrokes).

You can make settings according to the following pictures.

Macro Emulate Keystrokes in configuration tree:	Configuration dialog Emulate Keystrokes:

At this point everything is done and can be a new ability of program EventGhost use!

And here is an example of the OSD and logger using the just completed configuration:

OSD when typing a text:	Contents logger after the completion of typing:

Any correction of poorly formulated phrases are very much welcome!