QR Watermark Generator

A powerful command-line tool and Node.js library for generating watermarked QR codes with customizable positioning, transparency, and sizing options.

Features

• Generate QR codes from any text or URL
• Add watermarks to your QR codes
• Customize watermark position, transparency, and size
• Use from command line or programmatically
• No external dependencies (pure Node.js)
• Supports multiple image formats (PNG, JPEG, BMP, TIFF, GIF)

Installation

npm install -g qr-watermark-generator

Quick Start

Generate a simple QR code:

qr-watermarker "https://example.com"

Generate a QR code with a watermark:

qr-watermarker "https://example.com" -w ./logo.png

CLI Usage

Basic Syntax

qr-watermarker <data> [options]

Examples

# Simple QR code
qr-watermarker "Hello World"

# QR code with watermark
qr-watermarker "https://example.com" -w ./logo.png

# Customized QR code
qr-watermarker "https://example.com" \\
  -w ./logo.png \\
  -p bottom-right \\
  -t 200 \\
  -s 25 \\
  -q 1024 \\
  -o my-custom-qr.png

Programmatic Usage

const { generateWatermarkedQR } = require('qr-watermark-generator');

const buffer = await generateWatermarkedQR({
  data: 'https://example.com',
  watermarkPath: './logo.png',
  position: 'center',
  transparency: 128,
  scale: 25,
  qrSize: 512
});

// Save to file
require('fs').writeFileSync('output.png', buffer);

Options

| Option | Shorthand | Default | Description | |--------|-----------|---------|-------------| | <data> | - | Required | Data to encode in QR code | | --watermark <path> | -w | None | Path to watermark image | | --position <position> | -p | center | Watermark position | | --transparency <number> | -t | 128 | Watermark transparency (0-255) | | --scale <number> | -s | 25 | Watermark size % (5-30) | | --output <path> | -o | ./watermarked_qr.png | Output file path | | --qr-size <number> | -q | 512 | QR code size in pixels |

License

MIT