.. _GKTGUI_Installation:

Installation
============


Ubuntu
------

* Obtain the correct ``neobotix-pilot-gtkgui-`` debian package for your architechture and Ubuntu version.
  For example, the file name for the `x86_64` `Ubuntu 20.04` package ends with ``-x86_64-ubuntu-20.04.deb``.
* Install the package as follows:
  
  .. code-block:: sh
	
	sudo dpkg -i neobotix-pilot-gtkgui-*.deb

* Install missing dependencies via:

  .. code-block:: sh
  
	sudo apt -f install

* The contents of the package should now be installed under ``/opt/neobotix/pilot-gtkgui/``.
* The default workspace folder is ``~/pilot/``. You can change this setting via the environment variable ``PILOT_HOME``:

  .. code-block:: sh

	export PILOT_HOME=/your/custom/path

  It is highly recommended to add this line to your ``~/.bashrc`` to apply it automatically.

* To run the `GTK GUI` execute the following:
  
  .. code-block:: sh
	
	/opt/neobotix/pilot-gtkgui/scripts/pilot_gtkgui.sh
	
  This command should also be available as an entry in the applications menu.

* Alternatively you can install a desktop launcher as follows:

  .. code-block:: sh
  
	xdg-desktop-icon install /usr/share/applications/Neobotix-PlatformPilot-GUI.desktop
    
  You may need to right click on the icon first and select "Allow Launching" to activate it.


Windows
-------

* Execute the ``neobotix-pilot-gtkgui-?-windows10.exe`` installer.
* The package will be installed to your Profile Folder in ``C:\Users\?\PlatformPilotGUI\``.
* Execute ``PlatformPilotGUI\pilot\pilot_gtkgui.bat`` or double click on the Desktop Icon.