Skip to content

ImJoy Desktop App
Compare
Choose a tag to compare
@oeway oeway released this 28 Oct 20:38
· 17 commits to master since this release
v0.4.0
d81c23a

ImJoy Desktop App is the desktop version of ImJoy App.

  • support ImJoy Plugin Engine
  • support offline mode
  • new icon
  • fix window closing bug

screen shot 2018-12-15 at 1 26 37 pm

MacOS

Download ImJoy-darwin-x64.zip. If you download from Chrome, you will need to select "keep", other browsers may have similar warning:
screen shot 2018-12-15 at 1 21 04 pm

Then unzip the files into a folder, and copy ImJoy.app to Applications.

To launch it for the first time, you need to right click select open, after that you can normally launch it by click or double click.
47146226-ee1ef380-d2cb-11e8-8af8-59636b17b3a0

Windows

Download ImJoy-win32-x64.zip, unzip the file and run ImJoy.exe.

If you download from Chrome, you will need to select "keep", other browsers may have similar warning:
screen shot 2018-12-15 at 1 21 04 pm

When you run ImJoy.exe, you may see the following warning, and you will need to click More info, and choose run anyway.

screenshot from 2018-12-19 13-17-44

Linux

For Linux desktop environment, download ImJoy-linux-x64.zip, unzip the file and run ImJoy.

If you want to use it on a remote linux server or a cluster with the command line interface, you don't need to download ImJoy-App. Run this command in your terminal to install the plugin engine:

wget https://raw.githubusercontent.com/oeway/ImJoy-Engine/master/utils/Linux_Install.sh  -O - | bash

To start the plugin engine, run:

export PATH=~/ImJoyApp/bin:$PATH
python -m imjoy --host=0.0.0.0 --serve

Uninstall/remove ImJoy-App

First you need to remove the folder ImJoy-App from where you place it.

In order to uninstall or remove ImJoy Engine, you need to remove two folders located in your home/user folder: ImJoyApp and ImJoyWorkspace.

  • ImJoyApp contains a Miniconda environemnt and the virtual environemtns used for running ImJoy plugins
  • ImJoyWorkspace contains user data for each ImJoy workspace, you may want to backup the data.

On Linux/OSX, you can run the following command:

rm -rf $HOME/ImJoyApp   
rm -rf $HOME/ImJoyWorkspace # please backup important data inside this folder

On windows, it's typically located in C:\Users\<CurrentUserName>, you can remove ImJoyApp and ImJoyWorkspace manually.

Notes

On different operating systems, you may see different warnings, which is normal when you are trying to download and install executable files, please skip those protections accordingly.

The first time you open the Engine, it will try to install a Miniconda environment dedicated for ImJoy to ImJoyApp folder under your home folder. This will take a few minutes, after that launching ImJoy will be faster and it will automatically search for updates.

Assets 5
Loading