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 an example in /etc/custom-toolbox.

# Comments that start with # are ignored
# Simple text file containing Name= Comment= Category= keywords
# with the list of app names under each corresponding category
# optional "root" flag can follow app name to indicate how to run the app

Name=Name of the Launcher
Comment=This is a comment/description for the launcher

Category=Name of the category
app1
app2 root
app3

Category=Second category
app4 root
app5

In this example, app2 and app4 run as root. The other applications are launched as the normal user.

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.