Merge pull request #31 from DhanashreePetare/qrcode-branch

Add QR Code Scanner script in Python (#4)

Author: devmalik7

.gitignore

@@ -0,0 +1,5 @@
+# Ignore Python virtual environments
+Python/venv/
+
+# Ignore __pycache__ folders
+**/__pycache__/

Python/INDEX.md

@@ -18,6 +18,19 @@ This directory contains Python scripts contributed to the Code_Script repository
 
 ---
 
+### 2. QR Code Scanner
+**Path:** `Python/qr_code_scanner/`  
+**Description:** Simple script that scans and decodes QR codes from image files.  
+**Features:**
+- Detects and decodes one or multiple QR codes in an image  
+- Displays decoded text or URL directly in the terminal  
+- Uses `opencv-python`, `pyzbar`, and `Pillow`  
+- Beginner-friendly and easy to extend  
+
+**Usage:** See [qr_code_scanner/README.md](qr_code_scanner/README.md)
+
+---
+
 ## 🚀 How to Use
 
 Each script has its own directory with:
@@ -43,4 +56,4 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
 
 ---
 
-**Last Updated:** October 5, 2025
+**Last Updated:** October 7, 2025

Python/QRcode_Scanner/README.md

@@ -0,0 +1,39 @@
+# 🧾 QR Code Scanner
+
+A beginner-friendly Python script that scans and decodes QR codes from an image.
+
+---
+
+## 📋 Features
+- Reads QR codes from image files (PNG, JPG, etc.)
+- Prints the decoded text or URL to the terminal
+- Uses simple, widely available libraries (`opencv-python`, `pyzbar`, `Pillow`)
+
+---
+
+## 🚀 Usage
+
+1️⃣ Install dependencies
+pip install -r requirements.txt
+
+2️⃣ Run the script
+python qr_scanner.py sample_images/test_qr.png
+If the image contains a valid QR code, you’ll see:
+✅ QR Code Detected: Hello Hacktoberfest 2025!
+
+
+📁 Folder structure
+qr_code_scanner/
+│
+├── qr_scanner.py          # main script
+├── README.md              # usage instructions
+├── requirements.txt       # dependencies
+└── sample_images/         # test images
+🧠 Notes
+Make sure your image path is correct while testing in CLI.
+Works with multiple QR codes in one image.
+Tested with Python 3.9+.
+
+🎯 Author
+Dhanashree Petare
+Contribution for Hacktoberfest 2025 under issue #4 (QR Code Scanner)

Python/QRcode_Scanner/qr_scanner.py

@@ -0,0 +1,58 @@
+"""
+QR Code Scanner 🧾
+-------------------
+A simple Python script to read and decode QR codes from an image file.
+
+Dependencies:
+    pip install opencv-python pyzbar Pillow
+
+Usage:
+    python qr_scanner.py <path_to_image>
+
+Example:
+    python qr_scanner.py sample_images/test_qr.png
+"""
+
+import sys
+import cv2
+from pyzbar.pyzbar import decode
+from PIL import Image
+
+
+def scan_qr_code(image_path):
+    """
+    Reads an image and decodes QR codes inside it.
+    Returns a list of decoded strings (text/URLs).
+    """
+    try:
+        # Read the image using OpenCV
+        img = cv2.imread(image_path)
+        if img is None:
+            print("⚠️ Could not read the image. Check the path.")
+            return []
+
+        # Decode any QR codes present in the image
+        qr_codes = decode(img)
+        if not qr_codes:
+            print("❌ No QR code found in the image.")
+            return []
+
+        decoded_texts = []
+        for qr in qr_codes:
+            data = qr.data.decode('utf-8')
+            decoded_texts.append(data)
+            print(f"✅ QR Code Detected: {data}")
+
+        return decoded_texts
+
+    except Exception as e:
+        print(f"🚫 Error: {e}")
+        return []
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python qr_scanner.py <path_to_image>")
+    else:
+        image_path = sys.argv[1]
+        scan_qr_code(image_path)

Python/QRcode_Scanner/requirements.txt

@@ -0,0 +1,3 @@
+opencv-python
+pyzbar
+Pillow