Chrome 확장 사이드패널에서 ArUco 마커를 생성·내보내기·검증. Chrome side panel extension to generate, export, and verify ArUco markers.
OpenCV ArUco 사전 기반으로 인쇄 정확도가 보장된 단일 마커와 마커 그리드를 만들고, 모니터 / 인쇄용 SVG · PNG · PDF · 인쇄 페이지로 출력하는 Chrome MV3 확장입니다. 확장 아이콘을 클릭하면 우측 사이드패널이 슬라이딩으로 열립니다.
- 17개 OpenCV ArUco 사전 (DICT_4X4_50 ~ DICT_ARUCO_ORIGINAL)
- 단일 마커 / 마커 그리드 생성
- mm 단위 정확 출력: SVG · PNG (2048px) · PDF (자체 빌드) · 인쇄 페이지 — 인쇄물 옆에 50mm 자(scale ruler) 자동 포함
- A4 미리보기: 다중 페이지 자동 페이징, 세로/가로, 정렬 토글
- 모니터 보정: 카드 / 여권 / A4 기준으로 화면 px/mm 측정 → 실측 미리보기
- 검증: 이미지 업로드 / 카메라 캡처로 마커 인식 테스트
- 다크 모드 (시스템 / 라이트 / 다크)
- 한/영 다국어, 설정 백업/복원 (JSON)
- 키보드 단축키: ← → (ID ±1), Ctrl+↑↓ (±10), Ctrl+P (인쇄), Ctrl+S (다운로드)
- Chrome 에서
chrome://extensions열기 - 우측 상단 개발자 모드 ON
- 압축해제된 확장 프로그램을 로드 → 이 폴더 선택
- 브라우저 우측 상단 확장 아이콘 클릭 → 사이드패널 열림
- 프리뷰 탭: 단일 마커 미리보기 + 라벨 옵션. 마커 좌/우 클릭 또는 ← / → 키로 ID 변경.
- 다운로드 탭: ID 목록 / 범위 입력 후 A4 미리보기 확인 → SVG · PNG · PDF 다운 또는 인쇄.
- ⚙ 더보기: 검증 / 보정 / 설정.
- 보정: 처음 사용 시 한 번 — 신용카드/여권/A4 를 화면 빨간 박스에 올려 슬라이더로 맞춘 뒤 저장.
OpenCV ArUco 사전 데이터는 THIRD_PARTY_ARUCOGEN_LICENSE.txt / THIRD_PARTY_OPENCV_LICENSE.txt 참조.
A Chrome MV3 extension that generates printable ArUco markers based on OpenCV's ArUco dictionaries, with accurate mm sizing. Click the toolbar icon to open the side panel on the right.
- 17 OpenCV ArUco dictionaries (DICT_4X4_50 through DICT_ARUCO_ORIGINAL)
- Generate single markers or marker grids
- Accurate mm output: SVG / PNG (2048px) / PDF (self-built) / print page — each sheet includes a 50 mm scale ruler
- A4 preview with auto paging, portrait/landscape, alignment toggles
- Screen calibration: measure px/mm using a credit card, passport, or A4 sheet for true-size preview
- Verification: upload an image or capture from camera to test marker detection
- Dark mode (system / light / dark)
- i18n (ko/en), settings backup/restore (JSON)
- Keyboard shortcuts: ← → (ID ±1), Ctrl+↑↓ (±10), Ctrl+P (print), Ctrl+S (download)
- Open
chrome://extensionsin Chrome - Enable Developer mode (top right)
- Click Load unpacked and select this folder
- Click the extension icon → the side panel opens on the right
- Preview tab: single marker preview + label options. Click left/right of the marker, or use ← / → keys to change ID.
- Download tab: enter the ID list / range, review the A4 preview, then download SVG / PNG / PDF or open the print page.
- ⚙ More: Verify / Calibrate / Settings.
- Calibrate once on first use — place a credit card / passport / A4 sheet over the red box on screen, drag the slider to match, then Save.
OpenCV ArUco dictionary data — see THIRD_PARTY_ARUCOGEN_LICENSE.txt and THIRD_PARTY_OPENCV_LICENSE.txt.
Pure ES Modules, no build step. Tests via vitest.
npm install
npm test # 25 tests across 3 files
npm run test:watch
npm run pack # → dist/aruco-generator-{version}.zip for Chrome Web StorePipeline (autonomous loop) — see pipeline/LOOP_PROMPT.md and CLAUDE.md.
See CHANGELOG.md.