🏠 Pocket-Home Bismuth

Guía para sustituir el Pocket Home stock (6 iconos fijos) por Pocket-Home Bismuth: menú con carpetas, flechas entre páginas, muchas apps y edición desde la propia interfaz.

No es obligatorio. El stock + config.json funciona. Bismuth es para quien quiera un launcher moderno en Debian Buster tras el upgrade.

Estado: 🧪 En prueba — Julio 2026. Instalación documentada; resultados en hardware se irán actualizando aquí.

¿Por qué Bismuth?

Alternativas comunitarias más antiguas: Marshmallow (Jessie, 6 iconos mejor gestionados), [PocketDesk](https://git.sr.ht/nytpu/PocketDesk) (Marshmallow + XFCE). Bismuth encaja mejor con Buster y el objetivo de más apps.

Prerrequisitos

1. Upgrade Buster estable — Pocket Home stock arranca, SSH OK.
2. rc.lua mackemint instalado (lanza pocket-home al boot).
3. Backup del launcher actual:

sudo cp /usr/share/pocket-home/config.json ~/config.json.stock.bak 2>/dev/null
dpkg -l pocket-home > ~/pocket-home-version.txt

4. Plan B: saber reflashear por FEL — Checklist FEL.

Instalación rápida (.deb v0.1.1)

Script en la web (recomendado):

wget https://pocketchip.2red.com.es/install-bismuth.sh
chmod +x install-bismuth.sh
sudo ./install-bismuth.sh

Comprueba la descarga — debe empezar por #!/bin/bash, no por <!DOCTYPE html>:

head -1 install-bismuth.sh

Si ves HTML, el deploy de la web aún no incluye el script. Usa la instalación manual de abajo o espera al próximo deploy de Coolify.

Instalación manual (sin script)

# 1. libssl 1.0.0 — el .deb de Bismuth puede necesitarlo en Buster/Stretch
wget -q http://archive.debian.org/debian/pool/main/o/openssl1.0/libssl1.0.0_1.0.2u-1~deb9u1_armhf.deb \
  -O /tmp/libssl1.0.0_armhf.deb
sudo dpkg -i /tmp/libssl1.0.0_armhf.deb || true

# 2. Paquete Bismuth (reemplaza el binario pocket-home)
wget -q https://github.com/centuryglass/Pocket-Home-Bismuth/releases/download/v0.1.1/pocket-home_0.1.1_armhf.deb \
  -O /tmp/pocket-home_0.1.1_armhf.deb
sudo dpkg -i /tmp/pocket-home_0.1.1_armhf.deb
sudo apt install -f -y

# 3. Reiniciar sesión gráfica
sudo systemctl restart lightdm

Tras unos segundos deberías ver el menú Bismuth (no la rejilla de 6 iconos stock).

Si dpkg falla por dependencias

Anota el error. Comunes en Buster:

Compilar desde fuente (plan B)

Si el .deb no funciona en Buster, compila en el CHIP. 512 MB RAM — usa swap en USB:

# Swap 2 GB en USB (cambia /media/usb por tu ruta)
sudo dd if=/dev/zero of=/media/usb/swapfile bs=1M count=2048
sudo chmod 600 /media/usb/swapfile
sudo mkswap /media/usb/swapfile
sudo swapon /media/usb/swapfile

sudo apt install -y git build-essential libasound2-dev libx11-dev libxrandr-dev \
  libxcursor-dev libxft-dev libxinerama-dev libxpm-dev libnm-glib-dev \
  network-manager-dev libi2c-dev libssl-dev libnm-gtk-dev libglib2.0-dev

git clone --recursive https://github.com/centuryglass/Pocket-Home-Bismuth.git
cd Pocket-Home-Bismuth
make -j1
sudo make install

sudo swapoff /media/usb/swapfile
sudo systemctl restart lightdm

Tiempo estimado: 30–90 min según USB y CPU.

Integración con tu Buster actual

Awesome / arranque

No cambies nada si ya tienes el rc.lua mackemint — sigue llamando a pocket-home; Bismuth usa el mismo nombre de binario.

grep pocket-home ~/.config/awesome/rc.lua
# debe aparecer: awful.util.spawn_with_shell("pocket-home")

PICO-8 en Bismuth

El stock usaba /usr/share/pocket-home/config.json. Bismuth usa ~/.config/pocket-home/appMenu.json.

Opciones:

1. Desde la UI: Ctrl+clic en el menú → crear acceso directo → comando /usr/local/bin/pico8-chip
2. A mano (si ya tienes el wrapper):

mkdir -p ~/.config/pocket-home
# Tras el primer arranque Bismuth crea appMenu.json; edítalo o añade desde la UI
ls -la ~/.config/pocket-home/

Verifica que el wrapper sigue existiendo:

ls -la /usr/local/bin/pico8-chip

Wi‑Fi y teclado

Bismuth gestiona Wi‑Fi en su UI. pocketchip-load sigue siendo necesario para el teclado físico — el rc.lua mackemint lo ejecuta al arrancar. Si el Wi‑Fi falla tras instalar Bismuth:

sudo /usr/sbin/pocketchip-load
sudo systemctl restart NetworkManager

Uso básico

Documentación upstream: User Guide · appMenu.json

Volver al Pocket Home stock

Si no te convence o algo rompe:

# Reinstalar paquete NTC desde repos (jfpossibilities / apt si está configurado)
sudo apt install --reinstall pocket-home

# Restaurar config.json stock (el que arreglaste en Jul 2026)
sudo cp ~/config.json.stock.bak /usr/share/pocket-home/config.json

# Quitar config Bismuth (opcional)
rm -rf ~/.config/pocket-home

sudo systemctl restart lightdm

Si apt no tiene el paquete NTC, reflashea con Método Revive + upgrade Buster.

Checklist de prueba (hardware)

Marca tras probar en tu CHIP:

Anota aquí tus resultados (fecha, qué falló, qué funcionó) para actualizar la guía.

Qué NO hacer

Referencias

• Pocket-Home-Bismuth
• Release v0.1.1 (.deb armhf)
• Build & Install upstream
• Upgrade Buster · Troubleshooting

Resumen en una línea

Buster OK → backup config.json → install-bismuth.sh → lightdm restart → probar menú → anotar resultados en esta guía