QR Studio

A professional desktop application for QR code generation and scanning with real-time computer vision.

QR Studio is a privacy-focused, feature-rich desktop application that eliminates the need for unreliable web-based QR code tools. Built with Python 3.12 and PySide6 (Qt), it provides blazingly fast QR code generation, real-time camera scanning, and static image analysis—all running locally on your machine.

📥 Download & Installation

For end-users, we provide pre-compiled binaries that do not require Python to be installed.

Option 1: Installer (Recommended)

1. Download QRStudio_Setup_v1.0.exe from the Releases page.
2. Run the installer and follow the on-screen instructions.
3. Launch QR Studio from your Start Menu or Desktop shortcut.

Option 2: Portable Version

1. Download QR-Studio.exe from the Releases page.
2. Place the file anywhere on your computer (e.g., Desktop or a USB drive).
3. Double-click QR-Studio.exe to run it instantly.

✨ Features

🎨 QR Code Generator

• Professional Output: Generate vector SVG files for print-ready quality, plus PNG format
• Rich Content Types: Text, URLs, Wi-Fi credentials, vCard contacts, Email, Phone numbers, and SMS
• Asynchronous Processing: Non-blocking UI with worker threads ensures smooth operation even with large QR codes
• Full Customization: Adjustable error correction levels (L/M/Q/H), scale, border size, and colors
• Live Preview: Real-time preview updates as you type or adjust settings

📷 Real-Time Camera Scanner

• Computer Vision Powered: Uses OpenCV for robust QR code detection from any webcam
• Visual Feedback: Live bounding box overlay shows detected codes in real-time
• Multi-Camera Support: Automatic detection and switching between multiple cameras
• Smart Recovery: Automatic camera reconnection and diagnostic tools for troubleshooting
• Privacy First: All processing happens locally—no data leaves your machine

🖼️ Image File Scanner

• Batch Processing Ready: Decode QR codes from existing image files (PNG, JPG, JPEG, BMP)
• Visual Preview: See the source image alongside decoded content
• One-Click Copy: Instantly copy decoded content to clipboard

🚀 Roadmap & Premium Status

Note on Premium Status: Premium features are currently marked as "Coming soon". These features will be unlocked once third-party verification is completed, which is expected to be finalized before January 1, 2026.

Feature Release Schedule

January 1, 2026

• SVG Export: High-quality vector graphics for professional printing.
• New Content Types: Dedicated builders for Wi-Fi Networks and vCard Contacts.
• Enhanced Error Correction: Support for Q (Quartile) and H (High) levels to ensure readability even when partially damaged.

February 1, 2026

• Batch Generation: Import a CSV or Excel file (e.g., with 1000 rows of names and emails) and let the app automatically generate QR codes for all entries. The results are saved directly into a ZIP file, saving you hours of manual work.

March 1, 2026

• Custom Styling: Personalize your QR codes with custom colors and embed your own logo in the center of the code.

🤝 Contributing & Bug Bounty

Contributions are welcome! We value the community's help in making QR Studio the best tool possible.

Tester Rewards

To show our appreciation for those who help improve the software:

• Bug Hunters: Anyone who identifies and reports a valid bug or issue will be granted free lifetime Premium access to the application, including all future enhancements and updates.
• Feature Proposals: Users who suggest new features that are accepted and implemented into the core or premium roadmap will also receive a lifetime Premium version at no cost.

How to Contribute

1. Check existing Issues or open a new one.
2. Ensure all tests pass: poetry run pytest
3. Maintain coverage above 85%: poetry run pytest --cov=src
4. Format code: poetry run black src/ tests/
5. Pass linting: poetry run ruff check src/ tests/

See tests/README.md for testing best practices and mocking strategies.

🛠️ Technology Stack

Component	Technology	Purpose
Language	Python 3.12	Modern Python features, type hints, performance
GUI Framework	PySide6 (Qt 6.10)	Native cross-platform desktop UI
QR Generation	Segno 1.6	Pure Python, SVG support, Micro QR codes
Computer Vision	OpenCV 4.12	Real-time video processing and QR detection
Validation	phonenumbers 9.0	International phone number validation
HTML Parsing	BeautifulSoup4 4.14 + lxml 6.0	Report generation and injection
Build Tool	Poetry	Deterministic dependency management
Testing	pytest 9.0 + pytest-qt 4.5	Comprehensive test suite
Code Quality	Black 25.11 + Ruff 0.14	Formatting and linting
Pre-commit	pre-commit 4.5	Automated quality checks

📝 License

This project is licensed under the MIT License - see the LICENSE.md file for details.

🙏 Acknowledgments

• Segno - Pure Python QR code generator with excellent API
• OpenCV - Robust computer vision library
• Qt/PySide6 - Professional cross-platform UI framework
• pytest - Powerful testing framework

📧 Contact

Loke Aashamar - @laashamar

Project Link: https://github.com/laashamar/qr-studio

Made with ❤️ using Python and Qt