Tài liệu vận hành chính thức

Hướng dẫn
Sử dụng 5Pic Photobooth

Hướng dẫn đầy đủ từng bước để thiết lập hệ thống in ảnh tự động — từ cấu hình máy ảnh, ứng dụng macOS đến làm chủ bảng điều khiển Web Portal.

Tải App macOS Hướng Dẫn Web Portal Cấu hình máy ảnh
Cài đặt App trên macOS
Tải về và cài đặt ứng dụng 5Pic Photo Print Hub cho máy Mac
📦

5Pic Photo Print Hub — macOS App

🍎 macOS 12+ (Monterey trở lên) ⚡ Apple Silicon (M1/M2/M3/M4) 📦 ~122 MB (DMG) / ~106 MB (ZIP) v2.0.0 Mới nhất
1

Tải file cài đặt

Nhấn nút "Tải về (.dmg)" bên trên để tải file 5Pic-Photo-Print-Hub-2.0.0-arm64.dmg về máy Mac của anh/chị.

2

Mở file DMG

Double-click vào file .dmg vừa tải về. Một cửa sổ Finder sẽ xuất hiện với icon ứng dụng 5Pic Photobooth.

💡

Nếu macOS hiện thông báo "Cannot open because the developer cannot be verified", hãy Right-click → Open thay vì double-click.

3

Kéo vào thư mục Applications

Kéo icon 5Pic Photobooth.app vào thư mục Applications (mũi tên chỉ sang phải trong cửa sổ DMG).

4

Mở ứng dụng lần đầu

Mở Finder → Applications → 5Pic Photobooth và double-click để khởi chạy. Ứng dụng sẽ hỏi một số quyền truy cập — nhấn OK/Allow tất cả.

5

Đăng nhập tài khoản

Nhập tài khoản Admin đã được cấp (email + mật khẩu). App sẽ tự động tải danh sách sự kiện của anh/chị từ máy chủ.

✅

Server: photobooth.5pic.click — kết nối cloud, không cần cấu hình thêm.


Cấu hình máy ảnh FTP
Thiết lập truyền ảnh trực tiếp từ máy ảnh → máy chủ qua WiFi
📡

Máy ảnh sẽ gửi ảnh trực tiếp qua WiFi đến máy chủ 5Pic mỗi khi chụp xong. Đảm bảo máy ảnh và laptop cùng mạng WiFi (hoặc cấu hình qua 4G/internet). Dưới đây là thông số cần nhập vào menu máy ảnh.

Thông số Giá trị cần nhập Ghi chú
FTP Server / Host photobooth.5pic.click hoặc IP: 222.255.181.152
FTP Port 21 Cổng FTP tiêu chuẩn
Transfer Mode Passive (PASV) Bắt buộc — Active sẽ không hoạt động
Username / Tên đăng nhập Xem trong Admin Portal Mỗi sự kiện có user riêng
Password / Mật khẩu Xem trong Admin Portal Mỗi sự kiện có pass riêng
Destination Folder / Để trống hoặc dấu "/"
Transfer After Shot Bật / Enable Tự động gửi ngay sau chụp
🔑

Lấy Username/Password FTP: Vào Admin Portal → Danh sách sự kiện → Nhấn vào sự kiện cần cấu hình → Xem thông tin FTP ở tab "Cài đặt FTP".


📖 Menu điều hướng theo từng dòng máy ảnh

📷 Sony Alpha (A7 / A9 / ZV)
📷 Canon EOS R / 5D / 90D
📷 Nikon Z / D-series
📷 Fujifilm X-T / X-H series
1

Kết nối WiFi cho máy ảnh

Vào Menu WiFi của máy ảnh → chọn mạng WiFi sự kiện. Đảm bảo máy ảnh thấy kết nối internet để truyền đến server 5Pic.

2

Nhập thông tin FTP Server

Theo hướng dẫn menu từng dòng máy ở trên, nhập đúng địa chỉ server photobooth.5pic.click, port 21, chế độ Passive và tài khoản FTP của sự kiện.

3

Bật tính năng tự động gửi ảnh

Bật chế độ "Auto Transfer" hoặc "Transfer After Shot" — máy ảnh sẽ gửi ảnh lên server ngay sau mỗi lần chụp.

✅

Kiểm tra bằng cách chụp thử 1 ảnh rồi vào Admin Portal → Sự kiện → Ảnh để xem ảnh đã xuất hiện chưa.


Hướng dẫn sử dụng Web Portal Quản trị
Làm chủ bảng điều khiển đám mây: tạo sự kiện, cấu hình khung, live queue và điều khiển in
🌐

Hệ thống Web Portal chạy tại: photobooth.5pic.click/portal.html (hoặc bản React UI v3 tại photobooth.5pic.click/app/). Đây là trung tâm đầu não giúp bạn điều hành mọi sự kiện từ xa.

1

Đăng nhập & Quản lý danh sách sự kiện

Truy cập Web Portal và đăng nhập bằng tài khoản Quản trị (Admin) hoặc Người dùng (User). Màn hình chính sẽ hiển thị danh sách tất cả các sự kiện của bạn kèm trạng thái số lượng ảnh đã chụp, ảnh đã in và dung lượng lưu trữ.

2

Tạo sự kiện mới & Cấu hình chế độ in

Bấm nút "+ Tạo sự kiện mới" và điền các thông tin quan trọng:

  • Tên sự kiện: Tên hiển thị của tiệc cưới, hội nghị hoặc chiến dịch thương hiệu (VD: Tiệc Cưới Minh & Châu, Gala Secutech 2026).
  • Đường dẫn Slug (Định danh URL): Chuỗi ký tự duy nhất tạo nên link album cho khách (VD: secutech-2026 → URL album sẽ là photobooth.5pic.click/gallery/secutech-2026).
  • Chế độ in tự động (Auto-print): Bật nếu muốn ảnh vừa chụp xong lập tức xuất thẳng ra máy in. Tắt nếu muốn thợ ảnh duyệt trên điện thoại hoặc khách chọn ảnh mới in.
3

Lấy Token sự kiện & Thông số kết nối FTP máy ảnh

Trong trang chi tiết sự kiện, mở khối "🔌 Kết nối FTP cho máy ảnh":

  • Mã Token Sự kiện (Event Token): Nhấn vào ô mã Token để copy. Dán mã này vào ứng dụng 5Pic Photo Print Hub trên máy Mac tại bàn in để máy in kết nối với sự kiện.
  • Thông số FTP: Sao chép Host (photobooth.5pic.click), Port (21), Username và Password riêng của sự kiện để cấu hình vào máy ảnh.
4

Cấu hình Khung ảnh (Frame) & Cân chỉnh vị trí (Calibration)

Vào tab "🖼️ Khung ảnh" trong chi tiết sự kiện:

  • Bật lồng khung: Gạt công tắc sang trạng thái Bật để hệ thống tự động ghép khung PNG lên ảnh gốc.
  • Upload file khung PNG: Tải file thiết kế chuẩn PNG trong suốt (transparent). Khổ chuẩn cho in ảnh 13x18cm tràn lề là 1800×1200 px (khung ngang) hoặc 1200×1800 px (khung dọc).
  • Cân chỉnh tọa độ (Calibration): Kéo thanh trượt để di chuyển ảnh (Offset X, Y), phóng to/thu nhỏ (Scale) hoặc xoay ảnh sao cho khuôn mặt vừa vặn hoàn hảo vào ô cửa sổ khung. Nhấn "Lưu cấu hình".
5

Tùy biến Thương hiệu (Branding)

Vào tab "🎨 Thương hiệu" để cá nhân hóa giao diện trang tải ảnh của khách:

  • Tải lên Logo thương hiệu của nhãn hàng hoặc biểu tượng cưới (PNG/JPG).
  • Chọn Màu sắc chủ đạo (Primary Color) và màu nền phù hợp với concept sự kiện.
  • Nhập lời chào và thông điệp cảm ơn gửi tới khách mời khi quét mã nhận ảnh.
6

Hàng đợi ảnh Live Queue & Điều khiển in trực tiếp

Vào tab "📸 Hàng đợi ảnh (Live Queue)":

  • Thời gian thực 100%: Ảnh chụp từ máy ảnh nhảy tức thì vào lưới ảnh kèm nhãn trạng thái (Đã in / Chờ in).
  • Giám sát máy in: Quan sát thẻ Trạng thái máy in. Khi app macOS kết nối, thẻ báo 🟢 Trực tuyến.
  • Lệnh in linh hoạt: Nhấp vào bất kỳ ảnh nào để mở hộp thoại xem trước (Lightbox) và chọn in 1 bản, 2 bản, 4 bản, 10 bản ra máy in tại bàn. Bạn cũng có thể bấm "Xóa ảnh" nếu ảnh bị nháy mắt hoặc chụp lỗi.
7

Bộ 4 Kênh Tương Tác Sự Kiện (Action Links)

Ở góc trên bên phải trang sự kiện luôn có sẵn 4 liên kết điều hành đắc lực:

📱 Remote Thợ Chụp

Mở link trên điện thoại của Photographer để duyệt ảnh và bấm in tức thì tại hiện trường.

🖨️ Kênh In Photographer

Trạm in chuyên nghiệp tối ưu cho màn hình laptop chọn ảnh in số lượng lớn.

📺 Màn hình iPad / Kiosk

Trình chiếu slideshow ảnh live và mã QR cỡ lớn tại photobooth cho khách quét.

🔗 Album Khách Hàng

Trang gallery công khai cho khách xem toàn bộ album, tải ảnh gốc & tìm ảnh bằng AI Selfie.

8

Sao lưu đám mây (Google Drive Cloud Backup)

Vào tab "☁️ Google Drive": Đăng nhập liên kết tài khoản Google Drive để hệ thống tự động tải toàn bộ ảnh chụp đã lồng khung vào thư mục Drive của bạn sau khi kết thúc sự kiện, đảm bảo dữ liệu luôn được bàn giao nhanh chóng cho khách hàng.


Quy trình vận hành sự kiện
Quy trình hoàn chỉnh từ khi khách chụp đến khi nhận ảnh
1

Tạo sự kiện trên Admin Portal

Truy cập photobooth.5pic.click/portal.html → Đăng nhập → Nhấn "+ Tạo Sự kiện mới". Điền đầy đủ tên sự kiện, ngày diễn ra, upload khung ảnh (frame PNG).

2

Lấy thông tin FTP → cấu hình máy ảnh

Sau khi tạo sự kiện, vào tab FTP trong chi tiết sự kiện để lấy Username/Password FTP. Cấu hình vào máy ảnh theo hướng dẫn ở Section 2 ở trên.

3

Mở app Mac → Đồng bộ ảnh

Trên máy Mac điều hành: mở 5Pic Photobooth App → Chọn sự kiện → Chọn thư mục lưu ảnh local → Nhấn "Bắt đầu đồng bộ". App sẽ tự động tải ảnh về và lồng khung.

4

Khách quét QR nhận ảnh

Sau khi ảnh được lồng khung, màn hình hiển thị sẽ tự động xuất hiện mã QR. Khách quét QR bằng điện thoại để xem và tải ảnh souvenir ngay lập tức.

5

Xem album sự kiện (Gallery)

Tất cả ảnh của sự kiện được lưu tại:

URL
photobooth.5pic.click/gallery/[slug-sự-kiện]

Lưu ý vận hành
Các điểm cần chú ý để hệ thống hoạt động ổn định
⚡

WiFi sự kiện cần có internet ra ngoài

Máy ảnh cần truyền ảnh đến server cloud (photobooth.5pic.click). Đảm bảo WiFi tại sự kiện không bị block port 21, 40000-50000 (FTP passive range).

🖼️

Khung ảnh (Frame) phải đúng định dạng

File khung ảnh upload lên Admin Portal phải là PNG có nền trong suốt (transparent), kích thước khuyến nghị 3000×4000 px (portrait) hoặc 4000×3000 px (landscape).

💾

Ảnh lưu trên S3 — không mất dữ liệu

Toàn bộ ảnh gốc và ảnh lồng khung được lưu trữ trên Amazon S3. Dữ liệu không bị xóa khi deploy lại hệ thống.

📞

Hỗ trợ kỹ thuật

Liên hệ team kỹ thuật 5Pic qua email [email protected] hoặc qua kênh nội bộ. Server uptime monitoring 24/7.