An open API service indexing awesome lists of open source software.

https://github.com/janptn/flexcil-backup-viewer

A modern, local-first desktop viewer for Flexcil backup files.
https://github.com/janptn/flexcil-backup-viewer

backup desktop-app document-viewer flexcil flexcil-windows-viewer indexeddb offline-first pdf-viewer react vite

Last synced: 3 months ago
JSON representation

A modern, local-first desktop viewer for Flexcil backup files.

Awesome Lists containing this project

README

          


Flexcil Backup Viewer


A modern, local-first desktop viewer for Flexcil backup files.


⚑ Fast β€’ πŸ”Ž Full-Text Search β€’ πŸ“‚ Folder Structure β€’ πŸ” 100% Local

---

# Flexcil Backup Viewer

A modern, local-first desktop viewer for Flexcil backup files.

The application allows you to open official Flexcil backup archives on your computer, browse documents, search their contents and display handwritten annotations directly inside the viewer.

> ⚠️ This project is not affiliated with, endorsed by, or connected to Flexcil in any way.

---

## ✨ Features

- πŸ“‚ Rebuilds folder structure from `documents.list`
- πŸ“„ Extracts PDFs from Flexcil backup ZIP / `.flx` files
- ✍️ Displays Flexcil ink annotations (handwritten notes)
- πŸ”Ž Real-time full-text search across documents
- πŸ“‘ Jump-to-page navigation
- πŸ–Ό Thumbnail preview grid
- πŸ“Š Import progress indicator
- πŸ’Ύ IndexedDB local storage
- πŸŒ™ Modern dark UI
- πŸ” 100% local – no uploads, no cloud interaction

---

## ✍️ Annotation Rendering

The viewer is capable of displaying Flexcil handwritten annotations directly on top of the original PDF pages.

This includes:
- pen strokes
- handwriting
- pressure-based ink rendering

## πŸ–Ό Screenshots

### πŸ“š Library View



Modern folder sidebar with thumbnail grid and metadata overview.

---

### πŸ“„ Document Viewer



Built-in PDF.js viewer with navigation, zoom, and jump-to-page support.

---

### πŸ”Ž Full-Text Search



Instant search across all indexed documents with live updates.

---

## ⬇️ Download (Windows .exe)

If you don’t want to run the development version, you can download the standalone Windows executable from the **Releases** section.

### Steps:

1. Go to the GitHub **Releases** page.
2. Download the latest `.exe` file.
3. Double-click to start the application.
4. Your browser will open automatically.

No installation required.

---

## πŸš€ Getting Started (Development Version)

### 1. Clone repository

```bash
git clone https://github.com/janptn/flexcil-backup-viewer.git
cd flexcil-backup-viewer
```

### 2. Install dependencies

```bash
npm install
```

### 3. Start development server

```bash
npm run dev
```

Open the shown local URL in your browser.

---

## πŸ“¦ How To Use

### Importing Documents

1. Download your Flexcil backup ZIP from Google Drive.
2. Drag & drop the ZIP file into the app.
3. The app automatically:
- Extracts PDFs
- Rebuilds folder structure
- Indexes document text
- Stores everything locally in IndexedDB

---

### Updating With New Documents

Whenever you create new documents on your tablet:

1. Download the latest Flexcil backup ZIP from Google Drive.
2. Drag & drop it into the app again.
3. The viewer automatically:
- Detects new documents
- Skips already imported ones
- Updates the library instantly

You can repeat this process anytime.

No manual cleanup required.

---

## πŸ” Privacy

- No telemetry
- No tracking
- No cloud sync
- No external uploads
- All data stored locally in your browser

You can clear stored data anytime via browser storage settings.

---

## πŸ’‘ Why This Exists

Flexcil is tablet-first.
This tool provides a fast and clean desktop viewing experience without requiring official desktop support.

Built for productivity and open-source collaboration.

---

## βš–οΈ Legal Notice

Flexcil is a trademark of its respective owners.

This project is an independent viewer for user-generated backup files and does not interact with official Flexcil services.

---

## πŸ“œ License

MIT License Β© 2026 Jan Pultin