12
Violet Orbit12 unitsComic · 0001 – 0012
03 / Portable media pipeline
YarReader
An offline comic and book library that turns mixed files into a checked, portable reader and can safely continue after a crash or interrupted copy.
- Primary capability
- Offline, recoverable media pipeline
- Technologies
- Characteristics
01 — Problem
Protect the library while rebuilding it.
A single folder may contain comics, ebooks, PDFs, loose images, duplicate editions, and half-finished downloads. YarReader must protect the original files, recover after an interruption, and never replace the working library with an incomplete copy.
02 — What I built
What the project does.
- Readers for six common source types, including comic archives, ebooks, PDFs, and image folders
- A SHA-256 digital fingerprint for every file, so renamed copies can still be recognized
- Optional AI suggestions that must pass format checks and receive human approval
- A work journal that lets long copy and archive jobs continue after a crash
- The same page-conversion rules every time, producing versioned WebP images
- A complete new library is checked before it replaces the old one; the finished reader needs no server
03 — Architecture
Each part has one job.
InspectOpen each source safely and record what it contains
IdentifyMatch the book using rules first, optional AI second, and a person when needed
ConvertTurn pages into consistent images with digital fingerprints
PublishCheck the entire new library before making it the active copy
04 — Key design choice
Do the hard work before the reader opens.
All difficult work—opening formats, checking files, and converting pages—happens before the reader opens. The finished library is ordinary HTML and images with local links, so it can be copied to a drive and used without internet access.
05 — What works today
A library that can recover and be rebuilt.
If a copy or conversion stops, YarReader continues from its work journal. Different editions keep clear identities. Every finished library is checked before use and never changes afterward. If generated files are lost, they can be rebuilt from the protected originals and catalog.