qrencode
qrencode 는 문자열이나 표준입력을 QR Code 이미지 또는 터미널용 텍스트로 변환하는 CLI 도구다.
Summary
- PNG, SVG, EPS 같은 파일 출력과 ANSI/UTF8 기반 터미널 출력을 모두 지원한다.
- 기본 출력 형식은 PNG 이며, 인수가 없으면 표준입력에서 데이터를 읽는다.
- 짧은 텍스트 공유, Wi-Fi 접속 정보 전달, URL 배포, 터미널 즉시 확인 용도에 적합하다.
Installation
apt install qrencode dnf install qrencode brew install qrencode
Usage
qrencode [OPTION]... [STRING]
qrencode [OPTION]… [STRING]STRING: QR Code로 인코딩할 문자열. 생략하면 stdin 에서 읽는다.
Options
-o FILE,–output=FILE: 출력 파일 지정.-를 쓰면 stdout 으로 보낸다.-t TYPE,–type=TYPE: 출력 형식 지정.PNG,SVG,EPS,ANSIUTF8등을 사용할 수 있다.-s NUMBER,–size=NUMBER: 모듈 크기(pixel) 지정.-l {LMQH},–level={LMQH}: 오류 복원 수준 지정.L이 가장 낮고H가 가장 높다.-v NUMBER,–symversion=NUMBER: QR symbol version 지정. 기본값은 자동 선택이다.-m NUMBER,–margin=NUMBER: 여백 폭 지정.-d NUMBER,–dpi=NUMBER: PNG 출력 DPI 지정.-8,–8bit: 전체 데이터를 8-bit mode 로 인코딩한다.-k,–kanji: 입력이 Shift-JIS 기반 kanji 를 포함한다고 가정한다.-i,–ignorecase: 대소문자를 무시하고 upper-case 기반으로 처리한다.-M,–micro: Micro QR Code 생성 시도.–foreground=RRGGBB[AA]: 전경색 지정.–background=RRGGBB[AA]: 배경색 지정.–verbose: stderr 로 상세 정보를 출력한다.
Examples
qrencode "https://example.com" qrencode -o login.png "otpauth://totp/demo?secret=BASE32SECRET" qrencode -t SVG -o wifi.svg "WIFI:T:WPA;S:OfficeWiFi;P:REDACTED;;" qrencode -t ANSIUTF8 < text.txt printf '%s' 'hello from stdin' | qrencode -t UTF8
- 터미널에서 바로 확인하려면
-t ANSIUTF8또는-t UTF8이 편하다. - 파일로 남길 때는
PNG보다 diff 친화적인SVG가 관리하기 쉬운 경우가 많다. - Wi-Fi 문자열, OTP URI, 내부 URL 같은 민감한 값은 문서 예제에 실값을 넣지 않는 편이 안전하다.
Troubleshooting
- 셸이 특수문자를 해석하면 QR 내용이 바뀔 수 있으니 복잡한 문자열은 작은따옴표로 감싼다.
- 한글이나 바이너리성 문자열이 깨지면
–8bit또는 입력 인코딩을 먼저 점검한다. - 터미널 출력이 어긋나면 글꼴, 터미널 폭, 복사 과정 때문에 깨질 수 있으니
PNG또는SVG로 다시 생성해 본다. - 스캔 인식률이 낮으면
–level=H, 더 큰–size, 충분한–margin을 사용한다.
Compatibility
- 확인한 로컬 버전은
3.4.4이다. - 도움말 기준 지원 타입은
PNG,EPS,SVG,ANSI,ANSI256,ASCII,ASCIIi,UTF8,ANSIUTF8이다. –foreground와–background는 PNG 와 SVG 에서만 의미가 있다.–micro는 help 에서 experimental 로 표시된다.
Help
See Also
History
- codex:: 2026-06-20 Rebuilt qrencode page with actual options, terminal and file output examples, and help output.