Dokumentasi perangkat

Perangkat dan kamera

Tiga hal yang menentukan booth bisa jalan: kamera yang dikenali gphoto2, jalur printer yang cocok dengan kertas, dan token bridge yang sama di service lokal dan di kiosk.

01 · GPHOTO2 2.5.34

Jenis kamera

2.778 model dari daftar resmi libgphoto2/gphoto2. Angka di bawah dihitung dari katalog saat build, bukan ditulis manual.

Lihat katalog lengkap

Jumlah per tipe

DSLR
124
Mirrorless
106
Compact
505
Action
18
Lainnya
2.025

Jumlah per kemampuan booth

Siap booth
433
Capture saja
149
Transfer file
697
Belum terverifikasi
1.499
Arti label kemampuan booth
LabelArtiModel
Siap boothCapture/trigger dan liveview siap dipakai booth.433
Capture sajaBisa memicu shutter, tanpa liveview.149
Transfer fileHanya mengunduh file yang sudah ada di kartu.697
Belum terverifikasiKemampuan belum terverifikasi dari daftar resmi.1.499

Label diturunkan dari abilities resmi gphoto2, bukan uji per perangkat. Kamera PTP generik bisa tetap bekerja meski tidak tercantum; model berlabel transfer hanya menjamin unduh file, bukan capture dari kiosk.

Brand dengan model terbanyak
BrandModel
Lainnya1.509
Canon360
Nikon207
Sony187
Kodak90
Fujifilm83
Olympus79
Samsung51
HP44
Ricoh26

SNAPSHOT 11 November 2026 · SUMBER PRINT-CAMERA-LIST · LISENSI LGPL

02 · JALUR CETAK

Jenis printer

Tidak ada katalog printer. Yang ada tiga jalur cetak di kode, masing-masing dengan batasnya sendiri.

Perbandingan jalur cetak
ModeCocok untukButuh bridge?Catatan
browserPrinter foto apa pun yang sudah terpasang di OSTidakDefault. Memakai window.print(); di tablet dialog cetak OS selalu muncul, sedangkan silent-print hanya lewat Chrome desktop flag --kiosk-printing.
bluetoothPrinter thermal 58 mm / 80 mm (ESC/POS)TidakWeb Bluetooth, fallback Web Serial SPP. Hanya berjalan di browser kiosk; bridge tidak terlibat.
cupsPrinter foto kertas gulungan (DNP, Citizen, Selphy)YaBridge lokal http://127.0.0.1:17777 memakai lpstat/lp/cupsenable; media name mengikuti driver printer.

windows

Windows dengan driver printer terpasang

Mendeteksi printer lewat PowerShell Get-Printer, lalu mengirim job ke spooler Windows.

cups

macOS dan Linux dengan CUPS

Mendeteksi printer lewat lpstat, mengirim job lewat lp, dan mengaktifkan antrean lewat cupsenable.

mock

Pengujian tanpa printer fisik

Tidak menyentuh perangkat; dipakai untuk memastikan alur cetak berjalan.

Batas yang perlu diketahui

  • Browser tidak punya SDK printer; cetak selalu lewat dialog OS atau bridge.
  • Bridge hanya bicara ke CUPS atau spooler Windows, tidak pernah ke Bluetooth.
  • Printer thermal 58 mm dan 80 mm memakai jalur ESC/POS, bukan CUPS foto.

03 · KEAMANAN LOKAL

Token bridge: cara generate

Bridge menolak start tanpa token minimal 16 karakter. Buat sekali, lalu pakai nilai yang sama di service bridge dan di kiosk.

Perintah generate

node -e "console.log(require('node:crypto').randomBytes(24).toString('base64url'))"
Perintah token per sistem operasi
SistemShellCatatan
macOS / Linuxzsh atau bashJalankan di terminal biasa. Node harus tersedia di PATH.
Windows PowerShellPowerShellPerintah yang sama berjalan. Gunakan PowerShell, bukan bash.
Windows cmd.exeCommand PromptPerintah yang sama berjalan tanpa perubahan.

Perintah memakai base64url yang tersedia sejak Node 15.7. Repo ini mensyaratkan Node 22 atau lebih baru, jadi aman di semua mesin kiosk yang didukung.

Simpan di service bridge

Setel PHOTOBOOTH_BRIDGE_TOKEN pada environment service bridge. Nilai kosong atau kurang dari 16 karakter membuat bridge menolak start.

Simpan di kiosk

Buka Setup Perangkat, isi field “Token bridge”. Nilai disimpan di localStorage perangkat ini saja dan tidak pernah masuk database.

Alamat dan header

URL
http://127.0.0.1:17777
Terbuka
/health tanpa token, dipakai Setup Perangkat untuk deteksi awal.
Rute lain
Wajib header X-Bridge-Token; token salah dijawab 401.

Windows

Bridge memakai adapter windows dan PowerShell spooler. Tidak ada systemd; jalankan service lewat mekanisme Windows yang biasa dipakai.

macOS

Pasang gphoto2 lewat Homebrew dan pakai CUPS untuk printer. Tidak ada systemd; contoh launchd tidak disediakan.

Catatan keamanan

Token adalah rahasia perangkat. Jangan commit ke repo, jangan taruh di database, dan jangan bagikan lewat chat. Siapa pun yang memegang token bisa memicu shutter dan mencetak.

Sumber kebenaran.

Angka kamera dihitung dari katalog gphoto2 saat build. Jalur printer dan aturan token mengikuti kode berjalan di kiosk dan bridge lokal, bukan asumsi dukungan vendor.