Skip to content

README.md

Latest commit

 

History

History
55 lines (40 loc) · 1.68 KB

README.md

File metadata and controls

55 lines (40 loc) · 1.68 KB

Code Reader

A Python application that uses computer vision and OCR (Optical Character Recognition) to read and process specific code patterns from a camera feed. The application matches these codes with student names and exports the results to an Excel file.

Note: This project was generated with the assistance of AI (Cursor) to create a code reader application for processing student identification codes using OCR technology.

Features

  • Real-time camera feed processing
  • OCR text recognition using Tesseract
  • Pattern matching using regex (format: S-###-###-####)
  • Automatic student name and code matching
  • Excel export functionality

Requirements

  • Python 3.x
  • OpenCV (cv2)
  • Pytesseract
  • Pandas
  • Tesseract OCR engine

Installation

  1. Install the required Python packages:
pip install opencv-python pytesseract pandas openpyxl
  1. Install Tesseract OCR engine:
    • For macOS: brew install tesseract
    • For Windows: Download and install from GitHub Tesseract Release
    • For Linux: sudo apt-get install tesseract-ocr

Usage

  1. Create a students.txt file with student names (one name per line)
  2. Run the application:
python app.py
  1. Point your camera at the codes you want to scan
  2. Press 'q' to quit the application
  3. Check the generated student_codes.xlsx file for results

File Structure

  • app.py: Main application code
  • students.txt: Input file containing student names
  • student_codes.xlsx: Output Excel file with matched names and codes
  • recognized_text.txt: Log file of recognized codes

License

This project is licensed under the terms specified in the LICENSE file.