คู่มือใช้งาน CamCat ถ่ายรูปแยกโฟลเดอร์ · Web App (PWA) · v2.2.2

แอปนี้ทำอะไร

CamCat คือเว็บแอป (ติดตั้งเป็น PWA ได้) สำหรับถ่ายรูปหน้างานบนมือถือ จัดกลุ่มเป็นโฟลเดอร์ตามไซต์ พร้อมฝังข้อมูล EXIF/GPS ลงในไฟล์รูป รวบทั้งโฟลเดอร์เป็น ZIP แล้วดาวน์โหลดเก็บไว้

ถ่ายรูป + ไฟแฟลช + ซูม โฟลเดอร์ Site a 2569.10.25.21.45 นำเข้า CSV EXIF + GPS ในไฟล์ ZIP ทั้งโฟลเดอร์ ใช้ได้แม้ออฟไลน์

1เริ่มใช้งาน

เปิดผ่าน HTTPS เท่านั้น — กล้องจะทำงานเฉพาะหน้าเว็บที่ปลอดภัย

เปิดแอป

  1. สแกน QR ที่ผู้ดูแลส่งให้ ด้วยกล้องมือถือ → เปิดลิงก์ใน Chrome
  2. หรือพิมพ์ URL ที่ขึ้นต้นด้วย https:// ใน Chrome
  3. อนุญาต กล้อง และ ตำแหน่ง (ตำแหน่งใช้ฝัง GPS ลงรูป)
  4. ติดตั้งเป็นแอป: เมนู ⋮ → เพิ่มไปที่หน้าจอหลัก / ติดตั้งแอป
ทำไมต้อง HTTPS เบราว์เซอร์อนุญาต getUserMedia เฉพาะ secure context ถ้าเปิดด้วย http://192.168.x.x จะไม่เห็นกล้องและมักไม่ขึ้น error ที่ชัดเจน
ติดตั้งแล้วเปิดจากไอคอนบนหน้าจอหลัก ทำงานเต็มจอ (standalone)
ออฟไลน์เปิดแอปและถ่ายรูปได้ ข้อมูลเก็บในเครื่อง (IndexedDB)
ข้อมูลอยู่เครื่องไม่มีเซิร์ฟเวอร์เก็บรูป ลบแอป/ล้างข้อมูล = รูปหาย

2สิทธิ์กล้องและตำแหน่ง

ครั้งแรกจะมีหน้าต่างขออนุญาต — ต้องกด “อนุญาต”
สิทธิ์ใช้ทำอะไรถ้าไม่อนุญาต
กล้อง (Camera)แสดงภาพสดและถ่ายรูปขึ้นหน้าแจ้งพร้อมปุ่ม “ลองใหม่”
ตำแหน่ง (Location)ฝังพิกัด GPS + ความแม่นยำลง EXIFถ่ายได้ปกติ แต่รูปไม่มี GPS

ถ้าเผลอกดบล็อกไปแล้ว (Samsung / Android)

  1. การตั้งค่า → แอป → Chrome → สิทธิ์ → กล้อง → อนุญาต
  2. ทำแบบเดียวกันกับ ตำแหน่ง
  3. หรือกดไอคอนกุญแจ/แถบที่อยู่ → การอนุญาตของไซต์ → รีเซ็ตสิทธิ์
  4. กลับมาเปิดแอปใหม่ แล้วกด “ลองใหม่”
ถ้ากล้องไม่ขึ้นเลยทั้งที่อนุญาตแล้ว มักเปิดผ่าน http:// อยู่ — ตรวจว่า URL ขึ้นต้นด้วย https:// หรือเปิดในแท็บที่ไม่ได้ติดตั้งจากลิงก์ tunnel ที่หมดอายุ

3หน้าถ่ายรูป

แถบเมนูล่างมี 3 แท็บ: กล้อง · โฟลเดอร์ · รูปภาพ
ปุ่มทำอะไร
มุมขวาบนสร้างโฟลเดอร์ใหม่ทันที (ชื่อตามกฎ) — ใช้บ่อยตอนเริ่มงาน
สลับธีม ตามระบบ → สว่าง → มืด
ข้อมูลอุปกรณ์และกล้อง (diagnostics)
วงกลมขาวตรงกลางชัตเตอร์ — ถ่ายและบันทึกเข้าช่องโฟลเดอร์ที่ใช้งาน
ปุ่มเพิ่ม/ลดเสียงชัตเตอร์สำรอง (เฉพาะ APK) — กดค้าง/กดรัวมี debounce 0.6 วิ
ไฟแฟลช (torch) — แสดงเฉพาะเครื่องที่รองรับ (S23 รองรับ)
สลับกล้องหน้า/หลัง
เปิด/ปิดเส้นแบ่ง 3 ส่วน
1× 2× 3×ซูมแบบแตะ (แสดงตามความสามารถของกล้อง)
4:3 / 3:4สลับอัตราส่วนภาพ — กรอบพรีวิวเปลี่ยนตาม และไฟล์ที่ได้ถูกครอปตามจริง
รูปย่อซ้ายล่างเปิดรูปล่าสุดที่เพิ่งถ่าย

ระหว่างถ่าย

  • รูปถูกบันทึกทันทีที่กดชัตเตอร์ พร้อม EXIF และ GPS (ถ้าอนุญาต)
  • เลขมุมขวาล่างบอกจำนวนรูปในโฟลเดอร์ปัจจุบัน
  • ออกจากแท็บกล้อง กล้องจะหยุดเพื่อประหยัดแบต — กลับมาเปิดใหม่ให้อัตโนมัติ
  • สลับแอประหว่างถ่าย กล้องจะถูกปิดและเปิดใหม่เมื่อกลับมา
ภาพตั้งตรงอัตโนมัติ หลังถ่าย ระบบอ่าน EXIF Orientation ของไฟล์ → หมุนพิกเซลให้ตั้งตรง → เขียน Orientation = 1 กลับ (ถ้าเบราว์เซอร์หมุนให้อยู่แล้วจะ bake ทับ ไม่หมุนซ้ำ) · ถ้าภาพยังเอียง ใช้ปุ่มหมุนซ้าย/ขวาในชีตรูป
แนวนอนไม่พัง เวอร์ชัน APK ล็อกแนวตั้ง (screenOrientation=portrait) — ถือมือถือแนวนอน UI ไม่หมุนตาม ยังกดชัตเตอร์ถ่ายได้ปกติ · บนเว็บ เบราว์เซอร์อาจหมุนจอเองแต่ปุ่มยังอยู่ในกรอบ
ได้ความละเอียดเท่าไร แอปจะใช้ 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 ใต้ชื่อแอปจะเปลี่ยน)
ลบโฟลเดอร์ = ลบรูปในเครื่องถาวร ถ้ารูปสำคัญ ให้ ZIP ออกมาก่อนทุกครั้ง

5นำเข้าโฟลเดอร์จาก CSV

สร้างทีละหลายโฟลเดอร์จากไฟล์ Excel / Google Sheets ที่บันทึกเป็น CSV

หัวตาราง 4 คอลัมน์

คอลัมน์ค่าเว้นว่างได้
siteคำนำหน้า เช่น Siteได้ → ใช้ Site
lettera…z, aa…ได้ → ไล่ต่ออัตโนมัติ
datetime2569.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

วิธีใช้

  1. เปิดแท็บ โฟลเดอร์ → กด CSV
  2. กด เลือกไฟล์ CSV แล้วเลือกไฟล์จากเครื่อง
  3. ระบบสร้างโฟลเดอร์ทีละรายการ แล้วสรุปผลให้ดู
แถวที่ถูกข้าม ระบบจะบอกเลขแถวและเหตุผล เช่น แถว 5: datetime "bad" อ่านไม่ได้ หรือ ชื่อซ้ำ: Site g 2569.10.26.11.00 — แถวที่ถูกต้องยังถูกสร้างตามปกติ

ข้อควรระวังของไฟล์

  • บันทึกเป็น CSV UTF-8 (Excel: “CSV UTF-8 (comma delimited)”) เพื่อให้ชื่อไทยไม่เพี้ยน
  • คั่นด้วย comma หรือ semicolon หรือ tab ก็ได้ (ระบบตรวจให้อัตโนมัติ)
  • ชื่อที่มี comma ให้ครอบด้วย "…"
  • ปีที่กรอกเป็น ค.ศ. ระบบแปลงเป็น พ.ศ. ให้ (บวก 543)

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)
ปุ่มแชร์ ZIP ถูกถอดออกแล้ว ถ้าต้องการส่งเข้าแอปอื่น ให้ดาวน์โหลด ZIP แล้วแชร์จาก My Files ส่วนการส่งรูปเดี่ยวใช้ปุ่ม แชร์รูปนี้ ในชีตรูปได้ทันที

8EXIF ที่ฝังอยู่ในไฟล์

เปิดรูปด้วย Samsung Gallery / Google Photos / exiftool แล้วเห็นข้อมูลทันที
กลุ่ม (IFD)แท็กที่เขียน
IFD0ImageDescription (CamCat · ชื่อโฟลเดอร์), Make, Model, Artist, Orientation, X/YResolution + Unit, Software, DateTime
ExifExifVersion 0232, DateTimeOriginal, DateTimeDigitized, ComponentsConfiguration, ColorSpace (sRGB), PixelXDimension, PixelYDimension, ExposureBias, ExposureMode/WhiteBalance/DigitalZoomRatio/Contrast/Saturation/Sharpness, ImageUniqueID
GPSGPSVersionID, Latitude/Longitude (องศา-ลิปดา-ฟิลิปดา), Altitude, GPSTimeStamp, GPSDateStamp, GPSProcessingMethod, GPSHPositioningError (± เมตร)
ชื่อโฟลเดอร์ภาษาไทย แท็ก ASCII เก็บได้เฉพาะอักษรละติน ระบบจึงเก็บชื่อไทยไว้ใน XPComment / XPKeywords (UTF-16LE) ทำให้เปิดใน Windows Explorer หรือโปรแกรมที่อ่าน XP tags แล้วเห็นชื่อไทยครบ
สิ่งที่เบราว์เซอร์ทำให้ไม่ได้ ไม่สามารถสร้าง MakerNote เฉพาะของ Samsung (โหมดถ่าย, เลนส์, ค่าเฉพาะเครื่อง) หรือไฟล์ HEIF ได้ เพราะเป็นข้อมูล proprietary ของแอปกล้องเครื่อง — EXIF มาตรฐานตามตารางข้างบนครบถ้วน

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.cssDesign tokens + คอมโพเนนต์ (light/dark)
js/main.jsstate, event, ธีม, diagnostics
js/camera.jsgetUserMedia, ImageCapture, torch, zoom
js/exif.jsเขียน/อ่าน EXIF (piexifjs)
js/csv.jsparse CSV + วางแผนสร้างโฟลเดอร์
js/naming.jsกฎชื่อ Site + ตัวอักษร + เวลาไทย
js/archive.jsสร้าง ZIP + ดาวน์โหลด/แชร์
sw.js / manifest.jsonPWA cache + ข้อมูลติดตั้ง
templates/folders-template.csvไฟล์ CSV เปล่า (หัวตาราง)
อัปเดตแอปแล้วไม่เห็นของใหม่ Service Worker จะถือไฟล์เวอร์ชันเก่า — เพิ่มเลข CACHE ใน sw.js แล้วปิด/เปิดแท็บใหม่ หรือล้างข้อมูลไซต์