How chitraarasu/ocr-tamil works
OCR-Tamil is an Android app for recognizing Tamil text in images and PDFs using Tesseract 4. Users select or capture an image, or choose a PDF; the app processes it and presents recognized text and accuracy, with PDF results browsable page by page. Recent image scans can be reopened or deleted. A startup stage verifies and prepares OCR data; settings and contributor information are separate supporting features. The graph follows shown calls and SOURCE INDEX references; unsampled implementation details and some network wiring remain uncertain.
Main entry points: ResultActivity.kt OCR result screen · MainActivity.kt Capture and file selection · RecentScanDao.kt Recent scan queries · LauncherActivity.kt Startup screen
Components 20
App entry and selection
- Startup screen
app/src/main/java/com/jskaleel/vizhi_tamil/ui/splash/LauncherActivity.kt - Capture and file selection
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainActivity.kt
OCR and results
- OCR result screen
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultActivity.kt - PDF conversion
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultViewModel.kt - PDF page display
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultPageAdapter.kt - Page text view
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultPageFragment.kt - Tesseract scanner
app/src/main/java/com/jskaleel/vizhi_tamil/utils/TessScanner.kt - App file paths
app/src/main/java/com/jskaleel/vizhi_tamil/utils/FileUtils.kt
Recent scan storage
- History actions
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainViewModel.kt - Recent scan list
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/RecentScanAdapter.kt - Scan record
app/src/main/java/com/jskaleel/vizhi_tamil/db/entity/RecentScan.kt - Recent scan queries
app/src/main/java/com/jskaleel/vizhi_tamil/db/dao/RecentScanDao.kt - Room database
app/src/main/java/com/jskaleel/vizhi_tamil/db/VizhiDatabase.kt
Setup and community
- OCR data setup
app/src/main/java/com/jskaleel/vizhi_tamil/ui/splash/LauncherViewModel.kt - Settings
app/src/main/java/com/jskaleel/vizhi_tamil/ui/SettingsActivity.kt - Contributor listing
app/src/main/java/com/jskaleel/vizhi_tamil/ui/contrib/ContributorsActivity.kt - Contributor loading
app/src/main/java/com/jskaleel/vizhi_tamil/ui/contrib/ContributorsViewModel.kt
Other components
- App user
- Tesseract data host
- GitHub contributors API
Connections 24
- App user → Startup screen: opens app
app/src/main/java/com/jskaleel/vizhi_tamil/ui/splash/LauncherActivity.kt - Startup screen → OCR data setup: checks readiness
app/src/main/java/com/jskaleel/vizhi_tamil/ui/splash/LauncherActivity.kt - OCR data setup → Tesseract data host: fetches OCR data
- Startup screen → Capture and file selection: opens ready app
app/src/main/java/com/jskaleel/vizhi_tamil/ui/splash/LauncherActivity.kt - App user → Capture and file selection: selects input
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainActivity.kt - Capture and file selection → OCR result screen: opens scan result
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainActivity.kt - Capture and file selection → History actions: loads and deletes
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainActivity.kt - Capture and file selection → Recent scan list: displays scans
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainActivity.kt - Recent scan list → Capture and file selection: dispatches item actions
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/RecentScanAdapter.kt - History actions → Recent scan queries: queries and deletes
app/src/main/java/com/jskaleel/vizhi_tamil/ui/main/MainViewModel.kt - Recent scan queries → Scan record: reads and writes
app/src/main/java/com/jskaleel/vizhi_tamil/db/dao/RecentScanDao.kt - Room database → Recent scan queries: provides access
app/src/main/java/com/jskaleel/vizhi_tamil/db/VizhiDatabase.kt - OCR result screen → Tesseract scanner: recognizes image text
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultActivity.kt - OCR result screen → App file paths: gets OCR data path
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultActivity.kt - OCR result screen → PDF conversion: starts PDF conversion
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultActivity.kt - PDF conversion → Tesseract scanner: uses OCR engine
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultViewModel.kt - PDF conversion → App file paths: uses file paths
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultViewModel.kt - OCR result screen → PDF page display: shows PDF pages
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultActivity.kt - PDF page display → Page text view: creates page views
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultPageAdapter.kt - Page text view → Tesseract scanner: uses OCR engine
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultPageFragment.kt - OCR result screen → Recent scan queries: inserts new scans
app/src/main/java/com/jskaleel/vizhi_tamil/ui/result/ResultActivity.kt - Settings → Contributor listing: opens contributors
app/src/main/java/com/jskaleel/vizhi_tamil/ui/SettingsActivity.kt - Contributor listing → Contributor loading: loads contributor data
app/src/main/java/com/jskaleel/vizhi_tamil/ui/contrib/ContributorsActivity.kt - Contributor loading → GitHub contributors API: requests contributors