Graphical interface

The graphical interface lets you add catalogs and install and run solutions without the command line. It works on the same collection as the command line: what you add or install in one shows up in the other.

Album main window

Get the interface

  • Installed with the installation wizard: the interface is included. Start it with the Album shortcut on your desktop.

  • Existing Album installation: add the interface to your Album environment and start it:

    micromamba install album-gui -c conda-forge
    album gui
    

    To get the Album desktop shortcut as well:

    album add-shortcut
    

Add a catalog

  1. Click catalogs: N in the bottom-left corner and choose Add catalog.

  2. Paste the catalog URL, for example https://gitlab.com/album-app/catalogs/helmholtz-imaging, and click OK.

Add catalog dialog

The solutions of the catalog appear in the list as [catalog name] solution title.

Find and run a solution

  1. Type into the search field above the list, for example mesh, and select a solution. The panel on the right shows its description. In Version, ✓ marks installed versions, ✗ versions that are not installed.

  2. Click Run. If the solution is not installed yet, click Install. The first installation can take a few minutes.

    Install prompt

  3. When the installation has finished, click Run. Fill in the parameters of the solution: fields marked * are required, fields left on unset use the default of the solution. Click Run.

    Parameter form

  4. The window shows the output of the solution. Restart brings you back to the parameters to run it again.

    Run output

Open one solution directly

Open a solution of your collection without the list:

album gui helmholtz-imaging:de.mdc-berlin:pixel-to-mesh:0.1.0

Create a desktop shortcut that opens this solution:

album add-shortcut helmholtz-imaging:de.mdc-berlin:pixel-to-mesh:0.1.0

Keep up to date

Task

Where

Get new solutions and versions of your catalogs

catalogs: N > Update catalog(s)

Remove a catalog

catalogs: N > Remove catalog <name>

Install the newest versions of your solutions, uninstall old ones

installed solution versions: N > Update solution(s)

Uninstall all solutions of a catalog

installed solution versions: N > Uninstall all solutions from catalog(s)

Install or uninstall versions of one solution

right-click the solution in the list

See the versions of Album and the interface

Album v... > About

To update Album and the interface, run the installation wizard again. Your catalogs and solutions stay. In an existing Album installation, run micromamba update album album-gui -c conda-forge instead.

Installing solutions from a file or URL, and writing and sharing solutions, work on the command line.