Menus Structure And Syntax

This is how Blackbox menus are structured and what commands you can use to tweak them to your liking.

Most of BB resources and tutorials were lost when lostinthebox went down, so thanks to Pico_No_Blackbox for finding this on Pastebin.

Menu Structure

[begin] (label) indicates the begin of the menu, label is optional.

[end]                                                                 indicates the end of the menu or submenu, required.

[submenu] (label)                                             inserts a submenu into the menu, must be closed by [end]

[include] {filename}                                          This will continue reading items from the indicated file.

[nop] (label)                                                      inserts an inactive item with an optional label

[sep]                                                                 inserts a separator (same as [nop] with no label)

Inserting Submenus

[path] (label) {folder}                                        inserts an submenu with a folder from your computer as specified

[path] (label) {folder1|folder2}                          merges two folders into a single menu

[insertpath] {folder}                                          inserts items from a folder into the current menu

[stylesmenu] (label) {folder}                             insert a submenu with stylefiles from a folder

[stylesdir] {folder}                                             insert style files from a folder into the current menu

[config] (label)     inserts the configuration menu

[workspaces] (label)                                         insert the workspaces menu

[tasks] (label)                                                   insert a menu with the current tasks

[icons] (label)                                                   insert a menu with the currently minimized tasks

In addition to normal paths like {c:/program files/...}, a number of items may be used to indicate a special shellfolder. See shellfolders.rc for examples.

Blackbox Commands

[style] (label) {filename}                                    insert an item to apply a new style.

[toggleplugins] (label)                                       show/hide plugins

[aboutplugins] (label)                                       display 'about plugins' info

[aboutstyle] (label)                                           display 'about style' info

[gather] (label)   gather windows in current workspace

[reconfig] (label)                                               re-read the configuration files

[restart] (label)   reload plugins

[exit] (label)                                                      exit blackbox

Edit Commands

[edit] (label) {file}                                             edit the specified 'file'

[editstyle] (label)                                              edit the current style

[editmenu] (label)                                            edit menu.rc

[editlugins] (label)                                            edit plugins.rc

[editextensions] (label)                                    edit extension.rc

[editblackbox] (label)                                       edit blackbox.rc

The 'edit' commands use the 'blackbox.editor', which is specified in extensions.rc. For example:

blackbox.editor: bbnote.exe

Shutdown Commands

[logoff] (label)   logoff (*)

[suspend] (label)                                              suspend the computer (*)

[hibernate] (label)                                             hibernate (*)

[reboot] (label)   reboot the computer (*)

[shutdown] (label)                                            shutdown the computer (*)

[lockworkstation] (label)                                   lock workstation

[switchuser] (label)                                           fast user switch

[exitwindows] (label)                                        display standard shutdown dialog

(*) You can add -q(uiet) for no confirmation. For example

[logoff -q] (Log Out)

External Commands

[run] (label)                                                      show the windows 'run' dialog

[exec] (label) {command}                                 run a program (*) or execute a broam.

In addition to normal paths like {c:/program files/...}, a number of items may be used to indicate a special shellfolder. See shellfolders.rc for examples.

Just Expanding on that here.

Excellent addition

Did i ever tell you; getting praise from you feels like Sean Connery handing me a beer? XD

You honor me, but truth is I don't have the time I would need to make so many researches I wanted to make, so having people like you finding treasures like this is worth a pack of beers.