🏠 Guía 11

🏠 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?

Stock NTC	Bismuth
6 iconos fijos	Menú paginado con flechas izq/der
Editar `config.json` a mano	Añadir/mover/borrar apps desde la UI (Ctrl+clic)
Una página "Apps"	Carpetas (Juegos, Internet, etc.)
`/usr/share/pocket-home/config.json`	`~/.config/pocket-home/*.json`

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

Upgrade Buster estable — Pocket Home stock arranca, SSH OK.
rc.lua mackemint instalado (lanza pocket-home al boot).
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

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:

Error	Fix
`libssl.so.1.0.0`	Instala `libssl1.0.0` del paso 1
Conflicto con `pocket-home` NTC	`sudo dpkg -i --force-overwrite /tmp/pocket-home_0.1.1_armhf.deb`
Otros `.so` faltantes	Pega el error; puede hacer falta compilar desde fuente

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:

Desde la UI: Ctrl+clic en el menú → crear acceso directo → comando /usr/local/bin/pico8-chip
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

Acción	Cómo
Abrir app	Enter o clic
Moverse en el menú	Flechas / Tab
Cambiar página	Flechas izq/der o botones en pantalla
Abrir carpeta	Enter en una carpeta
Menú contextual	Ctrl+clic o Ctrl+E
Añadir app	Menú contextual → nuevo acceso directo
Volver atrás	Escape

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:

Check	Resultado
Instalación `.deb` en Buster 10.13	⬜
Arranque automático tras reboot	⬜
Menú con flechas / carpetas	⬜
Wi‑Fi desde Bismuth	⬜
Teclado físico	⬜
PICO-8 vía `pico8-chip`	⬜
Make Music / SunVox	⬜
Rollback a stock OK	⬜

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

Qué NO hacer

❌	Por qué
`apt autoremove` tras instalar	Puede borrar paquetes Pocket
Borrar `config.json.stock.bak` antes de validar	Rollback más difícil
Instalar Marshmallow y Bismuth a la vez	Conflicto en `pocket-home`
Compilar sin swap en USB	OOM / compilador muerto a mitad

Referencias

Resumen en una línea

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