# Install H2R Graphics

## Using SSH or via local Terminal

The prefered method is accessing the Pi remotely using an SSH client such as [Putty](https://putty.org/). This eliminate the need for a keyboard, mouse and monitor to be connected to the Pi. If you are unfamiliar you can learn more on the [raspberripi.com website.](https://www.raspberrypi.com/documentation/computers/remote-access.html#remote-access)

{% hint style="info" %}
The same procedure can be done in a terminal window on the Pi if you have a keyboard-mouse and monitor connected
{% endhint %}

### Update OS

Once you are connected over SSH (or open a terminal), you first need to load and install the latest updates with the following command

```
sudo app-get update && sudo app-get upgrade
```

You will be prompted to process with the install and you need to press 'y' followed by 'enter'. This may take a while.

### Download H2R Graphics

Next we need to download the H2R Graphics AppFile to the Raspberry Pi in a new folder called H2R.

If you are using 64 bit OS 

```
wget -P ~/H2R https://github.com/iamjohnbarker/h2r-graphics-releases/releases/download/v2.18.2/H2R-Graphics-2.18.2-arm64.AppImage
```

If you are using 32 bit OS

```
wget -P ~/H2R https://github.com/iamjohnbarker/h2r-graphics-releases/releases/download/v2.18.2/H2R-Graphics-2.18.2-armv7l.AppImage
```

<figure><img src="https://3583893609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJPveBFU0YRq2Js3iavAe%2Fuploads%2FM3GoN14sf9a3Z8nFsMNU%2Fimage.png?alt=media&#x26;token=fe39cf64-ce75-4893-8bb8-b8d3dd174d42" alt=""><figcaption><p>SSH session : Successful download of H2R Graphics to the Raspberry Pi</p></figcaption></figure>

### Install H2R Graphics

Next we will move to the H2R directory, adjust permissions, unpack the AppFile and rename the root directory

```
cd ~/H2R
chmod a+x H2R-Graphics-2.18.2-arm64.AppImage
./H2R-Graphics-2.18.2-arm64.AppImage --appimage-extract
mv squashfs-root root
```

<figure><img src="https://3583893609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJPveBFU0YRq2Js3iavAe%2Fuploads%2F7tuEaFEAkhrxkMXBqIVN%2Fimage.png?alt=media&#x26;token=98e3e8a4-a28c-46ed-95d5-f929d6c4413d" alt=""><figcaption></figcaption></figure>

### Create a desktop shortcut

If you need a desktop icon to use to launch H2R graphics, we'll need to create a .desktop file for this purpose.

```
nano ~/Desktop/H2R.desktop
```

this will open a text editor for file H2R.desktop

copy and paste the content below into the editor

```
[Desktop Entry]
Name=H2R Graphics
Icon=/home/pi/H2R/root/usr/share/icons/hicolor/0x0/apps/h2r-graphics-electron.png
Exec=/home/pi/H2R/root/./AppRun
Type=Application
Encoding=UTF-8
Terminal=false

```

{% hint style="info" %}
to exit the editor and save your file you hit Ctrl+X to exit, Y to confirm changes, Enter to complete&#x20;
{% endhint %}

<div align="left"><figure><img src="https://3583893609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJPveBFU0YRq2Js3iavAe%2Fuploads%2FYx34pnikmcvqBGRCtY6m%2Fimage.png?alt=media&#x26;token=a75613c7-f575-47b6-b78c-112126685218" alt=""><figcaption><p>Desktop Icon for H2R Graphics.</p></figcaption></figure></div>

At this point you can double-click the icon to launch the application!