15 KiB
Schnappix
Tablet-optimierte Android-Photobooth-App mit React Native und Expo – inklusive Kiosk-Modus, lautlosem IPP-Direktdruck, USB-Kamera-Support, Fotorahmen und Sticker-Editor.
Ü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 –
CameraScreenbleibt 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), derimage/jpeg-Druckaufträge lautlos ohne Systemdialog direkt an Port631(/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) undplugins/withUsbCamera. - Admin-Dashboard: PIN-geschützter Einstellungsbildschirm (
AdminScreen), über den alle Parameter im laufenden Betrieb geändert und insettings.jsongespeichert werden. - Offline-Speicherung (MediaStore API): Speichert Originale und finale Collagen direkt strukturiert in der Android-Galerie (
Schnappix - <EventName> - OriginaleundSchnappix - <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 |
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) undSchnappix - <EventName> - Collagen(fertige Druck-/Speicherausgaben) - Dateinamen:
<SafeEventName>_YYYY-MM-DD_HH-mm-ss_<Raw|Collage>.<ext>
Caution
Versuche unter Android 13+ nicht,
WRITE_EXTERNAL_STORAGEoderREAD_EXTERNAL_STORAGEzu erzwingen;plugins/withRemoveMediaPermissions.jsentfernt nicht konforme Medien-Berechtigungen bewusst für moderne Android-Versionen und den Play Store.
Voraussetzungen & Installation
Voraussetzungen
- Node.js (
v18+) undnpm - Expo CLI / EAS CLI (
>= 19.1.0für EAS-Builds) - Android Studio & Android SDK / NDK (
28.0.12932649) zum Bauen der nativen Android-App
Lokale Einrichtung
-
Repository klonen:
git clone https://git.orfel.de/Jannik/Schnappix.git cd Schnappix -
Abhängigkeiten installieren:
npm install -
Natives Android-Projekt generieren (erforderlich wegen der eigenen nativen Module und Plugins):
npx expo prebuild --clean --platform android -
App auf einem Android-Gerät oder Emulator starten:
npm run android
Entwicklungs- & Build-Regeln
Schnappix folgt festen Versionierungs- und Build-Vorgaben:
- Versionierung: Das Versionsformat lautet
23.01.X, wobeiXdemandroid.versionCodeinapp.jsonentspricht (aktuell23.01.78/versionCode: 78). - Build-Artefakte: Releases müssen immer sowohl als
.apkals auch als.aabgebaut werden (Schnappix_v23.01.X.apkundSchnappix_v23.01.X.aab). - Paketname: Muss zwingend
de.orfel.schnappixbleiben.
Note
Hinweis zur Einstellungs-Persistenz (
src/services/settings.ts): ErkenntApplication.getLastUpdateTimeAsync()ein App-Update oder eine Neuinstallation (bzw. fehltappLastUpdate), setztloadSettings()diesettings.jsonaufDEFAULT_SETTINGSzurü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:
- Auf dem Android-Tablet dürfen keine Konten (z. B. Google-Konto) eingerichtet sein – am besten mit einem frisch zurückgesetzten Gerät starten.
- Entwickleroptionen und USB-Debugging auf dem Tablet aktivieren.
- 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:
- PNG-Datei in
assets/frames/ablegen. - Rahmen in
src/data/frames.tsregistrieren:export const FRAMES: FrameDefinition[] = [ { id: 'balloons', name: 'Luftballons', asset: require('../../assets/frames/frame_balloons.png') }, ]; - App neu bauen (
npx expo prebuild --clean --platform android&npm run android). - Rahmen-Modus (
Immer anoderVerfügbar) im Admin-Dashboard wählen.
Nutzung
Ablauf für Gäste
- Startbildschirm: Tippen auf das Display startet die Aufnahme (ist noch kein
Event-Namegesetzt, fragt ein Modal diesen zuerst ab). - Aufnahme: Der Countdown läuft ab (
countdownDuration), der Bildschirm-Blitz leuchtet auf und es wird ein Einzelbild oder eine Serie (1–5Fotos) aufgenommen. - Vorschau & Sticker-Editor:
- Über Sticker öffnet sich der
StickerTraymit 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 ModusVerfü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.
- Über Sticker öffnet sich der
Nützliche npm-Skripte
npm start– Expo-Entwicklungsserver startennpm 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.