.. _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/``.
* To change the default workspace folder (which is `~/pilot/`) set the following environment variable in your ``~/.bashrc``:

  .. code-block:: sh
	
	export PILOT_HOME=/your/custom/path
	source ~/.bashrc
	
* To run the `GTK GUI` execute the following:
  
  .. code-block:: sh
	
	/opt/neobotix/pilot-gtkgui/bin/pilot_gtkgui.sh
	
* Alternatively you can install a desktop launcher as follows:

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

* See :ref:`pilot-core <Installation>` documentation for more information regarding standalone simulation mode.


Windows
-------

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