file:///home/bughunter/Pictures/deadqr.png
**Advanced QR Code Generator**
A sleek, feature-rich Python GUI tool for creating and customizing QR codes with live preview
</div>
---
## 🎯 Features
- **Live Preview** - QR codes update in real-time as you type
- **Multiple Styles** - Choose from Square, Rounded, or Circle module styles
- **Color Customization** - Full control over foreground and background colors
- **Error Correction Levels** - Support for L (7%), M (15%), Q (25%), and H (30%) error correction
- **Size Control** - Adjustable QR code size with easy slider interface
- **PNG Export** - Save your QR codes as high-quality PNG images
- **Clean GUI** - Intuitive interface built with tkinter
- **Lightweight** - Minimal dependencies, runs on any system with Python
---
## 📸 Screenshot
```
┌─────────────────────────────────────────┐
│ DeadQR │
│ Advanced QR Code Generator │
├─────────────────────────────────────────┤
│ Content │
│ ┌─────────────────────────────────┐ │
│ │ Enter text or URL... │ │
│ └─────────────────────────────────┘ │
│ │
│ Settings │
│ Size: ━━━━━━━━⚪━━━━━ 10 │
│ Error Correction: M (15%) │
│ Style: Square │
│ Foreground: ⬛ Background: ⬜ │
│ │
│ Preview │
│ ┌─────────────────────────────────┐ │
│ │ ▄▄▄▄▄▄▄ ▄ ▄▄▄▄▄▄▄ │ │
│ │ █ █ ██ █ █ │ │
│ │ █ ███ █ ▄█▄ █ ███ █ │ │
│ │ ... QR CODE PREVIEW ... │ │
│ └─────────────────────────────────┘ │
│ │
│ [Generate] [Save as PNG] [Clear] │
└─────────────────────────────────────────┘
```
---
## 🚀 Quick Start
### Prerequisites
- Python 3.7 or higher
- pip package manager
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/yourusername/DeadQR.git
cd DeadQR
```
2. **Run the launcher**
```bash
./run_qr_generator.sh
```
The launcher script will automatically:
- Create a virtual environment
- Install all required dependencies
- Launch the application
**That's it!** The tool is ready to use.
---
## 🛠️ Manual Installation
If you prefer to set up manually:
```bash
# Create a virtual environment
python3 -m venv venv
# Activate it
source venv/bin/activate # Linux/macOS
# or
venv\Scripts\activate # Windows
# Install dependencies
pip install qrcode[pil] pillow
# Run the application
python qr_generator.py
```
---
## 📖 Usage
1. **Launch the application**
```bash
./run_qr_generator.sh
```
2. **Enter your content**
- Type or paste any text, URL, or data into the content field
- The QR code will generate automatically as you type
3. **Customize your QR code**
- Adjust the **Size** slider for larger or smaller codes
- Select **Error Correction** level (higher = more damage resistant)
- Choose a **Style**: Square, Rounded, or Circle
- Click color buttons to customize **Foreground** and **Background** colors
4. **Save your QR code**
- Click **"Save as PNG"**
- Choose your destination and filename
- Your QR code is ready to use!
---
## 🎨 Use Cases
- **URLs** - Share website links
- **WiFi Credentials** - Quick network sharing
- **Contact Information** - vCard data
- **Payment Information** - Crypto addresses, payment links
- **Social Media** - Profile links, handles
- **Events** - Calendar invites, tickets
- **Product Information** - Serial numbers, specifications
- **Authentication** - 2FA setup codes
---
## 🔧 Technical Details
### Dependencies
- **qrcode** - QR code generation library
- **Pillow** - Image processing
- **tkinter** - GUI framework (included with Python)
### Project Structure
```
DeadQR/
├── qr_generator.py # Main application
├── run_qr_generator.sh # Launcher script
└── README.md # Documentation
```
### Error Correction Levels
| Level | Error Correction Capacity | Use Case |
|-------|---------------------------|----------|
| L | 7% | Clean environments |
| M | 15% | General use (default) |
| Q | 25% | Outdoor/industrial |
| H | 30% | Maximum reliability |
---
## 🤝 Contributing
Contributions are welcome! Here's how you can help:
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
### Ideas for contributions:
- WiFi QR code templates
- vCard/contact information templates
- Batch QR code generation
- Additional module styles
- Logo/image embedding
- SVG export support
- Dark mode UI theme
---
## 📝 License
This project is licensed under the MIT License - see below for details:
```
MIT License
Copyright (c) 2025 DeadQR
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
---
## 🐛 Bug Reports & Feature Requests
Found a bug or have an idea? Please open an issue on GitHub:
[Create an Issue](https://github.com/sinX/DeadQR/issues/new)
---
## ⭐ Show Your Support
If you find DeadQR useful, please consider:
- Starring the repository ⭐
- Sharing it with others
- Contributing to the project
---
## 📞 Contact
**Project Link:** [https://github.com/sinX/DeadQR](https://github.com/sinX/DeadQR)
---
<div align="center">
Made with ❤️ by the DeadQR Team
**Happy QR Coding!** 📱
</div>
sinX
eed9a7671e
