tshabebe/Ethiopian-ID-Card-Generator
Domain:
digital infrastructureRecord type:
software
Creator:
tsh
Host:
# Ethiopian ID Card Generator
Generate Ethiopian ID cards from PDF documents with automatic data extraction and QR code generation.
## Features
- 📄 Extract data from Ethiopian ID PDFs
- 🖼️ Generate front and back ID cards
- 🔍 QR code generation and decoding
- 📊 Tkinter GUI with table view
- 🌐 Web interface for file upload
- 📥 Batch PDF download
- ✅ Real-time toast notifications
- 🎯 **Enhanced address & FAN extraction** (80%+ accuracy)
- 🔧 **Smart OCR preprocessing** for different phone cameras
- 📸 **Debug visualization tools** for troubleshooting
## Recent Improvements
### Address & FAN Extraction (v2.0)
We've significantly improved the accuracy of address and FAN number extraction:
- **Address accuracy**: Improved from ~57% to **80-85%**
- **FAN accuracy**: Improved to **80-90%**
- **Better OCR**: Multiple preprocessing methods for different image qualities
- **Smart region detection**: Adapts to low-res and high-res images
- **Debug tools**: Visualize extraction regions and OCR quality
📖 **See EXTRACTION_IMPROVEMENTS_README.md for details**
### Testing Your Data
```bash
# Test single ID card
python test_extraction.py front.jpg back.jpg
# Test batch (all your cards)
python test_extraction.py --batch ./my_cards/
# Visualize extraction regions
python visualize_regions.py back.jpg
```
## Requirements
- Python 3.8+
- Tkinter (for GUI)
- Required fonts: Noto Sans, Noto Sans Ethiopic
## Installation
1. **Clone the repository**
```bash
git clone
cd fyida_id
```
2. **Install system dependencies**
```bash
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install python3-tk tesseract-ocr
# macOS
brew install python-tk tesseract
```
3. **Install Python dependencies**
```bash
pip install -r requirements.txt
```
4. **Install fonts** (if not already installed)
```bash
# Ubuntu/Debian
sudo apt-get install fonts-noto fonts-noto-extra
# macOS
brew tap homebrew/cask-fonts
brew install font-noto-sans font-noto-sans-ethiopic
```
## Usage
### Start the Application
` …