Third-party Launcher

Third-party application launchers allow you to run another application by transmitting information to it in the startup parameters.

In the graphical user interface, launchers appear in the File > Launcher menu and optionally in the toolbar.

In the example above, we add a button to launch the Horos software on the Mac, importing the directory containing the DICOM files downloaded by Weasis.

How to create the third-party launcher

1. From the main menu, open File > Preferences (Alt + P) and select the Launcher item.
2. Click on the Add New button to create a new DICOM launcher.
3. In DICOM launcher dialog, fill in the fields:
   • Name: the name of the launcher
   • Icon path: the icon to display in the menu and toolbar. The path can be absolute or relative to the Weasis resources folder. When the icon is not found, the default icon is displayed.
   • Enable: to display the launcher in the menu and toolbar
   • Button: to display the launcher in the toolbar
4. In DICOM Launcher dialog, click on Configure to specify the launch context.
5. In Launcher Type, select the launcher type:
   • URI: add a URI to open a web page or a file. The URI can contain dynamic variables described below.
   • Application: run an application with parameters. The application Parameters and Environment Variables can contain dynamic variables described below.
     • Binary Path: the command to run the application.
     • Working Directory: the working directory of the application (optional).
     • Parameters: the parameters to pass to the application. Each line is a parameter.
     • Environment Variables: the environment variables to pass to the application. Each line is an environment variable.
     • Compatibility: the compatibility of the launcher with the current platform. This feature is useful when the launcher configuration is coming from the server side.
6. In Launcher Type, click on Save to save the launcher parameters.
7. In DICOM Launcher, click on Save to save the launcher general information.

List of dynamic variables in URI, Parameters and Environment Variables:

• {dicom:wado.folder} the temporary folder for images downloaded from the WADO and DICOMWeb protocols.
• {dicom:last.folder} the last open folder of Local Device in Import DICOM.
• {dicom:selection.folder} it will display a selection dialog (such as Export DICOM) and copy the result to this folder, which will be deleted when Weasis is closed.
• {tag::<key>} any DICOM attribute value from the selected image, e.g. {tag:AccessionNumber}
• {pref:<key>} any preferences, e.g. {pref:weasis.user}.

How to run the third-party launcher

• From the main menu, open File > Launcher and select the desired launcher
• From the toolbar click on the launcher button