Getting Started#


To make the installation of EasyDiffraction as easy as possible, we prepared installers for three major operating systems: Windows, macOS and Linux (Ubuntu). You can download the latest and previous versions from the releases page.


Run EasyDiffraction installer and follow the instructions.

Common Issues#

  • On macOS, if you see the message can’t be opened because it is from an unidentified developer, do the following: In the Finder, locate the EasyDiffraction installer application, then control-click the installer icon, then choose Open from the shortcut menu and finally click Open.

  • On Linux based system there can be the following error on startup: Failed to create OpenGL context for format QSurfaceFormat. This is due to a system OpenGL driver problem. Please re-install your graphics card drivers.


Run MaintenanceTool from the EasyDiffraction installation directory, select Remove all components and follow the instructions.

Installation from source#

If the relevant EasyDiffraction installation does not work on your system, then please try installation from source.

  • Install Poetry, the Python dependency manager, following the official instructions.

  • Clone easyDiffractionApp repo from GitHub:

    git clone
  • Go to easyDiffractionApp directory.

  • Create virtual environment for easyDiffractionApp and install its dependences using Poetry:

    poetry install
  • Launch EasyDiffraction application using poetry:

    poetry run easyDiffraction