NanumOS

Books

Status: In trial

Read EPUB books like a printed book, two pages side by side in a wide window.

Books

About this app

Books keeps EPUB books together so you can choose a cover and read one page at a time. When you close a book, it starts at the same place next time.

At a glance

In one line: Pick an EPUB book from the library and read it page by page. It continues where you stopped.

The screen

Task 1. Open a book

  1. Press the cover of the book in the library
  2. See it continue from where you stopped, if you read it before

Say: "Open the book I was reading in Books"

Task 2. Turn pages

  1. Press the right side of the screen
  2. Press the left side for the previous page

Say: "Open the Books app"

Task 3. Go by the contents

  1. Press Contents at the top
  2. Press the chapter name you want

Say: "Go to chapter 3 of this book"

Basics

EPUB is an ebook format that keeps text, pictures and a contents list in one file. Its text is XHTML and its layout is CSS, so lines and pages change with the screen and text size. Books reads reflowable EPUB 2 and EPUB 3 books and shows PNG, JPEG, GIF and BMP pictures. Want more? Press ⚡ and choose 「Teach me」.

How to use it

Double-click an .epub file in Files to open it here.

  1. Put an .epub file in the Books folder in your home folder, or press Open… on the shelf to choose one.
  2. Press its cover, then press the right or left side of the page to move forward or back.
  3. Use Contents to choose a chapter, or press Ctrl+F to find a word and go to it.
  4. Use Aa to make text size, theme, font and line spacing comfortable to read.

Try it yourself

Try it: open the guide on the shelf, turn to the next page, then use Contents to choose another chapter.

How it works

Technical details

Inside an EPUB, META-INF/container.xml points to the OPF; the OPF list and reading order choose the chapters. Contents come from EPUB 3 nav or EPUB 2 toc.ncx. Fixed-layout books, DRM protection, and audio or video are not supported.

The program that reads a book file runs on its own

A downloaded book may be damaged, or made to attack. The shelf reads every book's title and cover without opening it. So taking the contents, chapters and pictures out of an .epub is done by a small program (oodoc) outside the Books window and the system. The program has a fixed amount of memory and may write to one temporary folder only. Books checks everything it sends back (the reading order, paragraph positions, the text, picture numbers) before using it. If a file makes the program stop, that book says "The book reader stopped on this file (it may be damaged)", and the shelf and your other apps stay as they were.

Technical details

u -m N -w /tmp/oodoc oodoc epub meta|chap|entry … → a ZEP (the book) and a ZEC (one chapter), checked by src/gui/zepub.h. docs/APP-ISOLATION.md §8.

FAQ

Where do the books on the shelf come from?

A fresh shelf already holds eleven classics: Hamlet and Romeo and Juliet (Shakespeare), Jane Eyre, Pride and Prejudice, Don Quixote, Alice's Adventures in Wonderland, and Korean poems and a short story. Tap a cover and you are reading. You may delete any of them; Settings > Sample Files > "Add samples again" brings them back.

Technical details

Every book is out of copyright (the authors died more than 70 years ago). The English books are Project Gutenberg editions (#1524 Hamlet, #1513 Romeo and Juliet, #1260 Jane Eyre, #1342 Pride and Prejudice, #996 Don Quixote in John Ormsby's 1885 translation); the text and the site's licence notice are kept as they are. The covers are drawn by NanumOS. The source address, the original file's hash and the licence of each book are in <code>user/samples/SAMPLES.tsv</code>.

Will a book reopen where I stopped?

Yes. The app saves the open book's chapter and text position, so pressing its cover later continues where you were reading.

Why is my book not on the shelf?

Check that the .epub file is in the Books folder in your home folder. You can also open the file in Files or choose it with Open… on the shelf.

Try this

1. Open a book

  1. Press a book's cover on the shelf. A book you were reading opens on the page you left.

Open a book 1

The shelf starts with six books to read: three Korean (Kim Sowol's 「진달래꽃」, Yun Dongju's 「하늘과 바람과 별과 시」, Kim Yujeong's 「봄·봄」) and three English with their pictures (Alice's Adventures in Wonderland, The Velveteen Rabbit, The Tale of Peter Rabbit), all out of copyright. Delete one and it does not come back. Put book files (.epub) in the Books folder of your home folder and they appear on the shelf. Opening an .epub file in Files opens it here too, and Open… on the shelf picks one.

2. Turn the page

  1. Press the right side of the page for the next one, the left side for the previous one. The arrow keys and Space do the same.

Turn the page 1

In a wide window you see two pages at once and a turn moves both. On a phone, swipe sideways; press the middle to show or hide the bars at the top and bottom. The book's title runs along the top of each page and the page number sits at the bottom centre (page numbers are an estimate: the book is only laid out one chapter at a time).

3. Go to a chapter

  1. Press Contents at the top.

Go to a chapter 1

  1. Press the name of the chapter you want.

Go to a chapter 2

  1. To find a word instead, press Ctrl+F, type a word and press Enter. Press a line to go there.

Find a word in the book 1

4. Change the text size and theme

  1. Press Aa at the top.

Change the text size and theme 1

  1. Press A+ to make the text bigger and Dark for a dark page.

Change the text size and theme 2

5. Bookmarks, highlights and notes

  1. Press Bookmark at the top (or B) to mark the page you are on.

Bookmarks, highlights and notes 1

After a jump (contents, search, a bookmark) a small ‹ 117 p. button at the bottom left takes you back, and a button on its right goes forward again (Alt+← Alt+→).

Press Zeus at the top. The words on the page are put into the Zeus chat as a quoted passage of the book; you add your question and send it.

Shortcuts

KeyDoes
→ ↓ PgDn SpaceNext page
← ↑ PgUp Shift+SpacePrevious page
[ ]Previous chapter · next chapter
Home EndStart · end of the chapter
TContents
Ctrl+F /Find in the book
Ctrl+= Ctrl+-Bigger · smaller text
FFull screen (Esc leaves it)
Ctrl+RRead aloud
BBookmark this page
HHighlight the selected text
DeleteRemove highlights in the selected span
Ctrl+Z Ctrl+Shift+ZUndo · redo highlight and note changes
Alt+← Alt+→Back · forward after a jump
EscClose a sheet → back to the shelf
Ctrl+OOpen a book
Ctrl+LThe shelf
Ctrl+,Books settings
Ctrl+WClose

Settings

Choose Books under Apps in the Settings app (inside the app, Ctrl+,) for the defaults. While reading, Aa at the top changes the same things for this book only; each book remembers its own.

SettingChoices
Reading modePages, Scroll
Text size12 to 40 (default 18)
ThemeLight, Sepia, Dark
FontSans, Serif (Latin text)
Line spacingTight, Normal, Loose
Open the book I was readingOn, Off

What it cannot do

How it works

An EPUB file is a zipped bundle of text and pictures. Books first reads a book's title, author, cover and contents for the shelf; when you open the book it unpacks one chapter at a time and splits it into paragraphs, headings, lists and pictures. Lines are broken for the text size and the width of the window (Korean text may break between syllables, but a full stop or a closing quote never starts a line) and cut into pages as tall as the screen. Your place is saved as a position in the chapter's text, not a page number, so changing the text size or the window keeps you on the same spot.

If you save a new version of the book file (for example while writing it), Books notices within a second and opens it again at the same place.

What to do now: open the guide on the shelf and turn a page.

Technical details
  • The reader is src/gui/epub.c (zip → META-INF/container.xml → the OPF manifest and spine → contents from the EPUB 3 nav or the EPUB 2 toc.ncx → a chapter's XHTML). It uses no standard library and fresh work memory for each chapter; a chapter that is too big is cut at the end and the last page says so.
  • CSS understood: font-size, font-weight, font-style, text-align, margin and padding-left, margin-top/bottom, text-indent, display:none (tag, .class and tag.class selectors, the style attribute). The rest is ignored.
  • The contents document of an EPUB (the nav item) is not shown as a page; it feeds the contents sheet.
  • Find opens the chapters one by one and scans their text (bold and italic marks are skipped); Latin text is not case sensitive.
  • Read aloud hands the page's sentences to the assistant's voice (gui_say) and moves to the next page when the speech ends. Without a sound device it says so.

NanumOS 0.1.8349 · 2026-11-16