Skip to content

HulK Configuration

Jerome edited this page May 1, 2020 · 2 revisions

The HulK configuration file

The configuration file is a INI file named hulk.ini. Unlike PortAL, HulK does not automatically reload the configuration file when you modify it. It means that you need to relaunch HulK. The configuration file is stored in the same folder than the binary.

On recent Windows Operating Systems, you need administrator rights to edit a file in the Program Files folder.

Special feature which is not (yet?) configurable

With HulK, you can use the right button of your mouse in order to send an application in the system tray. This feature is currently hard coded and it's not possible to deactivate it or change the action (like to "iconize" it instead).

Structure of the INI file

The configuration file respect some standard of INI files. Here a sample:

[DRAG]
btn=left
mod=ALT

[MINIMIZE POINTED]
key=222
mod=Win

;[MINIMIZE CURRENT] commented line

Be carefull with ";", this symbol allowed to comment a line only if it is the first character. It's not possible (for the moment) to comment the end of the line.

The configuration is made of section, like [DRAG] which is the first section in our example. In sections we have generally three possible values: key (define an hotkey), btn (define a mouse action) and mod (the modifier for the hotkey or for the mouse action).

Hotkeys

Keys

There is three differents way to configure a key in PortAL.

  • A letter or a number like A or 1
  • A special name like F1, NUM_0 or SPACE.
  • The keycode number like 222 (which is the key just below "escape")

View the special key binding

Modifiers

By default, if you do not specialy a modifier, PortAL will use the Win key. So you have to use the None modifier if you do not want a modifier. The modifier value ask for letters in order to determine which modifier will be used for your hotkey.

  • C - Ctrl
  • A - Alt
  • S - Shift
  • W - Win
  • Other letter - None Please note that PortAL need to uppercase to work properly.

mod=C or mod=Ctrl set the Ctrl modifier. You should press the Ctrl key with the another key configure with key value.

mod=AS or mod=Alt Shift set the Alt and Shift modifier. You should press the Alt key and Shift key with the another key configure with key value.

mod=N is the standard to not use a modifier with the key.

Mouse

When you define a btn you have four possibilities.

  • left
  • right
  • middle
  • wheel

Possible sections

DRAG

Allow you to drag the pointed window with your mouse. The default configuration is

[DRAG]
btn=left
mod=ALT
RESIZE

Allow you to resize the pointed window with your mouse. The default configuration is

[DRAG]
btn=right
mod=ALT
MINIMIZE POINTED

Minimize the application which is pointed by the mouse cursor. Note that if your mouse pointed the windows desktop, HulK will try to minimize the application with the focus.

MINIMIZE CURRENT

Minimize the application which has the focus

CLOSE POINTED

Close the application which is pointed by the mouse cursor Note that if your mouse pointed the windows desktop, HulK will try to close the application with the focus.

CLOSE CURRENT

Close the application which has the focus

MAXIMISE POINTED (MAXIMIZE POINTED)

Maximize the application which is pointed by the mouse cursor. Note that if your mouse pointed the windows desktop, HulK will try to maximize the application with the focus.

MAXIMISE CURRENT (MAXIMIZE CURRENT)

Maximize the application which has the focus

ICONIZE POINTED

Send to tray the application which is pointed by the mouse cursor Note that if your mouse pointed the windows desktop, HulK will try to iconize the application with the focus.

ICONIZE CURRENT

Send to tray the application which has the focus.

TRAYNIZE POINTED

Send to HulK menu the application which is pointed by the mouse cursor. Note that if your mouse pointed the windows desktop, HulK will try to "traynize" the application with the focus.

TRAYNIZE CURRENT

Send to HulK menu the application which has the focus.

UNICONIZE

Retrieve the last iconized (or traynized) application.

SWITCH

It's still an experimental feature which allow you to switch the application (like with ALT+TAB). This feature has been originally made to work with ALT plus the mouse wheel.

ALWAYS ON TOP POINTED

Toggle the "on top" attribute for the pointed window. Note that if your mouse pointed the windows desktop, HulK will try to update the application with the focus.

ALWAYS ON TOP CURRENT

Toggle the "on top" attribute for the application which has the focus.

QUIT

Quit HulK

PLUGIN name

Load a HulK Plugin. A Plugin is a DLL which will provide some new and special features. Because this features are not essential for everybody, the feature is transferred.

The plugins have three options possible : activate, key and modifier

Plugins

wdhook - Automatic Borderless

wdhook.dll is the first HulK plugin. It allow to automatically set maximized application in border-less status. When a border-less window is restore, wdhook restore his borders.

It is possible to set a hook for activation/deactivation. example:

[PLUGIN wdhook]
key=F12
mod=CTRL

It is possible to set the default activation state. Then if you set "false", plugin won't be activated when HulK start. Activation will be set by the assigned hotkey. example:

[PLUGIN wdhook]
activate=false
key=F12
mod=CTRL

systemmenu

systemmenu.dll is the second HulK plugin. It allow to automatically add items in the system menus for the tray and iconize actions.