Skip to content

anonfaded/Fadocx

Repository files navigation

>_ Fadocx

All-in-one document viewer: PDF, Office, spreadsheets, presentations, code files & OCR text extraction — fully offline, zero tracking, open-source.

GitHub all releases Support me on Patreon Discord

Tip

This project is part of the FadSec Lab suite.
Discover our focus on ad-free, privacy-first applications and stay updated on future releases!

More from FadSec Lab:
🔒 FadCrypt — file/folder encryption
🎥 FadCam — background video recorder

>_ 📱 Screenshots

Home & Library

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 PDF Sidebar Search

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 OCR Results

OCR Camera — Capture or upload an image for text extraction      OCR Results — Extracted text with bounding rectangles drawn around found content


File Previews

Sheet Text Viewer JSON

Sheets — Sticky headers/rows, zoom, fullscreen, copy cell value    Text Viewer — Font picker (Ubuntu/Mono), copy, theme toggle    JSON — Syntax highlighted code


DOCX PPT

DOCX — Formatted document rendering via LibreOfficeKit                          PPT — Presentation rendering with slide navigation


>_ 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 & Code Files
  • Images: PNG, JPG, GIF, WEBP, BMP, SVG
  • 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 languages planned for future releases
📊 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, 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
  • 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.

  • 100% offline — no internet required
  • No tracking, analytics, crash logs, or telemetry
  • All AI/OCR runs on-device
  • Open source — audit the code yourself

See PRIVACY.md for the full privacy policy.

>_ Join Community

Join our Discord server to share ideas, seek help, or connect with other users.

Discord

>_ Support & Shop

Support development via Patreon.

Support me on Patreon

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

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)

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

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

Manual Build Commands

# 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

# Run the beta flavor on a connected device or emulator
flutter run --flavor beta

>_ License

GNU General Public License v3.0

About

All-in-one offline document viewer for Android with OCR and desktop-class rendering — private, open-source, zero tracking

Topics

Resources

License

Stars

Watchers

Forks

Contributors