A newer version of this documentation is available.

View Latest

Menu

The menu configuration always use the same syntax: an action followed by a name.

[Menu]
Start=About,{string:1003};Admin,{string:1018}
ShellFile=Encrypt,{string:2010};Decrypt,{string:2011};Sign,{string:2012};Verify,{string:2013}|explorer.exe||-
ShellFolder=
Taskbar=
TaskbarToken=

Start

The Start menu is installed in the Windows Start-Menu. This parameter will only be read during installation, and any changes will be ignored.

[Menu]
Start=About,{string:1003};Admin,{string:1018}

ShellFile

The ShellFile menu extends the Windows File Explorer with a new entry when right-clicking on a file. This menu is read each time the file is selected, so it can be updated without restarting anything.

[Menu]
ShellFile=Encrypt,{string:2010};Decrypt,{string:2011};Sign,{string:2012};Verify,{string:2013}|explorer.exe||-

ShellFolder

The ShellFolder menu extends the Windows File Explorer with a new entry when right-clicking on a folder. The menu is read each time the folder is selected, so it can be updated without restarting anything.

[Menu]
ShellFolder=About,{string:1003}|explorer.exe||-

Taskbar

The Taskbar menu extends the internal taskbar menu icon on Windows. The menu is read at startup of the taskbar service, so when updated a restart of the user service is necessary. Separate actions and dividers with semi-colon.

[Menu]
Taskbar=<action_1>,<text-string_1>;<divider>;<divider-as-text>,<divider-text>;<action_2>,<text-string_2>;

Values

action

The name of the action to show on the Taskbar menu.

text-string

The text string to show for the action. It can be a text string or a text string ID. Text string IDs are written on the form {string1234}.

divider

divider creates a straight line that divides the menu into different sections. To do this, write a single hyphen (-) separated by semi-colons.

divider-as-text

divider-as-text writes out the text string specified by option divider-text in greyed out text.

divider-text

divider-text is the text to be greyed out in the menu.

Examples

Example 1. Add the About command to the Taskbar menu.

Open the About dialog when clicking the About option on the Taskbar menu.

The text string ID 1003 is the word About, see Language en_US.

[Menu]
Taskbar=About,{string:1003}

TaskbarToken

The TaskbarToken menu extends the internal token taskbar menu on Windows. Separate actions with semi-colon.

[Menu]
TaskbarToken=<action>,<text-string>,<match>;...;<action_N>,<text-string_N>,<match_N>

Values

action

The name of the action to show on the menu.

text-string

The text string to show for the action. It can be a text string or a text string ID. Text string IDs are written on the form {string1234}.

match

The name of the matching condition to perform when clicking the menu option. Matching conditions are written on the form {match condition name}. Using match is optional.

Examples

Example 2. Add the View token command to the Taskbar Token menu.

Add the View token option on the Taskbar Token menu.

The text string ID 1146 is the string View - {token-number-string}, see Language en_US.

[Menu]
TaskbarToken=ViewToken,{string1146},-;