终端优先的二维码生成器，兼顾一条命令出图和可交互预览。
English · Design · Contributing
tqrx 是一个小而直接的 Go 工具：
CLI适合快速生成PNG/SVGTUI适合边改内容边看预览再保存- 预览和导出共用同一份二维码渲染结果，减少“界面看着对，导出不一致”的情况
TQRX live qr workbench [PNG/M] [AUTO] [Ready]
┌──────────────────────────────┐┌────────────────────────────────────────────┐
│ [ Edit ] ││ [ Preview ] │
│ Compose ││ PNG • M • 256px mods 37/64 │
│ │ https://example.com ││ Path ./qrcode.png │
│ │ ││ │
│ Settings ││ QR PREVIEW │
│ Format [PNG] [SVG] ││ │
│ Size > 256 │└────────────────────────────────────────────┘
│ Level [L] [M] [Q] [H] │ [Save QR]
│ Output > ./qrcode.png │
└──────────────────────────────┘
如果想先看一遍交互流程，可以直接看下面的演示视频：
demo.mp4
- 默认命令就能出图：
tqrx "https://example.com" - 保留交互工作台：
tqrx tui - 明确的输出规则：格式、后缀、尺寸、纠错等级都有统一校验
- 扫码导向的预览提示：
mods X/Y和suggest M for scan
当前最稳的方式是本地构建：
go build -o tqrx .首个 release 发布后，可走 Homebrew Cask：
brew install --cask crper/tap/tqrx# 默认导出 PNG
./tqrx "https://example.com"
# 从 stdin 读取
printf 'from-pipe\n' | ./tqrx
# 导出 SVG
./tqrx "hello svg" -f svg -s 256 -o hello.svg -l H
# 打开交互式工作台
./tqrx tui命令帮助：
./tqrx --help
./tqrx tui --help说明：
- 直接把位置参数当作待编码内容
tui是保留子命令名；要编码字面量tui时请用./tqrx -- tui- 如果还要传
-f/-o/-s/-l，请把这些 flag 放在--前面，例如./tqrx -f svg -o out.svg -- tui - 默认输出为
./qrcode.png
常用按键：
Tab/Shift+Tab切换焦点Ctrl+S保存Ctrl+T切换AUTO / LIGHT / DARKEnter在内容区输入换行，在Save上执行保存- 支持鼠标点击切焦点，也支持终端粘贴事件
预览规则：
- 预览固定使用高对比黑白画布
mods X/Y表示当前二维码模块尺寸与预览容量- 终端过小会提示
native preview exceeds viewport; enlarge terminal - 纠错等级过高导致预览过密时，会给出
suggest M for scan这类建议
环境变量：
TQRX_THEME=auto|light|darkgo test ./...
go vet ./...
go build ./...
bash scripts/check-docs.shTUI 开发可配合 air：
go install github.com/air-verse/air@latest
air- 推送
v*tag 会触发.github/workflows/release.yml - 产物由
.goreleaser.yml构建 - 当前目标平台为
darwin/linux/windows+amd64/arm64 - Homebrew Cask 目标仓库为
crper/homebrew-tap
MIT · Copyright (c) 2026 crper