1) Copy TurboWin+_JPMS.tar.xz to a directory of your choice and untar the file (e.g. unpack in the created dir turbowin)

2) create a shortcut to TurboWin+ JPMS, there are different ways to do this, partly dependent on the Linux distribution, see below for an Ubuntu example

-------------------------------------- UBUNTU <= 18 ------------------------------------
2a) Creating application launcher on Ubuntu: You have to install gnome-panel package which comes up with ability to create a application launcher on the desktop or wherever you like. 
Add --no-install-recommends suffix to prevent other package that aren't necessary.

sudo apt-get install --no-install-recommends gnome-panel

After installing gnome-panel, use the following command to create a launcher.

gnome-desktop-item-edit --create-new ~/Desktop

Once you execute the above command, create launcher application will be opened.

2b) Insert Name: TurboWin+ [64-bit]
   Insert Description: version x.x.x
   Insert Command: PATH_TO_TURBOWIN+_BIN/java -m Turbowin_jws/turbowin.main

2c) Icon
The custom TurboWin+ desktop icon can be set by clicking on the default gnome panel icon (properties) and pointing to and opening the TurboWin+ icon (TurboWin+_install.ico, part of the unpacked TurboWin+_JPMS.tar.xz file)

2d) Working directory (necessary to set!)
Unfortunately the TurboWin+ working directory can't be set with the create launcher application but must be set manually:
go to the just created shortcut in ~/Desktop, open it with a text editor and add a line at the end that says Path=PATH_TO_TURBOWIN+_BIN (see example below)

-------------------------------------- UBUNTU > 18 ------------------------------------
2a)
--> it seems gnome-desktop-item-edit is removed from the gnome-panel package, it won't be available for Ubuntu 19.10 (and most likely later releases).
--> as an workaround you can create .desktop files by hand. Just create a blank text file and add the following lines to it for a simple (TurboWin+) one: --see below--
--> Then rename the file as APPNAME.desktop and right-click and select 'allow launching' (you may also have to make it executable).
--> NB Many .desktop files for installed applications are usually found in your /usr/share/applications/ directory 

----------------------------------------------------------------------------------------

Example (text) gnome panel start up TurboWin+ launcher (dir ~/Desktop):

[Desktop Entry]
Version=1.0
Type=Application
Terminal=false
Exec=/home/martin/turbowin/TurboWin+_JPMS/turbowin_jws/bin/java  -m Turbowin_jws/turbowin.main
Path=/home/martin/turbowin/TurboWin+_JPMS/turbowin_jws/bin
Name=TurboWin+ [64-bit]
Comment=version 4.1
Icon=/home/martin/turbowin/TurboWin+_JPMS/TurboWin+_install.ico

NB change the paths to your own situation

3) USB
If an instrument will be connected to TurboWin+ the USB ports must be opened, to open the USB ports (once):

sudo adduser <the user you want to add> dialout
sudo reboot 

4) For troubleshooting you can start TurboWin+ with the launcher to monitor all the incoming and outgoing messages, 
go to the appropriate directory and start ./turbowin_launcher




last updated: 14-December-2020
