Since GroIMP version 2.1.4, it is possible to configure options specific to a given workbench through an option file named workbench.options. This file is located at the root of the project.gs file or within the .gsz archive. It allows users to share a project with a specific set of options, overriding the global preferences.

• When a workbench option file exists in a project, GroIMP uses its settings instead of the global ones.
• If the option file contains more settings than the current GroIMP instance supports, those options are retained but ignored.
• If the option file is missing settings defined in the current GroIMP instance, those options are added to the file upon saving.

To create a workbench-specific option file, open the Preferences Panel via Panel > Preferences and choose: file > options > create current workbench option file (See Figure 2).

Figure 2: Menu options for creating a workbench option file

After the option file is created, the Preferences Panel will switch to the Workbench Options View (see Figure 3), displaying:

1. The name of the active workbench in the top-right corner.
2. A button to open the Global Options Panel in the bottom-right corner.

Figure 3: Workbench Options Panel

• When a workbench option file is added, it is automatically set with the current global options.

• Changes to workbench options are applied immediately. However, the option file is not updated automatically. To save the changes to the option file, the project must be saved.

To stop using a workbench-specific option file, it can be deleted via the menu: file > options > delete current option file (see Image 2).

• Option files can also be edited manually as plain text outside of GroIMP.
• To add an option file externally:
  • Unordered List Item Add workbench.options to the project directory.
  • Add the OptionsSource registry item to project.gs.
  • Update the MANIFEST.MF file.

• To delete an option file externally, remove the file, the OptionsSource entry from project.gs, and update MANIFEST.MF.