Custom Toolbox Help

Custom Toolbox is a utility used for building custom launchers (toolboxes) by editing a simple text file with the .list extension.

The default location of the .list files is /etc/custom-toolbox, but the files can be placed in any folder. You can build multiple launchers using different .list files.

Structure of a .list file

You can find examples in /etc/custom-toolbox. The application supports two formats: Custom (Key=Value) and INI.

1. Custom Format

# Comments that start with # are ignored
Name=Name of the Launcher
Comment=This is a comment/description

Category=Name of the category
app1
app2 root
app3 terminal alias="My App"

Category=Second category
app4 user

Keywords like root, user, terminal, and alias="..." can follow the application name.

2. INI Format

The program automatically detects this format if a [Categories] section is present. Comments use ; (the standard INI comment marker).

[General]
Name=Name of the Launcher
Comment=This is a comment
IconTheme=Adwaita

[Categories]
; List categories to define their order
list=First Category, Second Category

[First Category]
items=app1, app2:root, app3:terminal:alias="My App"

[Second Category]
items=app4:user

In the INI format, flags are separated by colons (:). Localization is supported using brackets, e.g., Name[fr]=Nom.

Only applications that have a corresponding .desktop file appear in the custom launcher.

You can launch the app directly with the command custom-toolbox filename.list, or browse to the .list file from the application.

If you select the Show this dialog at startup checkbox, the application places a .desktop file in ~/.config/autostart using the name from the Name= field in the .list file.

You can also copy that .desktop file to /usr/share/applications if you want to place it in your menu.

In Xfce, run xfce4-panel -r as the normal user to refresh the panel after menu changes.