====== Walkabot v2 — Installation complète sur GMKtec NucBox G3S (Xubuntu 26.04) ======

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 (cartes SD défectueuses) par une plateforme x86 plus fiable, plus rapide et alimentable via PowerBank USB-C PD.

-----

====== Matériel ======

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

-----

====== Création de la clé USB ======

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é :

<code bash>
lsblk
</code>

Puis écrire l'image :

<code 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
</code>

**Attention :**

Utiliser :

<code>
/dev/sdX
</code>

et non

<code>
/dev/sdX1
</code>

-----

====== Installation Xubuntu ======

Installation classique.

Créer par exemple :

<code>
Computer name :
walkabot

Username :
apobot
</code>

-----

====== Mise à jour ======

<code bash>
sudo apt update
sudo apt full-upgrade -y
</code>

-----

====== Installation SSH ======

<code bash>
sudo apt install openssh-server
sudo systemctl enable ssh
sudo systemctl start ssh
</code>

Connexion :

<code bash>
ssh apobot@IP_DU_WALKABOT
</code>

-----

====== Installation VNC ======

Installation :

<code bash>
sudo apt install x11vnc
</code>

Créer le service :

<code bash>
sudo nano /etc/systemd/system/x11vnc.service
</code>

Contenu :

<code>
[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
</code>

Activer :

<code bash>
sudo systemctl daemon-reload
sudo systemctl enable x11vnc
sudo systemctl start x11vnc
</code>

Vérifier :

<code bash>
sudo systemctl status x11vnc
</code>

Connexion :

<code bash>
vncviewer IP_DU_WALKABOT
</code>

-----

====== Installation de Pure Data ======

<code bash>
sudo apt install \
puredata \
qjackctl \
jackd2 \
alsa-utils \
pavucontrol \
pd-zexy \
pd-iemlib \
pd-iemmatrix \
pd-iemambi \
pd-creb \
pd-bsaylor \
pd-pdogg
</code>

Ajouter l'utilisateur au groupe audio :

<code bash>
sudo usermod -aG audio apobot
</code>

Puis redémarrer.

-----

====== Vérification des librairies ======

Les externals sont installés dans :

<code>
/usr/lib/pd/extra/
</code>

Les principaux dossiers sont :

<code>
/usr/lib/pd/extra/pdogg
/usr/lib/pd/extra/iemlib
/usr/lib/pd/extra/zexy
</code>

-----

====== Vérification de la carte son ======

Lister les interfaces audio :

<code bash>
aplay -l
arecord -l
</code>

Résultat attendu :

<code>
card 1: HID [USB Audio and HID]
device 0
</code>

Le script utilisera donc :

<code>
hw:1,0
</code>

-----

====== Copie du patch ======

Copie du dossier :

<code>
/home/apobot/BotPatch
</code>

Patch principal :

<code>
PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd
</code>

-----

====== Script de démarrage ======

Créer :

<code bash>
nano /home/apobot/start_walkabot.sh
</code>

Contenu :

<code 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
</code>

Rendre exécutable :

<code bash>
chmod +x /home/apobot/start_walkabot.sh
</code>

-----

====== Démarrage automatique ======

Créer le dossier :

<code bash>
mkdir -p ~/.config/autostart
</code>

Créer le lanceur :

<code bash>
nano ~/.config/autostart/walkabot.desktop
</code>

Contenu :

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

-----

====== Vérification ======

Après redémarrage :

<code bash>
ps aux | grep jackd
ps aux | grep puredata
</code>

Le système doit lancer automatiquement :

  * la session graphique Xubuntu
  * JACK
  * Pure Data
  * le patch Walkabot
  * le serveur VNC
  * le serveur SSH

-----

====== Architecture ======

<code>
Boot

↓

LightDM Autologin

↓

Desktop Xubuntu

↓

Autostart

↓

start_walkabot.sh

↓

JACK (USB Audio hw:1,0)

↓

Pure Data

↓

PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd

↓

Icecast / Ogg Stream
</code>

-----

====== Dépannage ======

===== VNC =====

Si ''x11vnc'' ne trouve pas la session X :

<code bash>
ps aux | grep Xorg
</code>

Le serveur X doit contenir :

<code>
-auth /var/run/lightdm/root/:0
</code>

Le service ''x11vnc'' doit utiliser exactement ce chemin.

-----

===== Pure Data =====

Si ''oggcast~'' ou ''lp2~'' ne sont pas trouvés, vérifier que les chemins suivants sont présents :

<code>
/usr/lib/pd/extra/pdogg
/usr/lib/pd/extra/iemlib
/usr/lib/pd/extra/zexy
</code>

-----

===== JACK =====

Si JACK refuse de démarrer :

Lister les interfaces :

<code bash>
aplay -l
</code>

Puis adapter :

<code>
-d hw:1,0
</code>

dans ''start_walkabot.sh''.

-----

====== Résultat ======

Walkabot démarre désormais de manière totalement autonome :

  * alimentation
  * boot automatique
  * ouverture de session
  * lancement de JACK
  * lancement de Pure Data
  * chargement du patch
  * diffusion Icecast
  * accès SSH
  * accès VNC

Le système ne dépend plus d'une carte SD Raspberry Pi mais d'un SSD NVMe, ce qui améliore considérablement la fiabilité et facilite le clonage sur d'autres machines.