Installation

The Easydiver+ executable files (in .zip format) can be found in the Releases section in the EasyDiverPlus repository. As of now, Easydiver+ is available for Windows, macOS-x86_64, and macOS-ARM64 platforms. Make sure you download the appropriate .zip file for your machine.

In the zip file, you will find a folder named dist (short for “distribution”). Inside this folder, depending on your machine, you might see a folder called EasyDiverPlus_FILES and an executable named EasyDiverPlus, or you may find only the EasyDiverPlus_FILES folder. If you see only the EasyDiverPlus_FILES folder, the executable is located inside it.

Once you extract the .zip archive into your computer, you will generally need to right-click on the executable, and click Open from the menu. This is due to the fact that this is an ‘unsigned’ executable, and you will have to explicitly choose to trust it (see details below).

MacOS (x86_64 and ARM)

To run EasyDiver+ on MacOS, download the appropriate release for your machine from the Releases section in the EasyDiverPlus repository.. If you have an ‘m’ series machine, with an m1, m2, etc chip, you’ll need to use the .zip with ARM in the name, otherwise you should use the x86_64 .zip file.

Right-click on the downloaded .zip file and click Open from the menu.. This will prompt the Archive Utility to unzip the file into the a folder titled dist in the same location as the .zip file. Within that dist folder (or in the EasyDiverPlus_FILES subfolder on ARM machines), right-click on the EasyDiverPlus executable (the icon is a black square with exec) and click Open from the menu.

You will receive a prompt asking whether you are sure you want to open this application, as macOS cannot verify the developer. Click Open to continue.

From here, you can follow the instructions detailed in the usage section.

Pandaseq note

If you encounter any issues with pandaseq not running correctly after clicking Submit and starting the processing, we recommend that you download and install pandaseq locally. By default, the application will attempt to leverage the integrated installation first. However, we added a check box (‘Use Local PANDASeq’) to force the application to use the local installation.

If a problem is encountered with newer MacOS versions after installing PANDASeq, you may try the following:

  1. Install Homebrew <https://brew.sh/>

  2. brew install bzip2 pkgconfig libtools

  3. Run the ./autogen.sh build step (see PANDASeq manual)

If an error referencing snprintf occurs, identify the file from the error message, open that file and adjust ‘snprintf’ to be ‘printf’ instead. During our test runs, this issue was found in line 528 in the pandaseq package args.c file. Run the ./autogen.sh build step again. At this point, you might get many ‘warnings’ but you shouldn’t get any errors.

Windows (x86_64 / Windows 10+)

To run EasyDiver+ on Windows, there is a bit of extra work to prepare the Ubuntu environment which will be used to execute the underlying code.

WSL / Ubuntu Virtual Machine Setup

If you have WSL(2) already set up on your computer, you can just proceed to the Install pandaseq section.

Otherwise, you will need to open Powershell. Once opened, you will need to run:

wsl --install -d Ubuntu

This will open a new window. If you haven’t run this before, you’ll need to now set up a User & Password for this Ubuntu Virtual Machine. We suggest using the same username and password as you use for your Windows user. PLEASE NOTE - you will need this password for the next steps!! You can now close the Ubuntu window that appeared.

Install pandaseq

Next, you will need to run each of these lines (also in Powershell), so that you can appropriately install pandaseq in that Ubuntu Virtual Machine:

wsl -e bash -c "sudo apt-get update -y"
wsl -e bash -c "sudo apt-get install -y zlib1g-dev libbz2-dev libltdl-dev libtool zlib1g-dev pkg-config autoconf make python3 python3-pip"
wsl -e bash -c "git clone http://github.com/neufeld/pandaseq.git/"
wsl -e bash -c "cd ./pandaseq; bash ./autogen.sh && MAKE=gmake ./configure && make && sudo make install"

To confirm everything has been installed once this has all completed its execution, you can now run the following, which should point to the location of pandaseq in that Ubuntu Virtual Machine:

wsl -e bash -c "which pandaseq"

Alternatively to running each of these lines individually, the authors have created a shell script file in the root directory of the EasyDiverPlus repository, titled install_pandaseq_ubuntu.sh. This can be run in one command like the following, which will then execute the shell script (that contains the above code).

wsl -e bash -c "$(curl https://raw.githubusercontent.com/celiablanco/EasyDiverPlus/main/install_pandaseq_ubuntu.sh )"

Once the above steps are completed, you now have a WSL Ubuntu environment prepared, and EasyDiverPlus’s interface will handle the rest for you. You can now proceed to download the .zip archive, extract and run the EasyDiverPlus.exe file!

Download and Run

Download the zip package for Windows from the Releases section in the EasyDiverPlus repository.

Right-click on the downloaded .zip file and click Extract All from the menu, and choose a destination for the extracted files, then click Extract to unzip the files.

Within the extracted folder, you should now see the dist folder. Within that folder, right-click on the EasyDiverPlus executable (the icon is a floppy disk with a yellow python in the upper left corner) and click Run as Administrator from the menu.

In the prompt that appears, titled Windows protected your PC, you must click More info and then click Run Anyway.

From here, you can follow the instructions detailed in the How to use EasyDiver+ section.