whatisgithub

What is papery-epub-reader?

mu-wan/papery-epub-reader — explained in plain English

Analysis updated 2026-05-18

24JavaScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

A quiet, ad free, local first EPUB and TXT ebook reader for Windows, Linux, Android, and the web, with no accounts or tracking.

Mindmap

mindmap
  root((Papery Reader))
    What it does
      Reads EPUB and TXT files
      Works offline locally
      No accounts or ads
    Tech stack
      Tauri
      epub.js
      IndexedDB
      Vite
    Platforms
      Windows
      Linux
      Android
      PWA
    Features
      Reading heatmap
      Book boxes and shelves
      Zip backup and restore
    Audience
      General readers
      Privacy focused users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read EPUB or TXT ebooks locally on Windows, Linux, or Android without an account.

USE CASE 2

Install the app as a PWA and read offline in the browser.

USE CASE 3

Organize a personal ebook library into shelves and book boxes with reading progress tracking.

USE CASE 4

Back up and restore your reading library as a versioned zip file across devices.

What is it built with?

Tauriepub.jsViteIndexedDBJavaScript

How does it compare?

mu-wan/papery-epub-readeraaaddress1/vibe-readingamirhosseinjpl/jpl-sub-processor
Stars242424
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderatemoderate
Complexity2/52/53/5
Audiencegeneralresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Local development requires Node.js 22, Rust, and a Tauri build environment for Windows.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

So what is it?

Papery is a quiet, lightweight, local first EPUB and TXT ebook reader. It is available as a native app for Windows, Linux, and Android, and also as an installable web app that works in a browser. The project's stated goal is to give readers a simple reading experience without accounts, ads, tracking, or uploading books anywhere. The reader supports importing EPUB and TXT files from your device, automatically reading each book's cover, title, and author. TXT files can be in UTF-8, BOM, GBK, or GB18030 encoding, and the app can automatically detect common Chinese chapter markers. On desktop you can turn pages with the scroll wheel, arrow keys, or clicks, while on phones you can swipe or use the system back gesture, including an immersive reading mode that shows the current page number in the corner. Readers can customize the table of contents, font size, line spacing, margins, several Chinese fonts, and the page background color and texture, and the layout automatically switches between one and two columns based on window width. Books are organized into a shelf with currently reading and finished sections, each showing real reading progress, and books can be grouped into boxes that support drag and drop on desktop or long press on mobile. The app tracks a reading heatmap covering the last year, counting time only while a book is open and the app is in the foreground. Data can be backed up as a versioned zip file containing books, files, book boxes, progress, and reading statistics, and restoring a backup can either merge with or overwrite the local library. There is no account system or cloud sync in the current version, so backup files are the way to move your library between devices. The project explains it ships only reader code, with no bundled books or book sources, and expects users to read content they obtained through legitimate means. It is built with Tauri, epub.js, Vite, and IndexedDB, and is released under the MIT license, with a bundled Chinese font under the SIL Open Font License.

Copy-paste prompts

Prompt 1
Show me how to set up a local development environment for papery-epub-reader with Node.js and Tauri.
Prompt 2
Explain how to build the Windows portable version of this app using npm run package:tauri.
Prompt 3
How does papery-epub-reader detect Chinese chapter markers in imported TXT files?
Prompt 4
Walk me through backing up and restoring my library using this app's zip backup feature.

Frequently asked questions

What is papery-epub-reader?

A quiet, ad free, local first EPUB and TXT ebook reader for Windows, Linux, Android, and the web, with no accounts or tracking.

What language is papery-epub-reader written in?

Mainly JavaScript. The stack also includes Tauri, epub.js, Vite.

What license does papery-epub-reader use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

How hard is papery-epub-reader to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is papery-epub-reader for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.