🛠️ FamBum Stick / SSD – Erstellungs-Leitfaden

Dieser Leitfaden dokumentiert alle Schritte, um den FamBum-Stick von Grund auf neu zu erstellen. Zielgruppe: der Ersteller (technisch versiert).

⚠️ Zwei Grundregeln

exFAT ist Pflicht, sobald ein Android-Gerät dabei ist. exFAT hat kein Journal → vorzeitiges Abziehen beim Schreiben zerstört Daten.
Android ≠ Linux-arm64. Android nutzt bionic/Termux-Pakete, NICHT die glibc-Binaries aus tools_linux/arm64/.

1. Ordnerstruktur (Root, ab v1.1 mit system/)

FamBum (Wurzel)
 ├── STARTEN.sh                 ← Startet Config-Server (Linux/Mac/Android)
 ├── start_gallery.bat          ← Windows-Starter
 ├── bilder/                    ← manuelle Fotoablage (optional)
 ├── album/                     ← generierte Galerie (automatisch)
 ├── config.json                ← Einstellungen (wird bei Bedarf neu erstellt)
 ├── readme.html / readme.txt / endnutzer-faq.html
 └── system/
      ├── config-server.js      ← Browser-Oberfläche (Port 8788)
      ├── start_gallery.sh      ← Kernskript
      ├── read-config.js        ← liest config.json → Shell-Variablen
      ├── dedup.js / exif-filter.js / exclude-deleted.js / delete-from-gallery.js
      ├── thumbsup/             ← Galerie-Tool + better-sqlite3
      ├── tools_linux/          ← Node, FFmpeg, GM, ExifTool + Perl-Libs
      ├── tools_mac/
      └── tools_windows/

2. Pfad-Konzept

Variable	Wert
`SYS_DIR`	Ordner mit dem Script (`…/system`)
`ROOT_DIR`	eine Ebene darüber (Stick-Root)

Node: __dirname + path.join(..., '..')
bash: $(dirname "$0") + $(dirname "$SYS_DIR")
Batch (Windows): %~dp0

3. Portable Tools besorgen

Alle Tools als portable Binaries (keine Installer). Details und Download-Links stehen in stick-admin.html.

3.1 better-sqlite3 (kritisch)

Nie direkt auf exFAT bauen (keine Symlinks). Auf ext4//tmp bauen und per ZIP nach system/thumbsup/node_modules/ kopieren.

4. Die Skripte

A system/start_gallery.sh (Kernskript)

Erkennt macOS / Linux / Android automatisch
Setzt Pfade auf SYS_DIR/ROOT_DIR
Adaptives Concurrency: Wechselmedium=1, sonst 4
Scan-Pfade: $HOME, /media, /mnt, /run/media/$USER, $ROOT_DIR/bilder
Ablauf: ThumbsUp → exclude-deleted.js → exif-filter.js → dedup.js
Kein --clear – kumulativ; Reset nur via Browser oder album/ leeren

B system/config-server.js (Browser-Oberfläche)

Port 8788. Bietet Einstellungen (Theme, Qualität, Scan-Pfade, Concurrency), Systemcheck, Galerie-Start/Stop und Reset. Theme-Auswahl: cards, classic, mosaic, flow.

5. Löschfunktion (v1.1)

Datei	Zweck
`system/delete-from-gallery.js`	Browser-Editor (Port 8787) – 🗑 entfernt Bild aus Galerie, Original bleibt
`system/exclude-deleted.js`	Liest Blacklist, entfernt Einträge aus DB (läuft automatisch)

6. Android (Termux, bionic) – getrennt behandeln

⚠️ Nicht mit Linux-arm64 verwechseln

tools_linux/node/arm64 = glibc-Linux (Raspberry Pi), läuft NICHT auf Android.
Android braucht Termux-Pakete: pkg install nodejs-lts ffmpeg graphicsmagick perl.
Diese vom Handy gebauten Binaries + Abhängigkeiten separat bereitstellen.
Support: Android 7–16 (aktuell). Android 5/älter → nur über PC.

7. Test-Checkliste

Test	Erwartet
`STARTEN.sh` starten	Config-Server läuft auf 8788, Browser öffnet sich
Systemcheck	Alle Zeilen zeigen ✅/⚠️/❌
Galerie erstellen (nur `bilder/` anhaken)	Scan läuft, `album/index.html` entsteht
Abbruch während des Laufs	„Vorgang abgebrochen“ statt „fertig“
Stick zurücksetzen	Spinner + Erfolgsmeldung
exif-filter / dedup	prüfen auf DB/Tabelle, keine Crashs

Stand: August 2026 – v1.1 mit Löschfunktion