https://github.com/emre-guler/code-reader

This project was generated with the assistance of AI (Cursor) to create a code reader application for processing student identification codes using OCR technology.
https://github.com/emre-guler/code-reader

ai-generated ocr-recognition python

Last synced: 1 day ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/emre-guler/code-reader
• Owner: emre-guler
• License: apache-2.0
• Created: 2024-10-11T11:43:40.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2024-12-31T20:32:14.000Z (15 days ago)
• Last Synced: 2025-01-09T09:19:27.718Z (7 days ago)
• Topics: ai-generated, ocr-recognition, python
• Language: Python
• Homepage:
• Size: 9.77 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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:

```bash

pip install opencv-python pytesseract pandas openpyxl

```

2. Install Tesseract OCR engine:

   - For macOS: `brew install tesseract`

   - For Windows: Download and install from [GitHub Tesseract Release](https://github.com/UB-Mannheim/tesseract/wiki)

   - 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:

```bash

python app.py

```

3. Point your camera at the codes you want to scan

4. Press 'q' to quit the application

5. 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.