Manager installation and updates

Use these guides to install or update the standalone ImageTool Manager application.

Installing the standalone Manager

Standalone bundles for Windows and macOS let you run the manager without managing a Python environment.

Download the latest release from the project’s releases page, then follow the platform-specific steps below. For other platforms, or if you prefer full control, build from source via Building from source.

Windows

  1. Download the latest Windows build .zip file from the releases page.

  2. Extract it and double-click the included .exe installer, then follow the prompts.

macOS

  1. Download the latest .zip archive that matches your architecture from the releases page.

  2. Extract it to obtain ImageTool Manager.app.

  3. Move the app into /Applications (or any folder you prefer) and launch it like any other macOS application.

Linux and source-built bundles

Official standalone release bundles are currently only provided for Windows and macOS. Linux users can build from source (see Building from source), and the resulting app can be launched directly from the build folder.

Building from source

Build a standalone application when you need a Linux bundle or platform-specific build.

  1. Clone the repository:

    git clone https://github.com/kmnhan/erlabpy.git
cd erlabpy

  2. Install the dependencies. This requires uv:

    uv sync --all-extras --group pyinstaller --group pyqt6

  3. Build the application:

    uv run pyinstaller manager.spec

  4. Find the application in dist/ImageTool Manager.

For Windows, you can install the 64-bit edition of Inno Setup 7, add it to the system PATH, and run iscc manager.iss to create an installer.

Updating an existing installation

  1. Select Check for Updates from Help on Windows. On macOS, select it from ImageTool Manager next to .

  2. Follow the prompts to install the update. The application will restart after the update completes.

If the update fails for any reason, you can manually reinstall the latest release from the project releases page with the platform steps in Installing the standalone Manager. The currently installed version can be checked from About in the Help menu on Windows or next to on macOS.