แอปนี้ทำอะไร
CamCat คือเว็บแอป (ติดตั้งเป็น PWA ได้) สำหรับถ่ายรูปหน้างานบนมือถือ จัดกลุ่มเป็นโฟลเดอร์ตามไซต์ พร้อมฝังข้อมูล EXIF/GPS ลงในไฟล์รูป รวบทั้งโฟลเดอร์เป็น ZIP แล้วดาวน์โหลดเก็บไว้
1เริ่มใช้งาน
เปิดแอป
- สแกน QR ที่ผู้ดูแลส่งให้ ด้วยกล้องมือถือ → เปิดลิงก์ใน Chrome
- หรือพิมพ์ URL ที่ขึ้นต้นด้วย
https://ใน Chrome - อนุญาต กล้อง และ ตำแหน่ง (ตำแหน่งใช้ฝัง GPS ลงรูป)
- ติดตั้งเป็นแอป: เมนู ⋮ → เพิ่มไปที่หน้าจอหลัก / ติดตั้งแอป
getUserMedia เฉพาะ secure context ถ้าเปิดด้วย
http://192.168.x.x จะไม่เห็นกล้องและมักไม่ขึ้น error ที่ชัดเจน
2สิทธิ์กล้องและตำแหน่ง
| สิทธิ์ | ใช้ทำอะไร | ถ้าไม่อนุญาต |
|---|---|---|
| กล้อง (Camera) | แสดงภาพสดและถ่ายรูป | ขึ้นหน้าแจ้งพร้อมปุ่ม “ลองใหม่” |
| ตำแหน่ง (Location) | ฝังพิกัด GPS + ความแม่นยำลง EXIF | ถ่ายได้ปกติ แต่รูปไม่มี GPS |
ถ้าเผลอกดบล็อกไปแล้ว (Samsung / Android)
- การตั้งค่า → แอป → Chrome → สิทธิ์ → กล้อง → อนุญาต
- ทำแบบเดียวกันกับ ตำแหน่ง
- หรือกดไอคอนกุญแจ/แถบที่อยู่ → การอนุญาตของไซต์ → รีเซ็ตสิทธิ์
- กลับมาเปิดแอปใหม่ แล้วกด “ลองใหม่”
http:// อยู่ — ตรวจว่า URL ขึ้นต้นด้วย https://
หรือเปิดในแท็บที่ไม่ได้ติดตั้งจากลิงก์ tunnel ที่หมดอายุ
3หน้าถ่ายรูป
| ปุ่ม | ทำอะไร |
|---|---|
| มุมขวาบน | สร้างโฟลเดอร์ใหม่ทันที (ชื่อตามกฎ) — ใช้บ่อยตอนเริ่มงาน |
| สลับธีม ตามระบบ → สว่าง → มืด | |
| ข้อมูลอุปกรณ์และกล้อง (diagnostics) | |
| วงกลมขาวตรงกลาง | ชัตเตอร์ — ถ่ายและบันทึกเข้าช่องโฟลเดอร์ที่ใช้งาน |
| ปุ่มเพิ่ม/ลดเสียง | ชัตเตอร์สำรอง (เฉพาะ APK) — กดค้าง/กดรัวมี debounce 0.6 วิ |
| ไฟแฟลช (torch) — แสดงเฉพาะเครื่องที่รองรับ (S23 รองรับ) | |
| สลับกล้องหน้า/หลัง | |
| เปิด/ปิดเส้นแบ่ง 3 ส่วน | |
| 1× 2× 3× | ซูมแบบแตะ (แสดงตามความสามารถของกล้อง) |
| 4:3 / 3:4 | สลับอัตราส่วนภาพ — กรอบพรีวิวเปลี่ยนตาม และไฟล์ที่ได้ถูกครอปตามจริง |
| รูปย่อซ้ายล่าง | เปิดรูปล่าสุดที่เพิ่งถ่าย |
ระหว่างถ่าย
- รูปถูกบันทึกทันทีที่กดชัตเตอร์ พร้อม EXIF และ GPS (ถ้าอนุญาต)
- เลขมุมขวาล่างบอกจำนวนรูปในโฟลเดอร์ปัจจุบัน
- ออกจากแท็บกล้อง กล้องจะหยุดเพื่อประหยัดแบต — กลับมาเปิดใหม่ให้อัตโนมัติ
- สลับแอประหว่างถ่าย กล้องจะถูกปิดและเปิดใหม่เมื่อกลับมา
ImageCapture.takePhoto() เพื่อดึงภาพนิ่งความละเอียดสูงสุดที่เบราว์เซอร์อนุญาต
ถ้าเครื่องนั้นไม่รองรับ จะถ่ายเฟรมจากวิดีโอแทน (ความละเอียดเท่าสตรีม เช่น 1920×1080)
ดูค่าจริงได้ที่ปุ่ม → “สตรีมกล้อง”
4โฟลเดอร์และกฎการตั้งชื่อ
รูปแบบ: Site <ตัวอักษร> <ปี พ.ศ.>.<เดือน>.<วัน>.<ชั่วโมง>.<นาที>
Site a 2569.10.25.21.45
Site b 2569.10.25.22.10
Site c 2569.10.26.08.00
ตัวอักษรไล่อย่างไร
นับแบบคอลัมน์ Excel: a … z → aa, ab … az → ba … bz → ca … ไปเรื่อย ๆ
ระบบเลือกตัวอักษรถัดไปจากชื่อโฟลเดอร์ที่มีอยู่จริง จึงไม่ชนกันแม้ลบหรือเปลี่ยนชื่อโฟลเดอร์เก่า
| ปุ่มในหน้าโฟลเดอร์ | ผล |
|---|---|
| + โฟลเดอร์ใหม่ | เปิดชีตให้ตรวจ/แก้ชื่อก่อนสร้าง |
| CSV | สร้างหลายโฟลเดอร์พร้อมกันจากไฟล์ (ดูข้อ 5) |
| ZIP ทุกโฟลเดอร์ | รวมทุกโฟลเดอร์เป็น ZIP เดียว แล้วดาวน์โหลด (แต่ละโฟลเดอร์เป็นโฟลเดอร์ย่อย) |
| เปลี่ยนชื่อโฟลเดอร์ (เปลี่ยนได้ตลอด ไม่กระทบรูป) | |
| ลบโฟลเดอร์ และรูปทั้งหมดในนั้น — กู้คืนไม่ได้ | |
| แตะที่แถวโฟลเดอร์ | ตั้งเป็นโฟลเดอร์ที่ใช้งาน (pill ใต้ชื่อแอปจะเปลี่ยน) |
5นำเข้าโฟลเดอร์จาก CSV
หัวตาราง 4 คอลัมน์
| คอลัมน์ | ค่า | เว้นว่างได้ |
|---|---|---|
site | คำนำหน้า เช่น Site | ได้ → ใช้ Site |
letter | a…z, aa… | ได้ → ไล่ต่ออัตโนมัติ |
datetime | 2569.10.25.21.45 (รับ 2026-10-25 21:45 ด้วย) | ไม่ได้ ถ้าไม่มี name |
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,หน้างานพิเศษ
ไฟล์เปล่า (หัวตารางเท่านั้น) ดาวน์โหลดได้ในชีต CSV → ปุ่ม ไฟล์เปล่า
หรือที่ templates/folders-template.csv
วิธีใช้
- เปิดแท็บ โฟลเดอร์ → กด CSV
- กด เลือกไฟล์ CSV แล้วเลือกไฟล์จากเครื่อง
- ระบบสร้างโฟลเดอร์ทีละรายการ แล้วสรุปผลให้ดู
แถว 5: datetime "bad" อ่านไม่ได้ หรือ
ชื่อซ้ำ: Site g 2569.10.26.11.00 — แถวที่ถูกต้องยังถูกสร้างตามปกติ
ข้อควรระวังของไฟล์
- บันทึกเป็น CSV UTF-8 (Excel: “CSV UTF-8 (comma delimited)”) เพื่อให้ชื่อไทยไม่เพี้ยน
- คั่นด้วย comma หรือ semicolon หรือ tab ก็ได้ (ระบบตรวจให้อัตโนมัติ)
- ชื่อที่มี comma ให้ครอบด้วย
"…" - ปีที่กรอกเป็น ค.ศ. ระบบแปลงเป็น พ.ศ. ให้ (บวก 543)
6แกลเลอรีและ Metadata
แท็บ รูปภาพ แสดงรูปของโฟลเดอร์ที่ใช้งานเป็นตาราง 3 คอลัมน์ (4 คอลัมน์บนจอใหญ่) แตะรูปเพื่อเปิดชีตรายละเอียด
ข้อมูลที่แสดงในชีตรูป
| รายการ | ที่มา |
|---|---|
| ชื่อไฟล์ / ขนาด / ความละเอียด (MP) | ไฟล์จริง |
| ถ่ายเมื่อ (วันที่ไทย พ.ศ.) | เวลาที่บันทึก |
| อุปกรณ์ / กล้องหน้า-หลัง / ที่มาไฟล์ | ตรวจจากเบราว์เซอร์ + วิธีจับภาพ |
| พิกัด GPS ± ความแม่นยำ (เมตร) | geolocation ตอนกดชัตเตอร์ |
| รุ่นใน EXIF / Orientation / DateTimeOriginal / Software | อ่านกลับจากไฟล์ |
| ImageUniqueID | รหัสเฉพาะของรูป |
ปุ่มในชีตรูป
- แชร์รูปนี้ — ส่ง “ไฟล์รูปเดี่ยว” เข้า share sheet ของเครื่อง
- ลบรูปนี้ — ลบเฉพาะรูปนี้ในเครื่อง (ถาวร)
7ZIP และการแชร์
ในแท็บ รูปภาพ มีปุ่มเดียวที่แถบล่าง: ZIP ทั้งโฟลเดอร์ (N รูป)
สิ่งที่ได้ในไฟล์ ZIP
Site b 2569.10.25.23.10.zip
└── Site b 2569.10.25.23.10/ ← โฟลเดอร์จริงในไฟล์ zip
├── Site_b_2569.10.25.23.10_0001.jpg
└── Site_b_2569.10.25.23.10_0002.jpg
- แตกไฟล์แล้วได้ โฟลเดอร์ ไม่ใช่รูปกระจัดกระจายที่ root
- ไฟล์ JPEG ทุกรูปอยู่ข้างใน (ไม่บีบอัดซ้ำ เพื่อความเร็วบนมือถือ)
- ไม่มีไฟล์ JSON แยก — metadata อยู่ใน EXIF ของแต่ละรูป (ดูข้อ 8)
ZIP ทุกโฟลเดอร์ (ครั้งเดียว)
หน้าโฟลเดอร์ → ปุ่ม ZIP ทุกโฟลเดอร์ (N รูป) ได้ไฟล์เดียวชื่อ
CamCat-all-YYYYMMDD-HHMM.zip โดยแต่ละโฟลเดอร์เป็นโฟลเดอร์ย่อยของตัวเอง:
CamCat-all-20261029-0002.zip
├── Site a 2569.10.25.21.45/
│ └── Site_a_2569.10.25.21.45_0001.jpg
└── Site b 2569.10.25.23.10/
└── Site_b_2569.10.25.23.10_0001.jpg
ปลายทางของไฟล์
- Chrome จะบันทึกที่โฟลเดอร์ Download ของเครื่อง (ดูได้ใน My Files → Downloads)
- ชื่อไฟล์ zip ใช้ชื่อโฟลเดอร์ เช่น
Site a 2569.10.25.22.15.zip - ต้องมีพื้นที่ว่างพอ — ขนาด zip ≈ ผลรวมขนาดรูป (บวกไม่กี่ KB)
8EXIF ที่ฝังอยู่ในไฟล์
| กลุ่ม (IFD) | แท็กที่เขียน |
|---|---|
| IFD0 | ImageDescription (CamCat · ชื่อโฟลเดอร์), Make, Model, Artist, Orientation, X/YResolution + Unit, Software, DateTime |
| Exif | ExifVersion 0232, DateTimeOriginal, DateTimeDigitized, ComponentsConfiguration, ColorSpace (sRGB), PixelXDimension, PixelYDimension, ExposureBias, ExposureMode/WhiteBalance/DigitalZoomRatio/Contrast/Saturation/Sharpness, ImageUniqueID |
| GPS | GPSVersionID, Latitude/Longitude (องศา-ลิปดา-ฟิลิปดา), Altitude, GPSTimeStamp, GPSDateStamp, GPSProcessingMethod, GPSHPositioningError (± เมตร) |
XPComment / XPKeywords
(UTF-16LE) ทำให้เปิดใน Windows Explorer หรือโปรแกรมที่อ่าน XP tags แล้วเห็นชื่อไทยครบ
9ธีม & ข้อมูลเครื่อง
ธีม
ปุ่ม ☾/☀ บนหัวแอป วน 3 สถานะ: ตามระบบ → สว่าง → มืด ค่าถูกจำไว้ในเครื่อง
ข้อมูลอุปกรณ์และกล้อง
กด บนหัวแอป หรือปุ่มในหน้าโฟลเดอร์ จะเห็น:
- รุ่นเครื่อง (เช่น
Galaxy S23 (SM-S911B)) และเวอร์ชัน Android/Chrome - ขนาดหน้าจอ CSS, DPR, visualViewport, โหมดติดตั้ง PWA
- สถานะ HTTPS (จำเป็นต่อกล้อง), URL ปัจจุบัน
- ความละเอียดสตรีมกล้อง, กล้องหน้า/หลัง, การรองรับ ImageCapture
- ไฟแฟลช, ช่วงซูม, โหมดโฟกัส, การรองรับแชร์ไฟล์
- พื้นที่เก็บข้อมูลที่ใช้ไป และจำนวนโฟลเดอร์/รูป
QR ลิงก์ทดสอบ
หน้าโฟลเดอร์ → QR ลิงก์ทดสอบ แสดง QR ของ URL ที่กำลังเปิดอยู่
ใช้ส่งต่อให้เครื่องอื่น หรือเช็กว่าลิงก์เป็น https:// จริง
10ปัญหาที่พบบ่อย
เปิดแอปแล้วไม่เห็นภาพกล้อง
- URL ต้องเป็น
https://(ไม่ใช่http://และไม่ใช่ IP ใน LAN ตรง ๆ) - ตรวจสิทธิ์กล้องของ Chrome ตามข้อ 2
- ปิดแอปอื่นที่ใช้กล้องอยู่ (กล้อง/วิดีโอคอล) แล้วกด “ลองใหม่”
ไม่มี GPS ในรูป
- ยังไม่ได้อนุญาตสิทธิ์ตำแหน่ง → อนุญาตแล้วถ่ายใหม่
- อยู่ในที่ร่ม/ในอาคาร GPS อาจไม่ล็อกภายใน 7 วินาที (แอปจะบันทึกรูปโดยไม่มีพิกัด)
รูปที่ถ่ายได้ความละเอียดไม่สูง
- เครื่องนั้นไม่รองรับ
ImageCapture→ ระบบใช้เฟรมวิดีโอ (ดู “ที่มาไฟล์” ในชีตรูป) - ตรวจค่าจริงได้ที่หน้า diagnostics → “สตรีมกล้อง”
กด ZIP แล้วไม่มีไฟล์
- ดูที่ Chrome → ดาวน์โหลด (หรือ My Files → Downloads)
- ถ้าพื้นที่เครื่องเต็ม การดาวน์โหลดจะล้มเหลว — ลบรูปเก่าหรือย้าย ZIP ออกก่อน
ลิงก์ที่ได้มาเปิดไม่ได้
- ลิงก์ tunnel เป็นลิงก์ชั่วคราว ถ้าเซิร์ฟเวอร์/เครื่องแม่ข่ายปิด จะใช้ไม่ได้ทันที — ขอ QR ใหม่
ข้อมูลในแอปหายหลังล้างข้อมูลเบราว์เซอร์
- รูปเก็บใน IndexedDB ของเบราว์เซอร์ การ “ล้างข้อมูลไซต์” หรือถอนการติดตั้งจะลบทั้งหมด → ZIP เก็บไว้เป็นประจำ
11ข้อจำกัดที่ควรรู้
- ต้องมี HTTPS — ไม่มีทางเลี่ยงได้บนมือถือ (ยกเว้นตั้งค่า chrome://flags เป็นกรณียกเว้น)
- EXIF เฉพาะมาตรฐาน — ไม่มี MakerNote ของ Samsung/HEIF
- ข้อมูลอยู่ในเครื่องนี้เท่านั้น — ไม่ซิงก์ข้ามเครื่อง ไม่มี backup อัตโนมัติ
- พื้นที่เก็บ — เบราว์เซอร์ให้พื้นที่ตาม quota ของเครื่อง (ดูในหน้า diagnostics)
- การแชร์ไฟล์ — ใช้ได้เฉพาะเบราว์เซอร์ที่รองรับ Web Share ระดับไฟล์ (Chrome Android รองรับ)
12สำหรับผู้ดูแลระบบ
รันบนเครื่องทดสอบ
cd app
python -m http.server 8099 --bind 0.0.0.0
# กล้องต้องใช้ HTTPS → เปิด tunnel
cloudflared tunnel --url http://127.0.0.1:8099 --no-autoupdate
ไฟล์สำคัญ
| ไฟล์ | หน้าที่ |
|---|---|
index.html | โครงหน้า + header/nav |
css/app.css | Design tokens + คอมโพเนนต์ (light/dark) |
js/main.js | state, event, ธีม, diagnostics |
js/camera.js | getUserMedia, ImageCapture, torch, zoom |
js/exif.js | เขียน/อ่าน EXIF (piexifjs) |
js/csv.js | parse CSV + วางแผนสร้างโฟลเดอร์ |
js/naming.js | กฎชื่อ Site + ตัวอักษร + เวลาไทย |
js/archive.js | สร้าง ZIP + ดาวน์โหลด/แชร์ |
sw.js / manifest.json | PWA cache + ข้อมูลติดตั้ง |
templates/folders-template.csv | ไฟล์ CSV เปล่า (หัวตาราง) |
CACHE ใน sw.js
แล้วปิด/เปิดแท็บใหม่ หรือล้างข้อมูลไซต์