Files

15 KiB
Raw Permalink Blame History

Schnappix Logo

Schnappix

Tablet-optimierte Android-Photobooth-App mit React Native und Expo – inklusive Kiosk-Modus, lautlosem IPP-Direktdruck, USB-Kamera-Support, Fotorahmen und Sticker-Editor.

🇬🇧 English · 🇩🇪 Deutsch


Überblick

Schnappix ist eine für Tablets optimierte Photobooth-Anwendung auf Basis von React Native und Expo (Android-Paketname de.orfel.schnappix). Sie bietet ein interaktives, offline-fähiges Fotobox-Erlebnis für Events – mit Countdown, Serienbild-Modus, Collagen, transparenten PNG-Fotorahmen, einem Social-Media-artigen Sticker-Editor, lautlosem Netzwerkdruck über IPP, nativem Android-Device-Owner-Kiosk-Modus, externer USB-Kamera-Unterstützung sowie einem integrierten Admin-Dashboard.


Funktionen

  • Photobooth-Erlebnis: Intuitiver Ablauf vom Startbildschirm über Countdown und Blitz-Auslösung bis zur Vorschau – CameraScreen bleibt im Hintergrund permanent gemountet, um Android-Kamera-Hardware-Abstürze zu verhindern.
  • Mehrere Fotos & Collagen: Aufnahme von Einzelbildern oder Serien (bis zu 4 Fotos für Collagen) mit direkter Nachbearbeitung.
  • Sticker- & Emoji-Editor: Party-Emojis sowie dynamische Datums-, Uhrzeit- und Event-Text-Sticker frei verschieben, per Pinch vergrößern/verkleinern und mit zwei Fingern drehen.
  • Fotorahmen: Transparente PNG-Rahmen als Overlay (12 integrierte Vorlagen unter assets/frames/). Im Admin-Bereich zwischen Aus, Immer an und Verfügbar umschaltbar.
  • Serienbild-Modus (Burst Mode): Automatische Aufnahme von 1–5 Fotos hintereinander mit konfigurierbarem Intervall für den Collagen-Druck.
  • Datum-/Uhrzeit- & Event-Einblendung: Optionaler Stempel mit Datum oder Datum + Uhrzeit sowie Event-Namen auf jedem Foto.
  • Kamera-Blitzeffekt: Vollbild-Blitzanimation bei jeder Auslösung für echtes Fotobox-Feeling.
  • Direkter Netzwerkdruck (IPP): Integrierter Internet-Printing-Protocol-Client (ipp-encoder), der image/jpeg-Druckaufträge lautlos ohne Systemdialog direkt an Port 631 (/ipp/print) sendet – inklusive exponentiellem Retry-Backoff (3 Versuche). Eine leere Drucker-IP aktiviert den rein digitalen Modus.
  • Kiosk-Modus (Lock Task Mode): Eigenes natives Android-Modul (modules/kiosk-mode) samt Config-Plugin (plugins/withKioskAdmin), um das Tablet als Device Owner ohne Bestätigungsdialoge vollständig auf Schnappix zu sperren.
  • USB- & Frontkamera-Support: Unterstützt sowohl interne Front-/Rückkameras als auch externe UVC-USB-Kameras über das native Modul (modules/usb-camera) und plugins/withUsbCamera.
  • Admin-Dashboard: PIN-geschützter Einstellungsbildschirm (AdminScreen), über den alle Parameter im laufenden Betrieb geändert und in settings.json gespeichert werden.
  • Offline-Speicherung (MediaStore API): Speichert Originale und finale Collagen direkt strukturiert in der Android-Galerie (Schnappix - <EventName> - Originale und Schnappix - <EventName> - Collagen).

Funktionsweise & Tech-Stack

Tech-Stack

Ebene Technologie
Framework React Native (0.81.5) & Expo (SDK 54, New Architecture aktiviert)
Sprache TypeScript (^5.3.0) & React (19.1.0)
Kamera & Medien expo-camera, expo-image, expo-image-manipulator, expo-file-system, expo-media-library
Editor & Capture react-native-view-shot, react-native-gesture-handler, react-native-reanimated, react-native-worklets, expo-linear-gradient
Drucken ipp-encoder (^5.0.0) + buffer (rohe IPP-v1.1-Print-Job-Anfragen per HTTP POST auf :631/ipp/print)
Icons @fortawesome/react-native-fontawesome (fa-solid), react-native-svg
Native Module & Plugins Lokale Expo-Module (kiosk-mode, usb-camera) & Config-Plugins (withKioskAdmin, withUsbCamera, withLocalAars, withRemoveMediaPermissions, withProguardRules, withAndroidSigning, withOptimization, withMmkvForce)
Android-Ziel compileSdkVersion 36, targetSdkVersion 36, ndkVersion 28.0.12932649, Querformat (landscape)

Design-Theme (src/styles/theme.ts)

Die App nutzt eine Neon-Synthwave-Ästhetik passend zum App-Icon (Icon.png):

  • Primärfarbe: Elektrisches Magenta #ff2bd6 (Verlauf #ff2bd6 → #a033ff → #28dfff)
  • Akzentfarbe: Cyan-Blau #28dfff
  • Hintergrund: Tiefes Dunkelblau/Schwarz #050510 (surface: #0D0D1A, surfaceSecondary: #151528)
  • Effekte: Neon-Glow-Schatten und Glassmorphismus-Overlays (rgba(13, 13, 26, 0.85))
  • Icons: Font Awesome (Solid) im Neon-Design

Fotospeicherung (MediaStore API)

src/services/storage.ts speichert Fotos über die native Hilfsfunktion KioskMode.saveImageToAlbum (Android 10+ MediaStore mit RELATIVE_PATH), sodass keine veralteten Speicherberechtigungs-Dialoge erscheinen:

  • Alben: Schnappix - <EventName> - Originale (Rohaufnahmen) und Schnappix - <EventName> - Collagen (fertige Druck-/Speicherausgaben)
  • Dateinamen: <SafeEventName>_YYYY-MM-DD_HH-mm-ss_<Raw|Collage>.<ext>

Caution

Versuche unter Android 13+ nicht, WRITE_EXTERNAL_STORAGE oder READ_EXTERNAL_STORAGE zu erzwingen; plugins/withRemoveMediaPermissions.js entfernt nicht konforme Medien-Berechtigungen bewusst für moderne Android-Versionen und den Play Store.


Voraussetzungen & Installation

Voraussetzungen

  • Node.js (v18+) und npm
  • Expo CLI / EAS CLI (>= 19.1.0 für EAS-Builds)
  • Android Studio & Android SDK / NDK (28.0.12932649) zum Bauen der nativen Android-App

Lokale Einrichtung

  1. Repository klonen:

    git clone https://git.orfel.de/Jannik/Schnappix.git
    cd Schnappix
    
  2. Abhängigkeiten installieren:

    npm install
    
  3. Natives Android-Projekt generieren (erforderlich wegen der eigenen nativen Module und Plugins):

    npx expo prebuild --clean --platform android
    
  4. App auf einem Android-Gerät oder Emulator starten:

    npm run android
    

Entwicklungs- & Build-Regeln

Schnappix folgt festen Versionierungs- und Build-Vorgaben:

  1. Versionierung: Das Versionsformat lautet 23.01.X, wobei X dem android.versionCode in app.json entspricht (aktuell 23.01.78 / versionCode: 78).
  2. Build-Artefakte: Releases müssen immer sowohl als .apk als auch als .aab gebaut werden (Schnappix_v23.01.X.apk und Schnappix_v23.01.X.aab).
  3. Paketname: Muss zwingend de.orfel.schnappix bleiben.

Note

Hinweis zur Einstellungs-Persistenz (src/services/settings.ts): Erkennt Application.getLastUpdateTimeAsync() ein App-Update oder eine Neuinstallation (bzw. fehlt appLastUpdate), setzt loadSettings() die settings.json auf DEFAULT_SETTINGS zurück.


Konfiguration

Tippe auf dem Startbildschirm auf das Zahnrad-Symbol (⚙️) und gib das Admin-Passwort ein (Standard: 1234), um das Admin-Dashboard zu öffnen.

Übersicht der Admin-Einstellungen (src/services/settings.ts)

Einstellung Interner Schlüssel Beschreibung Standard
Drucker IP-Adresse printerIp Lokale IP des IPP-Druckers (z. B. Canon Selphy CP1300). Leer = rein digitaler Modus 192.168.0.1
Countdown-Dauer countdownDuration Sekunden vor der Fotoaufnahme 3
Admin-Passwort adminPassword PIN für den Zugang zum Admin-Dashboard 1234
Begrüßungstext welcomeText Überschrift auf dem Startbildschirm Zeit für ein Erinnerungsfoto!
Footer-Text footerText Fußzeilentext auf dem Startbildschirm Display tippen! • Lächeln! • Foto schnappen!
Event-Name eventText Event-Text für Datums-Sticker & Ordnernamen (wird beim Start abgefragt, falls leer) "" (leer)
Serienbild-Anzahl burstCount Anzahl der Fotos pro Auslösung (1 = Einzelbild, 2–5 = Serie) 1
Serienbild-Abstand burstIntervalSec Sekunden zwischen den Serienbild-Aufnahmen 5
Fotorahmen-Modus frameMode off (Aus) / always (Immer an) / available (Verfügbar) available
Datum-Einblendung dateOverlay off (Aus) / date (Nur Datum) / datetime (Datum + Uhrzeit) off
Kiosk-Modus kioskModeEnabled Sperrt das Tablet auf Schnappix (startet bei Aktivierung automatisch beim App-Start) false (Aus)
Frontkamera nutzen useFrontCamera Wechselt zwischen Frontkamera und Rück-/USB-Kamera true (An)
Logs aktivieren enableLogs Aktiviert detaillierte App-Protokolle true (An)

Kiosk-Modus (Android Device Owner) einrichten

Für den echten Kiosk-Modus (Lock Task Mode) ohne System-Rückfragen und ohne externe MDM-Software muss Schnappix als Android Device Owner eingerichtet werden:

Voraussetzungen:

  1. Auf dem Android-Tablet dürfen keine Konten (z. B. Google-Konto) eingerichtet sein – am besten mit einem frisch zurückgesetzten Gerät starten.
  2. Entwickleroptionen und USB-Debugging auf dem Tablet aktivieren.
  3. Die Schnappix-APK auf dem Tablet installieren.

Setup-Befehl:

adb shell dpm set-device-owner de.orfel.schnappix/expo.modules.kioskmode.AdminReceiver

Bei Erfolg erscheint: Success: Device owner set to package de.orfel.schnappix

Danach kann das USB-Kabel getrennt und der Kiosk-Modus direkt im Admin-Dashboard aktiviert werden.

Warning

Sobald die App als Device Owner registriert ist, lässt sie sich nicht mehr regulär deinstallieren. Zum Entfernen ist ein Werksreset oder ein programmgesteuertes Aufheben des Device-Owner-Status nötig.

Fotorahmen – Anleitung (src/data/frames.ts)

Schnappix unterstützt eigene transparente PNG-Fotorahmen, die vor dem Speichern und Drucken über die Fotos gelegt werden.

Eigenschaft Anforderung
Format PNG mit Alphakanal (Transparenz)
Auflösung 1500 × 1000 px (Seitenverhältnis 3:2 Querformat, passend zu Display & Druck)
Transparenz Der Fotobereich muss vollständig transparent sein (Alpha = 0)
Dateigröße Möglichst unter 500 KB für schnelles Rendering
Benennung frame_<name>.png (z. B. frame_balloons.png)

Neuen Rahmen hinzufügen:

  1. PNG-Datei in assets/frames/ ablegen.
  2. Rahmen in src/data/frames.ts registrieren:
    export const FRAMES: FrameDefinition[] = [
      { id: 'balloons', name: 'Luftballons', asset: require('../../assets/frames/frame_balloons.png') },
    ];
    
  3. App neu bauen (npx expo prebuild --clean --platform android & npm run android).
  4. Rahmen-Modus (Immer an oder Verfügbar) im Admin-Dashboard wählen.

Nutzung

Ablauf für Gäste

  1. Startbildschirm: Tippen auf das Display startet die Aufnahme (ist noch kein Event-Name gesetzt, fragt ein Modal diesen zuerst ab).
  2. Aufnahme: Der Countdown läuft ab (countdownDuration), der Bildschirm-Blitz leuchtet auf und es wird ein Einzelbild oder eine Serie (1–5 Fotos) aufgenommen.
  3. Vorschau & Sticker-Editor:
    • Über Sticker öffnet sich der StickerTray mit ausgewählten Party-Emojis.
    • Sticker frei verschieben, per Pinch skalieren und mit zwei Fingern drehen (DraggableSticker).
    • Zum Löschen einen Sticker antippen und auf × drücken.
    • Dynamische Datums-, Uhrzeit- und Event-Sticker werden automatisch gemäß Admin-Einstellungen erzeugt.
    • Im FramePicker (bei Modus Verfügbar) einen Fotorahmen auswählen oder weitere Fotos für eine Collage aufnehmen.
    • Speichern in die Geräte-Galerie (MediaStore) und lautloses Drucken per IPP auslösen.

Nützliche npm-Skripte

  • npm start – Expo-Entwicklungsserver starten
  • npm run android – Native Android-App bauen und ausführen (expo run:android)
  • npm run ios – iOS-Build starten (expo run:ios)
  • npm run web – Web-Vorschau starten (expo start --web)

Projektstruktur

Schnappix/
├── assets/
│   ├── frames/                        # 12 mitgelieferte transparente PNG-Fotorahmen (1500×1000)
│   └── graphics/                      # Store- und Beispielgrafiken
├── modules/
│   ├── kiosk-mode/                    # Natives Android-Lock-Task- & MediaStore-Modul
│   └── usb-camera/                    # Natives Android-UVC-USB-Kamera-Modul inkl. AARs
├── plugins/                           # Expo-Config-Plugins (Kiosk, USB, AARs, Signing, ProGuard usw.)
├── src/
│   ├── components/                    # DraggableSticker, FrameOverlay, FramePicker, GradientButton, Icon, StickerTray
│   ├── data/
│   │   └── frames.ts                  # Registrierung der integrierten Fotorahmen
│   ├── screens/
│   │   ├── CameraScreen.tsx           # Startansicht, Countdown, Blitz, Kamera-/USB-Aufnahme
│   │   ├── PreviewScreen.tsx          # Collagenansicht, Rahmenwahl, Sticker-Editor, Druck & Speichern
│   │   └── AdminScreen.tsx            # PIN-geschütztes Admin-Dashboard
│   ├── services/
│   │   ├── logger.ts                  # Persistenter Datei-Logger
│   │   ├── printer.ts                 # Lautloser IPP-v1.1-JPEG-Netzwerkdruck
│   │   ├── settings.ts                # settings.json-Persistenz & Update-Reset-Logik
│   │   └── storage.ts                 # Android-MediaStore-Albumspeicherung
│   ├── styles/
│   │   └── theme.ts                   # Neon-Synthwave-Farben, Abstände & Verläufe
│   └── types/
│       └── ipp-encoder.d.ts           # TypeScript-Deklarationen für ipp-encoder
├── App.tsx                            # Haupt-Zustandssteuerung & persistenter CameraScreen-Host
├── app.json                           # Expo-Konfiguration (Version 23.01.78, de.orfel.schnappix)
├── eas.json                           # EAS-Build-Profile (development, preview APK, production)
├── Icon.png                           # App-Icon
├── package.json                       # Abhängigkeiten & Skripte
└── withAndroidSigning.js              # Android-Release-Keystore-Signing-Plugin

Lizenz

Der eigene Quellcode dieses Projekts steht unter CC0 1.0 Universal (Public Domain) — Details in LICENSE.

Drittanbieter-Bestandteile: Externe Abhängigkeiten, eingebundene Bibliotheken, Schriften, Datensätze und Medien-Assets unterliegen weiterhin ihren jeweiligen eigenen Lizenzen und sind von CC0 1.0 ausgenommen. Details siehe THIRD_PARTY_NOTICES.md.