Amazing-QR

转到中文版

Overview

Python QR Code Generator

Generate common qr-code, artistic qr-code (black & white or colorized), animated qr-code (black & white or colorized).

Contents

• Amazing-QR
  • Overview
  • Contents
  • Examples
  • Install
    • CLI or Library
    • Agent Integration
  • Usage
    • CLI
    • Library
    • Agent
  • Tips
  • Supported Characters
  • Environment
  • License
  • Buy me a coffee ☕️

Examples

Install

CLI or Library

pip install amzqr

Agent Integration

To use amazing-qr inside an agent, you can either install the agent skill or connect the MCP server.

Agent Skill

x-hw/skills repository ships the generate-amazing-qr-code skill, which teaches AI agents to generate QR codes with the amzqr CLI. Install it into your agent with:

npx skills add x-hw/skills --skill generate-amazing-qr-code

MCP Server

For MCP-compatible agents, use x-hw/amzqr-mcp.

Usage

CLI

# summary
amzqr Words
      [-v {1,2,3,...,40}]
      [-l {L,M,Q,H}]
      [-n output-filename]
      [-d output-directory]
      [-p picture_file]
      [-c]
      [-con contrast]
      [-bri brightness]
      [-V]

• see Common QR-Code for Words, -v, -l, -n, -d
• see Artistic QR-Code for -p, -c, -con, -bri
• see Animated GIF QR-Code about GIF

Common QR-Code

#1 Words
amzqr https://github.com

• Just input a URL or a sentence, then get your QR-Code named 'qrcode.png' in the current directory.

#2 -v, -l
amzqr https://github.com -v 10 -l Q

• The default size of QR-Code depends both on the numbers of words you input and the level, while the default level (Error Correction Level) is H (the highest).

• Customize: If you want to control the size and the error-correction-level, use the -v and -l arguments.

  -v representing the length is from a minimum of 1 to a maximum of 40.

  -l representing the error correction level is one of L, M, Q and H, where L is the lowest level and H is the highest.

#3 -n, -d
amzqr https://github.com   -n github_qr.jpg   -d .../paths/

• The default output-filename is 'qrcode.png', while the default output-directory is current directory.

• Customize: You can name the output-file and decide the output-directory. Notice that if the name is as same as a existing file, the old one will be deleted.

  -n representing the output-filename could be in the format one of .jpg， .png ，.bmp ，.gif .

  -d means directory.

Artistic QR-Code

#1 -p
amzqr https://github.com -p github.jpg

• The -p is to combine the QR-Code with the following picture which is in the same directory as the program. The resulting picture is black and white by default.

#2 -c
amzqr https://github.com -p github.jpg -c

• The -c is to make the resulting picture colorized.