> For the complete documentation index, see [llms.txt](https://gitbook.simplesmarts.ca/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.simplesmarts.ca/install-h2r-graphics.md).

# 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="/files/7di7MbcLl35XYrEsSHN2" 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="/files/TQ5zxji1xIJ0Fol3cIc7" 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="/files/ymvptaCsJ3J3WTHc4Tua" 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!