- android/ — Capacitor project (build/, local.properties ignored) - app/js/native.js — bridge สำหรับ APK: savePhoto/saveZip/shareItems ผ่าน Filesystem+Share - app/js/csv.js — นำเข้าโฟลเดอร์หลายรายการจาก CSV (site,letter,datetime,name) - app/js/orient.js — จัดการ orientation ของ preview/กล้อง - app/manual.html + APK.md — คู่มือใช้งานและวิธี build APK - app/templates/folders-template.csv — เทมเพลต CSV - package.json / package-lock.json / capacitor.config.json / scripts/build-apk.sh - ปรับ ui, camera, exif, archive, db, naming, main, sw + css/README ตามงานข้างบน
CamCat — Web Camera Category PWA (One UI)
PWA ถ่ายรูปหน้างาน แยกโฟลเดอร์ตามไซต์ พร้อม Metadata, ZIP ทั้งโฟลเดอร์ และแชร์ผ่านระบบของมือถือ หน้าตาออกแบบตามภาษา Samsung One UI (การ์ดมุมโค้ง 26px, พิลล์, ธีมสว่าง/มืด, ไอคอน SVG ล้วน)
Features
- กล้องหลัง/หน้า, ไฟแฟลช (torch), ซูมแบบ pills 1×/2×/3×, เส้นแบ่ง 3 ส่วน, อัตราส่วนภาพ 4:3 / 3:4 (ครอปจริง)
- จัดทิศทางภาพอัตโนมัติ (EXIF Orientation → หมุนพิกเซล → Orientation=1) + ปุ่มหมุนซ้าย/ขวาในชีตรูป
- APK: ปุ่มเพิ่ม/ลดเสียง = ชัตเตอร์, ล็อกแนวตั้ง
- ถ่ายด้วย
ImageCapture.takePhoto()(ความละเอียดเต็ม) fallback เป็น canvas - เขียน EXIF มาตรฐานลงไฟล์จริงก่อนบันทึก (Make/Model/Software/DateTimeOriginal/ExifVersion/ColorSpace/Resolution/ImageUniqueID + GPS ละเอียด/เวลา/ความแม่นยำ) → ติดไปตอนแชร์
- โฟลเดอร์ชื่อเริ่มต้นอัตโนมัติ:
Site <ตัวอักษร> <ปี พ.ศ.>.<เดือน>.<วัน>.<ชั่วโมง>.<นาที>- ตัวอักษรไล่ a…z แล้วต่อ aa, ab … az, ba … (แบบคอลัมน์ Excel)
- ปุ่ม
+บนหัวแอป = สร้างทันที · ปุ่ม "โฟลเดอร์ใหม่" = เปิดชีตแก้ชื่อก่อนสร้าง · เปลี่ยนชื่อทีหลังได้ (ปุ่มดินสอ)
- นำเข้าโฟลเดอร์ทีละหลายรายการจาก CSV (ดูหัวตารางด้านล่าง) — ไฟล์เปล่า:
templates/folders-template.csv - ZIP ทุกรูปในโฟลเดอร์ (มีแต่ JPEG — metadata อยู่ใน EXIF ของแต่ละไฟล์) แล้วดาวน์โหลดลงเครื่อง
- โครงสร้างใน zip =
<ชื่อโฟลเดอร์>/<ไฟล์>.jpg→ แตกออกมาเป็นโฟลเดอร์จริง
- โครงสร้างใน zip =
- ปุ่ม ZIP ทุกโฟลเดอร์ ที่หน้าโฟลเดอร์ → ไฟล์เดียว
CamCat-all-<stamp>.zipแยกโฟลเดอร์ย่อยครบทุกโฟลเดอร์ - ปุ่ม ZIP = รวมทุกรูปในโฟลเดอร์แล้วดาวน์โหลดลงเครื่อง (ปุ่มแชร์ ZIP ถูกถอดออกตามคำสั่ง)
- ธีมสว่าง/มืด/ตามระบบ (จำค่าไว้), safe-area, 100dvh, ปุ่ม ≥44px ตาม One UI
- QR ลิงก์ทดสอบบนมือถือ (ต้อง HTTPS) + หน้าข้อมูลอุปกรณ์/กล้อง (diagnostics)
- Offline: Service Worker + IndexedDB, ติดตั้งเป็น PWA ได้
- คู่มือใช้งานหน้าเดียว (standalone HTML, พิมพ์/บันทึก PDF ได้):
manual.html→ เปิดที่/manual.html
Design (One UI)
| องค์ประกอบ | ค่า |
|---|---|
| สีหลัก light | bg #F2F3F5 · card #FFFFFF · text #101114 · accent #0A72DE |
| สีหลัก dark | bg #000000 · card #1B1B1D · text #F2F3F5 · accent #4E9DFF |
| มุมโค้ง | การ์ด 26px · ช่องกรอก 16px · ปุ่ม/ชิปเป็น pills |
| ตัวอักษร | One UI Sans → SF / Segoe / Roboto / Noto Sans Thai |
| ระยะ | 4/8px rhythm, ขอบข้าง 20px |
| Accessibility | ข้อความ ≥4.5:1, ปุ่ม ≥44px, reduced-motion, focus ring |
| หน้าเมนูกล้อง | โครมดำทั้งหน้าแบบ One UI Camera |
นำเข้าโฟลเดอร์จาก CSV
หัวตาราง 4 คอลัมน์ (ทุกคอลัมน์เว้นว่างได้):
| คอลัมน์ | ความหมาย |
|---|---|
site |
คำนำหน้า เช่น Site (เว้นว่าง = Site) |
letter |
a…z, aa… (เว้นว่าง = ไล่ต่อจากโฟลเดอร์ที่มีอยู่ให้อัตโนมัติ) |
datetime |
2569.10.25.21.45 (รับ - / : หรือ ค.ศ. ได้ เช่น 2026-10-25 21:45) |
name |
ชื่อเต็ม ถ้าใส่จะใช้ค่านี้แทนการประกอบชื่อ |
ตัวอย่าง:
site,letter,datetime,name
Site,a,2569.10.25.21.45,
Site,b,2569.10.25.22.10,
Site,,2569.10.26.08.00,หน้างานพิเศษ
กติกาที่ระบบบังคับ: letter ต้อง a-z · datetime ต้องอ่านเป็นวันเวลาได้ · ชื่อซ้ำจะถูกข้ามพร้อมรายงานแถวที่ผิด
ปุ่มแชร์ ZIP (Web Share)
- ZIP ถูกสร้างล่วงหน้าหลังเปิดแกลเลอรี → กด "แชร์ ZIP" แล้วเรียก
navigator.share({files})ทันทีในจังหวะแตะ (ไม่ให้ user activation หมดอายุ) - ถ้ายังไม่มี ZIP / เบราว์เซอร์ตัดสิทธิ์ → เปิดชีต "ZIP พร้อมแล้ว" ให้กด "แชร์ไปแอปอื่น" อีกครั้ง (activation ใหม่) หรือ "บันทึกไฟล์"
- เบราว์เซอร์ที่ไม่รองรับแชร์ไฟล์ (เช่น Samsung Internet บางเวอร์ชัน) → ปุ่มแชร์ถูกปิด พร้อมปุ่มบันทึกไฟล์แทน
EXIF ที่ฝังในไฟล์ (per photo)
| IFD | tag |
|---|---|
| IFD0 | 270 ImageDescription (CamCat · <โฟลเดอร์>) · 271 Make samsung · 272 Model SM-S911B · 274 Orientation · 282/283/296 Resolution · 305 Software · 306 DateTime |
| Exif | 36864 ExifVersion 0232 · 36867/36868 DateTimeOriginal/Digitized · 37121 ComponentsConfiguration · 37380 ExposureBias · 40961 ColorSpace sRGB · 40962/40963 Pixel dims · 41985–41994 (rendering modes) · 42016 ImageUniqueID |
| GPS | 0 Version · 1/2 LatRef+Lat · 3/4 LonRef+Lon · 5/6 Altitude · 7 TimeStamp · 27 ProcessingMethod · 29 DateStamp · 31 HPositioningError (±เมตร) |
ไม่มีไฟล์ JSON แยก — เปิดรูปด้วยแอป Samsung Gallery / Google Photos / exiftool แล้วเห็นค่าพวกนี้ทันที
รันทดสอบ
cd app
python -m http.server 8099 --bind 0.0.0.0
# กล้องใช้ได้เฉพาะ HTTPS — เปิด tunnel แล้วสแกน QR ในแอป
cloudflared tunnel --url http://127.0.0.1:8099
Files
app/
├── index.html # shell + header/nav แบบ One UI
├── css/app.css # design tokens + components (light/dark)
├── js/config.js # ค่าคงที่ (Site A, timezone, quality)
├── js/naming.js # ชื่อโฟลเดอร์/ไฟล์ ปี พ.ศ.
├── js/db.js # IndexedDB (folders, images, thumbs)
├── js/exif.js # อ่าน/เขียน EXIF (piexifjs)
├── js/device.js # ตรวจรุ่นเครื่อง (SM-S911B → Galaxy S23)
├── js/camera.js # getUserMedia, ImageCapture, torch, zoom
├── js/archive.js # ZIP + ดาวน์โหลด + Web Share (มี cache)
├── js/ui.js # markup + bottom sheet + toast
├── js/main.js # state, events, ธีม, diagnostics
├── vendor/ # jszip, piexif, qrcode (ใช้ offline)
├── sw.js · manifest.json · icon-*.png
└── README.md
Browser
Chrome/Edge Android (Samsung S23 คือเครื่องทดสอบหลัก) · Safari 16+ (ไม่มี torch/zoom)