HIDIScript

HIDIScript is a scripting language which allows users to perform full keyboard emulation. The HIDIScript Generator is available to make creating a HIDIScript payload even easier. Some keyboard keys cannot do not represent an typed character. For example, how do you instruct The Glitch to type in F4 or Alt in keyboard emulation. The answer is to use a language which The Glitch can interpret into those keys. That is where HIDIScript comes in. The script is loaded from the Micro SD card (just like the others) but it is interpreted by The Glitch at runtime.

HIDIScript used tags to represent keystrokes. There are three types of tags: Modifier Keys, Regular Keys, and Commands. Modifier Keys can be used together with a single Regular Key to produce a "new" keystroke. Regular Keys represent a single keystroke. Each Regular Key must be followed by a new line. Commands can be used to interact with the firmware through the script.

HIDIScript Generator

This web interface generates HIDIScript payloads for the KeyMe firmware on the The Glitch.

• Simply type your desired plain text into the textbox.
• When a non-typable character is needed (for example Fn+F4), click on a Key to insert into the textbox at the cursor point.
• Some keys require additional user input. In order to save space in the menu, click on KEY_ when you need any printable character, including 0-9, A-Z and other non-alphanumeric keys. Type in all capital letters when inserting with KEY_.
• Plaintext and Keys must be on separate lines to be parsed correctly.
• Once you have created your script, copy and paste the content of the text box into a text editor and save the file.
• For more information on HIDIScript visit here
  
  

  [CTRL]	[ALT]	[SHIFT]	[GUI]	[ENTER]	[DELETE]
  [PRINTSCREEN]	[BACKSPACE]	[TAB]	[SPACE]	[CAPS_LOCK]	[ESC]
  [SCROLL_LOCK]	[NUM_LOCK]	[INSERT]	[HOME]	[PAGE_UP]	[END]
  [PAGE_DOWN]	[RIGHT]	[LEFT]	[DOWN]	[UP]	[PAUSE]
  [LEFT_BRACE]	[RIGHT_BRACE]	[SPACE]	[MINUS]	[EQUAL]	[PERIOD]
  [NUMBER]	[SEMICOLON]	[SLASH]	[QUOTE]	[TILDE]	[COMMA]
  [CAPS_LOCK]	[BACKSLASH]	[F1]	[F2]	[F3]	[F4]
  [F5]	[F6]	[F7]	[F8]	[F9]	[F10]
  [F11]	[F12]
  [WAIT_]	[KEY_]
  
  
  

Syntax

• Code sytax starts with '[' and ends with ']'
• Lines may contain either plain text or HIDIScript tags.
• Plain text will be typed out verbatim.
• HIDIScript tags are parsed and interpreted as either a Regular Key, Modifier Key, or Command
• Each line using HIDIScript tags may contain only a single keystroke or command. Modifier Keys may be used in conjunction with each other and a single Regular Key to create a single keystroke. For example: [KEY_CTRL][KEY_S]. The combination of the keys is used to form Ctrl+S, which is used by most operating systems to "save" a file.
• Command Keys are instructions for the firmware and are not interpreted as keystrokes.

The following tables contain the syntax for the HIDIScript language.

Regular Keys Codes

KEY_A	KEY_B	KEY_C	KEY_D
KEY_E	KEY_F	KEY_G	KEY_H
KEY_I	KEY_J	KEY_K	KEY_L
KEY_M	KEY_N	KEY_O	KEY_P
KEY_Q	KEY_R	KEY_S	KEY_T
KEY_U	KEY_V	KEY_W	KEY_X
KEY_Y	KEY_Z	KEY_1	KEY_2
KEY_3	KEY_4	KEY_5	KEY_6
KEY_7	KEY_8	KEY_9	KEY_0
KEY_ENTER	KEY_ESC	KEY_BACKSPACE	KEY_TAB
KEY_SPACE	KEY_MINUS	KEY_EQUAL	KEY_LEFT_BRACE
KEY_RIGHT_BRACE	KEY_BACKSLASH	KEY_NUMBER	KEY_SEMICOLON
KEY_QUOTE	KEY_TILDE	KEY_COMMA	KEY_PERIOD
KEY_SLASH	KEY_CAPS_LOCK	KEY_F1	KEY_F2
KEY_F3	KEY_F4	KEY_F5	KEY_F6
KEY_F7	KEY_F8	KEY_F9	KEY_F10
KEY_F11	KEY_F12	KEY_PRINTSCREEN	KEY_SCROLL_LOCK
KEY_PAUSE	KEY_INSERT	KEY_HOME	KEY_PAGE_UP
KEY_DELETE	KEY_END	KEY_PAGE_DOWN	KEY_RIGHT
KEY_LEFT	KEY_DOWN	KEY_UP	KEY_NUM_LOCK
KEYPAD_SLASH	KEYPAD_ASTERIX	KEYPAD_MINUS	KEYPAD_PLUS
KEYPAD_ENTER	KEYPAD_1	KEYPAD_2	KEYPAD_3
KEYPAD_4	KEYPAD_5	KEYPAD_6	KEYPAD_7
KEYPAD_8	KEYPAD_9	KEYPAD_0	KEYPAD_PERIOD

Modifier Keys

KEY_CTRL

KEY_SHIFT

KEY_ALT

KEY_GUI

Commands

WAIT_#

Delay '#' number of milliseconds.

Code Example

The following is the "Hello World" of keystroke injection on Windows. It opens up Notepad from the Windows runbar and types in "Hello World", then kills the notepad application. In between, time delays are used to wait on the target system to complete the task.

[KEY_GUI][KEY_R]
[WAIT_1000]
notepad
[KEY_ENTER]
[WAIT_2000]
Hello World
[KEY_ENTER]
[WAIT_2000]
[KEY_ALT][KEY_F4]
[WAIT_500]
[KEY_ALT][KEY_N]

Written by Ben Weinstein-Raun