https://github.com/shadrach16/event-scanner-ocr

Mobile utility that uses AI to scan event flyers and automatically populate the phone's calendar.
https://github.com/shadrach16/event-scanner-ocr

capacitor ocr productivity-tool react-native

Last synced: about 1 month ago
JSON representation

Mobile utility that uses AI to scan event flyers and automatically populate the phone's calendar.

• Host: GitHub
• URL: https://github.com/shadrach16/event-scanner-ocr
• Owner: shadrach16
• Created: 2025-11-24T16:15:36.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2026-05-04T14:02:14.000Z (2 months ago)
• Last Synced: 2026-05-04T16:07:08.791Z (2 months ago)
• Topics: capacitor, ocr, productivity-tool, react-native
• Language: TypeScript
• Homepage: https://play.google.com/store/apps/details?id=com.waoapps.photo2calendar
• Size: 6.03 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 📅 Photo2Calendar: Event Flyer to Calendar AI

![Status](https://img.shields.io/badge/Status-Beta_Release-blue)

![Platform](https://img.shields.io/badge/Platform-Android_|_iOS_(Capacitor)-green)

![Tech](https://img.shields.io/badge/AI-OCR_Image_Processing-purple)

> **"Never manually type a date from a flyer again."**

> An AI-powered utility app that scans physical or digital event flyers, extracts the details (Date, Time, Venue), and automatically syncs them to your phone's native calendar.

---

## 📱 App Interface



  

  

  
Figure 1: The Image Scanning Process (Left) and the Auto-Populated Event Details (Right).



---

## 🚀 The Problem & Solution

**The Problem:** In Nigeria (and globally), event invitations often come as image flyers on WhatsApp or Instagram. Transferring these details to a Google/Apple Calendar requires switching apps and manually typing dates, times, and complex addresses.

**The Solution:** Photo2Calendar allows users to simply "Share" an image to the app. The AI analyzes the text and creates a calendar event instantly.

---

## ✨ Core Features

### 1. Context-Aware OCR (Nigerian Context)

Generic OCR tools often fail with stylized fonts on party flyers or specific Nigerian date formats (e.g., "20th of Nov", "No African Time").

* I fine-tuned the parsing logic to identify **venues** (Events Centers, Landmarks) vs. standard text.

* It intelligently handles colloquial time formats like "10am Prompt".

### 2. One-Tap Calendar Sync

* Uses the **Capacitor Calendar Plugin** to interface directly with the device's native calendar (Google Calendar on Android, iCal on iOS).

* Users can review and edit details before saving.

### 3. global Multi-Language Support

* The app features full localization support for **8 different languages**, making it accessible to a diverse user base.

* It is optimized to recognize keywords in both formal English and local dialects (e.g., Pidgin) common in event descriptions.

### 4. In-App Purchases (Monetization)

* Integrated **In-App Purchase (IAP)** functionality allows users to disable ads.

* Connects directly to Google Play Billing and Apple StoreKit for a seamless checkout experience.

---

## 🛠️ Technical Implementation

This project demonstrates the power of **Hybrid Mobile Development**:

* **Frontend Framework:** `React.js` (for the UI logic and state management).

* **Native Runtime:** `Capacitor` (wraps the web app into a native binary for Play Store/App Store).

* **AI/OCR Engine:** Integration with **Google Nano Vision API** for raw text extraction, followed by a Regex/NLP parsing layer to classify data into "Date," "Time," and "Location."

* **Storage:** `SQLite` (for local history of scanned events).

---

## 👨‍💻 Developer Role

**Tunde Oluwamo**

*Full Stack & Mobile Developer*

[LinkedIn Profile](https://linkedin.com/in/oluwamo-shadrach-740242185)