Cette documentation décrit l'installation complète de Walkabot sur un GMKtec NucBox G3S (Intel N95) sous Xubuntu 26.04 LTS.

Cette version remplace la plateforme Raspberry Pi devenue instable (plusieurs cartes SD défectueuses) par une plateforme x86 plus fiable, plus rapide et alimentable par PowerBank USB-C PD.

—

* GMKtec NucBox G3S (Intel N95) * SSD NVMe Lexar * Xubuntu 26.04 LTS * Interface audio USB HID * PowerBank USB-C PD 65W * Câble USB-C PD → DC 12V 5.5×2.5 mm * Réseau Ethernet ou WiFi

—

Le BIOS du GMKtec est relativement exigeant.

Les clés créées avec certains outils graphiques Ubuntu n'étaient pas reconnues.

La méthode fiable consiste à utiliser dd.

Repérer la clé :

```bash lsblk ```

Puis écrire l'image :

```bash sudo umount /dev/sdX* sudo dd if=/home/USER/Downloads/xubuntu-26.04-desktop-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync sync ```

Attention :

``` /dev/sdX ```

et non

``` /dev/sdX1 ```

—

Installation classique.

Créer par exemple :

``` Computer name : walkabot

Username : apobot ```

—

```bash sudo apt update sudo apt full-upgrade -y ```

—

```bash sudo apt install openssh-server sudo systemctl enable ssh sudo systemctl start ssh ```

Connexion :

```bash ssh apobot@IP_DU_WALKABOT ```

—

Installation :

```bash sudo apt install x11vnc ```

Créer un service systemd :

```bash sudo nano /etc/systemd/system/x11vnc.service ```

```ini [Unit] Description=x11vnc server for Walkabot desktop After=display-manager.service network.target Requires=display-manager.service

[Service] Type=simple ExecStart=/usr/bin/x11vnc -display :0 -auth /var/run/lightdm/root/:0 -forever -shared -rfbport 5900 -listen 0.0.0.0 -noxdamage Restart=always RestartSec=5

[Install] WantedBy=multi-user.target ```

Activer :

```bash sudo systemctl daemon-reload sudo systemctl enable x11vnc sudo systemctl start x11vnc ```

Connexion :

``` vncviewer IP_DU_WALKABOT ```

—

```bash sudo apt install \ puredata \ qjackctl \ jackd2 \ alsa-utils \ pd-zexy \ pd-iemlib \ pd-iemmatrix \ pd-iemambi \ pd-creb \ pd-bsaylor \ pd-pdogg ```

Ajouter l'utilisateur au groupe audio :

```bash sudo usermod -aG audio apobot ```

Puis redémarrer.

—

Les externals sont installés dans :

``` /usr/lib/pd/extra/ ```

Notamment :

``` /usr/lib/pd/extra/pdogg /usr/lib/pd/extra/iemlib /usr/lib/pd/extra/zexy ```

—

Lister les cartes :

```bash aplay -l ```

Résultat :

``` card 1: HID [USB Audio and HID] ```

Le système utilise donc :

``` hw:1,0 ```

—

Copie :

``` /home/apobot/BotPatch ```

Le patch principal :

``` PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd ```

—

Créer :

```bash nano /home/apobot/start_walkabot.sh ```

```bash #!/bin/bash

sleep 10

export DISPLAY=:0 export XAUTHORITY=/var/run/lightdm/root/:0

pkill -f “puredata.*PATCH_GENERAL_BORGBOT” 2>/dev/null pkill jackd 2>/dev/null

sleep 2

jackd \ -d alsa \ -d hw:1,0 \ -r 44100 \ -p 256 \ -n 3 &

sleep 5

puredata \ -jack \ -verbose \ -stderr \ -path /usr/lib/pd/extra/pdogg \ -path /usr/lib/pd/extra/iemlib \ -path /usr/lib/pd/extra/zexy \ -lib zexy \ -lib iemlib \ -path /home/apobot/BotPatch \ -open /home/apobot/BotPatch/PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd ```

Rendre exécutable :

```bash chmod +x /home/apobot/start_walkabot.sh ```

—

Créer :

```bash mkdir -p ~/.config/autostart nano ~/.config/autostart/walkabot.desktop ```

```ini [Desktop Entry] Type=Application Name=Walkabot Exec=/home/apobot/start_walkabot.sh Hidden=false NoDisplay=false X-GNOME-Autostart-enabled=true ```

—

Après démarrage :

* ouverture automatique de la session Xubuntu * lancement automatique de JACK * lancement automatique de Pure Data * chargement automatique du patch Walkabot * VNC disponible immédiatement * accès SSH permanent

—

``` Boot

↓

LightDM Autologin

↓

Desktop Xubuntu

↓

Autostart

↓

start_walkabot.sh

↓

JACK (USB Audio)

↓

Pure Data

↓

PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd

↓

Stream Icecast ```

—

Cette configuration remplace entièrement l'ancienne plateforme Raspberry Pi.

Avantages :

* beaucoup plus fiable (SSD NVMe) * processeur Intel N95 très performant * alimentation possible par PowerBank USB-C PD 65 W * administration complète via SSH et VNC * démarrage entièrement automatique * plateforme facilement clonable sur d'autres GMKtec.