# 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!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.simplesmarts.ca/install-h2r-graphics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.