A powerful Python application that creates beautiful, customizable QR codes with logos, signatures, and various styling options. Now with a modern GUI!
- 🖥️ Modern GUI Interface: Beautiful, user-friendly interface powered by ttkbootstrap
- 6 Built-in Styles: Classic, Modern, Vibrant, Ocean, Sunset, and Namibia themes
- 🖼️ Logo Integration: Easy logo upload with file browser
- ✍️ Custom Signatures: Add text labels with enhanced visibility
- ✨ Visual Effects: Rounded corners, shadows, and styled borders
- 🌈 Gradient Support: Beautiful color gradients for modern looks
- 👁️ Live Preview: See your QR code before saving
- 💾 High Quality Output: Optimized PNG files
┌─────────────────────────────────────────┐
│ 🎨 Styled QR Code Generator │
├──────────────────┬──────────────────────┤
│ 📄 QR Code Data │ 👁️ Preview │
│ ✍️ Signature │ │
│ 🖼️ Logo │ [QR Code Preview] │
│ 🎭 Style │ │
│ ✨ Effects │ │
│ │ │
│ 🔄 Generate │ │
│ 💾 Save │ │
└──────────────────┴──────────────────────┘
# Clone the repository
git clone https://github.com/Blackjuiceplug/styled-qr-generator.git
cd styled-qr-generator
# Create virtual environment
python -m venv .venv
# Activate virtual environment
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate
# Install dependencies
pip install -r requirements.txtpython qr_generator_gui.py- Enter your data: Type or paste the URL/text you want to encode
- Add signature (optional): Add a label or text overlay
- Upload logo (optional): Click "Choose Logo" to add your logo
- Select style: Choose from 6 beautiful preset styles
- Enable effects: Toggle visual effects on/off
- Generate: Click "🔄 Generate QR Code" to create your QR code
- Preview: View your QR code in the preview panel
- Save: Click "💾 Save QR Code" to save your creation
python qr_generator.pyFollow the interactive prompts to create your QR code.
| Style | Description | Features |
|---|---|---|
| Classic | Traditional black & white | Timeless, professional |
| Modern | Contemporary dark theme | Sleek, minimal |
| Vibrant | Bold red accent | Eye-catching, energetic |
| Ocean | Blue gradient | Cool, calming |
| Sunset | Orange gradient | Warm, inviting |
| Namibia | Red-orange-blue gradient | Patriotic colors |
- Python 3.7 or higher
- qrcode[pil] 7.4.2
- Pillow 10.3.0
- ttkbootstrap 1.10.1
See requirements.txt for complete list.
- Supported formats: PNG, JPG, JPEG, GIF, BMP
- Recommended: PNG with transparent background
- Optimal size: 200x200px or larger (will be automatically resized)
- Error correction: High (30% damage tolerance)
- Box size: 12 pixels
- Border: 6 boxes
- Output format: PNG
- URLs: Always include
https://for web links - Logo: Use high-contrast logos for better scanning
- Signature: Keep text short (10-20 characters work best)
- Testing: Always test your QR code with a scanner before printing
- Printing: Save at full resolution for print quality
# Make sure all dependencies are installed
pip install -r requirements.txt --upgrade- Check file path is correct
- Ensure file format is supported (PNG, JPG, etc.)
- Verify file is not corrupted
- Reduce logo size (logo might be too large)
- Ensure good contrast between QR code and background
- Test under good lighting conditions
styled-qr-generator/
├── qr_generator_gui.py # GUI version
├── qr_generator.py # Command line version
├── requirements.txt # Python dependencies
├── README.md # This file
└── .venv/ # Virtual environment (created during setup)
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with qrcode
- UI powered by ttkbootstrap
- Image processing by Pillow
Project Link: https://github.com/Blackjuiceplug/styled-qr-generator
Made with ❤️ in Namibia 🇳🇦