🔲 QR Code Maker Documentation

📖 Introduction

Welcome to QR Code Maker - a professional, user-friendly desktop application for creating various types of QR codes. Built with Python and Tkinter, this application provides an intuitive interface for generating QR codes for different purposes.

QR Code Maker is designed to be simple yet powerful, allowing you to create QR codes for plain text, phone numbers, WhatsApp, web links, and UPI payments - all in one integrated application with no need for multiple windows or external tools.

💾 Installation

Option 1: Download Executable (Recommended for Windows Users)

The easiest way to get started is to download the pre-built executable file:

Option 2: Run from Source Code

If you want to run from source or customize the application:

1. Clone the Repository

2. Install Dependencies

3. Run the Application

Option 3: Build Your Own Executable

To create your own executable file:

The executable will be created in the dist folder.

💻 System Requirements

✨ Key Features

📱 QR Code Types

1. 📄 Plain Text / Numbers

Create QR codes containing any text or numbers. Perfect for:

• Contact information
• Serial numbers
• Product codes
• Messages or notes
• Any custom text content

2. 📱 Mobile Number

Generate QR codes that automatically dial a phone number when scanned. Features:

• Country code support (default: +91 for India)
• Automatic tel: URL formatting
• One-tap calling from smartphones

3. 💬 WhatsApp

Create QR codes that open WhatsApp chats. Includes:

• Country code + phone number
• Optional pre-filled message
• Direct link to WhatsApp chat
• Works on both mobile and WhatsApp Web

4. 🔗 Web Link

Generate QR codes for any website or URL:

• Full URL support (http/https)
• Social media profiles
• Online forms
• Download links

5. 💰 UPI Payment

Create UPI payment QR codes for Indian digital payments:

• UPI ID (required)
• Payee name (required)
• Amount (optional)
• Transaction note (optional)
• Compatible with all UPI apps (GPay, PhonePe, Paytm, etc.)

🖥️ User Interface Guide

Application Layout

The application features a clean two-panel design:

Left Panel - Input Area

• QR Code Type Selection: Radio buttons to choose the type of QR code
• Input Fields: Dynamic fields that change based on selected type
• Generate Button: Large blue button to create the QR code

Right Panel - Preview & Actions

• QR Code Display: Live preview of your generated QR code (350x350px)
• Action Buttons:
  • 💾 Save - Save QR code as image file
  • 📋 Copy - Copy to clipboard
  • 🗑️ Clear - Reset and start new

Menu Bar

Traditional Windows-style menu with four sections:

File Menu

• New QR Code - Clear everything and start fresh
• Open Image - Load existing QR code image
• Save QR Code - Quick save
• Save As - Save with custom name/location
• Exit - Close the application

Edit Menu

• Clear All - Reset all inputs
• Copy QR Code - Copy to clipboard
• Preferences - App settings (coming soon)

Generate Menu

• Generate QR Code - Create QR code
• Regenerate - Recreate with current settings

Help Menu

• How to Use - Quick help guide
• About - App information

📚 Basic Usage Guide

Creating Your First QR Code

1. Launch the Application

   Double-click the QR Code Maker executable or run the Python script.

2. Select QR Code Type

   Click one of the radio buttons in the "QR Code Type" section to choose what type of QR code you want to create.

3. Fill in the Details

   The input fields will automatically update based on your selection. Enter the required information.

4. Generate the QR Code

   Click the "🔲 Generate QR Code" button or press Ctrl+G.

5. Preview and Save

   Your QR code will appear in the right panel. You can now save it or copy it.

Example: Creating a WhatsApp QR Code

Example: Creating a UPI Payment QR Code

📋 Menu Options Explained

Saving QR Codes

Save vs Save As:

• Save (Ctrl+S): Opens file dialog to choose location and format
• Save As (Ctrl+Shift+S): Same as Save, allows custom naming
• Supported formats: PNG (recommended) and JPEG

Opening Existing Images

Use File → Open Image to load existing QR code images into the preview panel. This is useful for:

• Viewing previously created QR codes
• Comparing different QR codes
• Reference or verification

Copying to Clipboard

The Copy function allows you to paste the QR code directly into other applications like Word, PowerPoint, or image editors.

⌨️ Keyboard Shortcuts

🔧 Troubleshooting

Common Issues and Solutions

Q: Application won't start / Shows error on launch

Solution:

• Ensure you're running Windows 10 or higher
• Try running as Administrator (right-click → Run as administrator)
• Check if antivirus is blocking the application
• If running from source, verify all dependencies are installed

Q: "Input Required" error when generating QR code

Solution:

• Make sure all required fields are filled
• For UPI: UPI ID and Payee Name are mandatory
• For WhatsApp/Phone: Number field cannot be empty
• For Link: URL must not be just "https://"

Q: Generated QR code doesn't scan properly

Solution:

• Ensure the data entered is correct and properly formatted
• Check that special characters are entered correctly
• For UPI: Verify UPI ID format (name@bank)
• Try generating the QR code again
• Ensure good contrast when printing (black on white works best)

Q: Copy to clipboard doesn't work

Solution:

• Install pywin32: pip install pywin32
• Close other clipboard managers if running
• Use the Save function as an alternative

Q: Can't save QR code / Permission denied error

Solution:

• Choose a different save location (like Desktop or Documents)
• Check folder permissions
• Run application as Administrator if needed

Q: QR code appears blurry or pixelated

Solution:

• The saved QR code is high resolution even if preview looks small
• Save as PNG for best quality (not JPEG)
• The QR code is vector-based and scales well when printed

💻 Source Code & Development

Technology Stack

Project Structure

              qr_code_maker/
            ├── .git/
            ├── .github/
            ├── .gitignore
            ├── README.md
            ├── LICENSE
            ├── CONTRIBUTING.md
            ├── CHANGELOG.md
            ├── documentation/
            │ ├── index.css
            │ |── README.md
            | ├── index.html
            | |── support.html
            | |── support.css 
            | └── logo.png 
            ├── gui_app/
            │ └── qrcode maker.py
            ├── cui_app/
            │ └── main.py
            ├── dist/
            ├── build/
            ├── icon.ico
            ├── logo.png
            
            ├── main.py
            ├── main.spec
            ├── QrcodeMaker.spec
            └── __pycache__/
            

Clone the Repository

Get the latest source code from GitHub:

Or using GitHub CLI:

Contributing

This is an open-source project! Contributions are welcome. Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Improve documentation

Building from Source

To build your own executable:

            # 1. Install dependencies
            pip install -r requirements.txt

            # 2. Build executable
            pyinstaller --onefile --windowed --icon=icon.ico qrcode_maker.py

            # 3. Find your executable in the dist/ folder
            

💡 Tips & Best Practices

For Best QR Code Quality

• Always save as PNG format for best quality
• Keep data concise - shorter URLs are better
• Test your QR codes before mass printing
• Ensure good contrast when printing (black on white background)
• Don't resize saved QR codes too much - regenerate if needed

For UPI Payments

• Double-check UPI ID before generating
• Test the QR code with your own UPI app first
• For fixed amounts, specify the amount in the QR code
• Add descriptive notes to help identify payments

For WhatsApp QR Codes

• Remove spaces and hyphens from phone numbers
• Use country codes without the '+' symbol
• Keep pre-filled messages short and clear
• Test on both Android and iOS devices

Workflow Optimization

• Use keyboard shortcuts for faster generation
• Keep commonly used details in a text file for copy-paste
• Create a dedicated folder for your QR codes
• Name files descriptively (e.g., "business_whatsapp_qr.png")

❓ Frequently Asked Questions

Is my data safe?

Yes! All processing happens locally on your computer. No data is sent to any external server or cloud service. Your information stays private.

Do I need internet to use this app?

No! The application works completely offline. However, the generated QR codes (for WhatsApp, links, etc.) will need internet when scanned.

Can I create custom colored QR codes?

The current version generates standard black and white QR codes, which have the best scanning reliability. Custom colors may be added in future versions.

How many QR codes can I generate?

Unlimited! There's no restriction on the number of QR codes you can create.

Can I use this for commercial purposes?

Yes! The QR codes you generate can be used for any purpose, including commercial use. Check the project license for software usage terms.

Will this work on Mac or Linux?

The source code is cross-platform and should work on Mac and Linux with Python installed. However, the pre-built executable is Windows-only.

📜 Terms & Conditions

By using QR Code Maker, you agree to these terms. The application is provided as a tool to generate QR codes; users are solely responsible for the accuracy of any information entered (including UPI IDs, payee names, and amounts) and for verifying that generated QR codes function correctly with their intended payment apps or scanners.

The author and the application shall not be liable for any loss, damage, failed transactions, or other issues arising from incorrect data entry, scanning errors, third-party payment app failures, network problems, or misuse of generated QR codes. No warranty (express or implied) is made regarding the suitability, reliability, or compatibility of generated QR codes for any particular purpose.

Always test QR codes and perform a small trial transaction before accepting payments at scale. Use of this software is at your own risk; where applicable, liability is limited to the fullest extent permitted by law.