https://github.com/anonfaded/fadocx
All-in-one offline document viewer for Android with OCR and desktop-class rendering — private, open-source, zero tracking
https://github.com/anonfaded/fadocx
android document-management document-viewer image-to-text libreoffice ocr-android ocr-engine ondevice-ai
Last synced: 2 days ago
JSON representation
All-in-one offline document viewer for Android with OCR and desktop-class rendering — private, open-source, zero tracking
- Host: GitHub
- URL: https://github.com/anonfaded/fadocx
- Owner: anonfaded
- License: gpl-3.0
- Created: 2026-04-29T06:59:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-13T22:19:19.000Z (21 days ago)
- Last Synced: 2026-05-13T23:34:01.117Z (21 days ago)
- Topics: android, document-management, document-viewer, image-to-text, libreoffice, ocr-android, ocr-engine, ondevice-ai
- Language: Dart
- Homepage: https://fadseclab.com
- Size: 52.2 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# `>_` Fadocx
**All-in-one document viewer: PDF, Office, spreadsheets, presentations, code files & OCR text extraction — fully offline, zero tracking, open-source.**
[](https://github.com/anonfaded/Fadocx/releases/)
[](https://www.patreon.com/cw/Fadedx/shop)
[](https://discord.gg/kvAZvdkuuN)
> [!Tip]
> This project is part of the [FadSec Lab suite](https://github.com/fadsec-lab).
Discover our focus on ad-free, privacy-first applications and stay updated on future releases!
| ⭐ | 
| *More from FadSec Lab:*
🔒 [FadCrypt](https://github.com/anonfaded/FadCrypt) — file/folder encryption
🎥 [FadCam](https://github.com/anonfaded/FadCam) — background video recorder |
|----|-------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## The Problem
In today's world, **privacy is becoming a myth**. Every document app on the Play Store comes bundled with hundreds of trackers. Before you can even view a file, you're hit with intrusive ads — breaking focus, wasting your time, and eroding your experience.
Most document solutions rely on cloud-based infrastructure, introducing unnecessary data exposure risks. Your reading habits are tracked. Your device becomes a surveillance point.
## The Solution: Fadocx
**Zero trackers. Zero ads. Zero compromise.**
Fadocx does one thing exceptionally: **view your documents privately, on your device, the way software should work.**
Every file you import is saved to **isolated private storage** — completely hidden from your file manager, inaccessible to other apps, under your complete control. Open **PDFs, Office documents, spreadsheets, presentations, images, videos, audio, and code** with native-quality rendering — all 100% offline, 100% locally.
**Extract text from images with on-device OCR.** Organize by category. Search within files. Track reading time. Everything happens on your phone. Nothing leaves your phone. **No cloud. No tracking. No surveillance.**
And it's **100% open source** — fully auditable, transparent, and built by [FadSec Lab](https://github.com/fadsec-lab) with privacy-first principles as the foundation.
This is what a document viewer should be. This is Fadocx.
> [!Note]
> **iOS coming soon** — Fadocx for Apple devices is planned for a future release. Stay tuned!
## `>_` Featured In
- **Article featuring Fadocx** [LinuxEasy](https://www.linuxeasy.org/fadocx-visualizzatore-documenti-open-android/)
## `>_` 📱 Screenshots
**Home & Library**
**Home** — Dashboard with stats, recent files, and quick actions **Library** — Browse documents by category with rich thumbnail previews
**PDF & Document Viewer**
**PDF Viewer** — Header with metadata, page navigation, copy all pdf (for LLMs), invert, text mode & theme toggle **Sidebar** — Pages, search, toc. notes & bookmarks (coming soon) **Spotlight Search** — Animated dim+punch-hole find effect
**OCR Text Extraction**
**OCR Camera** — Capture or upload an image for text extraction **OCR Results** — Extracted text with bounding rectangles drawn around found content
**File Previews**
**Sheets** — Sticky headers/rows, zoom, fullscreen, copy cell value **Text Viewer** — Font picker (Ubuntu/Mono), copy, theme toggle **JSON** — Syntax highlighted code
**DOCX** — Formatted document rendering via LibreOfficeKit **PPT** — Presentation rendering with slide navigation **Video Player** — Playback speed control and loop mode
---
## `>_` Features
📄 Documents, Spreadsheets & Presentations
- **PDF** via native pdfrx engine — page navigation, text selection & extraction, invert mode, text reader mode, and **spotlight search** (animated dim+punch-hole effect for found terms)
- **Microsoft Office**: DOCX, DOC, XLSX, XLS, PPT, PPTX
- **OpenDocument**: ODT, ODS, ODP
- **Other**: RTF, CSV
- All Office and OpenDocument formats powered by the embedded **LibreOffice Kit** for desktop-class rendering
- Apache POI handles native spreadsheet parsing on Android
- **Sheets & CSV**: Sticky row numbers on left, sticky column headers (A, B, C…), tap to highlight row/column, copy cell values, zoom in/out, fullscreen mode
- **TXTs & Code**: Adjustable font picker (Ubuntu, Mono), word wrap, copy mode, fast theme toggle
🖼️ Images, Audio & Video
- **Images**: PNG, JPG, GIF, WEBP, BMP, SVG — view with real frame extraction from files
- **Video**: MP4, MKV, AVI, MOV, WEBM, FLV, WMV, 3GP, MXF — video preview with frame thumbnails
- **Audio**: MP3, M4A, AAC, FLAC, WAV, WMA, OGG, OPUS, AIFF
💻 Code Files
- **Code/Data**: Java, Python, Shell, HTML, JSON, XML, Markdown, Log
- Syntax highlighting with color-coded rendering
- Adjustable font size, word wrap, and reading mode
🧠 Intelligent OCR & On-Device AI
- Extract English text from images via Tesseract OCR + OpenCV preprocessing
- Dual PSM modes and automatic rotation correction for accurate results
- All AI runs **entirely on-device** — no cloud, no uploads, complete privacy
- More OCR languages planned for future releases
🌍 Localization
- Fadocx is translated into 11 languages: 🇬🇧 English, 🇵🇰 Urdu, 🇸🇦 Arabic, 🇩🇪 German, 🇪🇸 Spanish, 🇫🇷 French, 🇮🇳 Hindi, 🇯🇵 Japanese, 🇵🇹 Portuguese, 🇷🇺 Russian, and 🇨🇳 Chinese
📊 Reading Stats Dashboard
- Home screen stats card tracks **total documents**, **storage used**, and **reading time** across all files
- Reading time is measured automatically: when you open a document, a session timer starts. When you leave the viewer, the elapsed time is calculated and added to the file's total
- Each file tracks its own cumulative reading time, shown in the stats card as hours/minutes
- Also displays the most recently opened file for quick access
📚 Library with Category Folders
- Files are auto-organized into categories (PDF, Docs, Sheets, Slides, Images, Video, Audio, Code, Scans, Other) with fast filters and sorting
- Files are stored in Fadocx's private app storage — no reliance on public folders
- Browse by category with dedicated chip filters
- Search by file name or type
- Sort by latest, oldest, largest, or smallest
- Switch between grid and list views
- **Rich dynamic thumbnails** — thumbnails are generated by extracting real document content and rendering it in a readable preview, giving you a genuine look at each file before opening
📊 Rich File Metadata
Every document type shows relevant metadata both in the **document viewer header** and in **thumbnail previews** inside the library — so you can learn about your files without opening them.
| File Type | Metadata Shown |
|-----------|---------------|
| **PDF** | Pages, reading time, word count, line count |
| **DOCX / Text** | Reading time, word count, line count |
| **Excel / CSV** | Number of rows |
| **JSON** | Lines, total objects, total arrays |
| **Code files** | Lines, total classes, total functions |
The metadata header in the viewer gives you instant insight into your document's structure and size, while the library thumbnails surface the same info so you can compare files at a glance.
📁 File Management
- **Import**: Browse your device or use the file picker to import documents into Fadocx's private storage. Files are automatically sorted into the correct category folder
- **Rename**: Change file names directly in-app with extension preservation
- **Duplicate**: Create copies with auto‑numbered names ("copy", "copy 2", etc.)
- **Export**: Save files to Downloads or choose a custom location
- **Delete**: Soft‑delete with trash bin and restore option
- **Multi‑select**: Long‑press to enter selection mode for batch operations
- **File info**: View detailed metadata including size, type, dates, and extracted text
🔍 Search & Navigation
- Full-text search within documents with **spotlight** mode — found terms are highlighted with an animated dim+punch-hole effect that makes them impossible to miss
- Category chips for quick filtering
- Sort by date, size
- Recent files list on home screen
- Rich thumbnail previews with file metadata for quick visual identification
🎨 Themes & Privacy
- Light and dark themes — system aware or manual toggle
- **Zero tracking. No analytics. No telemetry.** [Read our privacy policy](PRIVACY.md)
- 100% offline — no internet permission required for document viewing
- Open source — fully auditable codebase
## `>_` Upcoming Features
- **FadDrive** — End-to-end encrypted cloud sync across devices
- **Document Conversion** — Convert between formats (PDF ↔ DOCX, etc.)
- **Document Editing** — Full formatting support
- **Bookmarks & Annotations** — Mark pages and add notes
- **AMOLED Black Theme** — Pure black for deeper contrast
- **More OCR Languages** — Multi-language support beyond English
- **Desktop & iOS apps** — Same experience on every platform
## `>_` 📖 Privacy
Fadocx is built on a simple principle: **your documents stay yours.**
- [x] 100% offline — no internet required
- [x] No tracking, analytics, crash logs, or telemetry
- [x] All AI/OCR runs on-device
- [x] Open source — audit the code yourself
See [PRIVACY.md](PRIVACY.md) for the full privacy policy.
## `>_` Join Community
Join our [Discord server](https://discord.gg/kvAZvdkuuN) to share ideas, seek help, or connect with other users.
[](https://discord.gg/kvAZvdkuuN)
## `>_` Support & Shop
Support development via Patreon.
[](https://www.patreon.com/cw/Fadedx/shop)
## `>_` Contributions
We welcome contributions! Before starting any work:
1. **Open an Issue** — Discuss your proposed changes first so we can track progress and avoid duplicated effort.
2. **Fork & Implement** — Work on your changes in a fork.
3. **Submit a PR** — Link your pull request to the related issue with a clear description.
Build & Development
### System Requirements
**Fadocx supports arm64-v8a architecture only** (64-bit ARM). This is due to LibreOffice native code dependencies which are only compiled for arm64-v8a.
- ✅ **arm64-v8a** (64-bit ARM) — Most modern Android devices
- ❌ **armeabi-v7a** (32-bit ARM) — Not supported (missing LibreOffice native code)
- ❌ **x86_64** (Intel/AMD) — Not supported (missing LibreOffice native code)
### Clone & Setup (first-time contributors)
```bash
# Clone repository
git clone https://github.com/anonfaded/Fadocx.git
cd Fadocx
# Install and enable Git LFS (required once per machine)
git lfs install
# Download LFS objects (ensures large native libraries are populated)
git lfs pull --all
# Install Dart/Flutter dependencies
flutter pub get
```
> Note: This repository stores a large native library via Git LFS. If you do not run `git lfs install` and `git lfs pull --all` after cloning, the large files will appear as small pointer files instead of the expected binaries.
### Building & Installing
Use the interactive build script for easy building and installation:
```bash
./build.sh
```
This opens a menu with options to:
- **Build & Install** — Build and immediately install on connected device
- **Build Only** — Build APK for manual installation later
- **Dev: Run** — Hot reload development mode with live debugging
- **Uninstall** — Remove app from device
**For detailed build options and commands, see [BUILD_GUIDE.md](BUILD_GUIDE.md).**
### Manual Build Commands
```bash
# Build release APK (minified, ~346MB)
flutter build apk --flavor prod --release --split-per-abi --target-platform android-arm64
# Install on device
adb install -r build/app/outputs/flutter-apk/app-arm64-v8a-prod-release.apk
# Run with hot reload (development)
flutter run --flavor prod
```
### Build Sizes
| Build Type | Size | Optimization |
|-----------|------|--------------|
| Release | ~346MB | R8 minification |
| Debug | ~400MB | No minification |
### Local development
```bash
# Run the beta flavor on a connected device or emulator
flutter run --flavor beta
```
## `>_` License
GNU General Public License v3.0