John O'Keefe
c1a7648076
reader-guide.md gains the audiobook/episode player section (seek, prev/next episode, Bookmarks panel, Chapters list, Player settings with autoplay/speed/resume-rewind overrides, Shortcuts dialog) — the player existed with zero user docs. kobo-setup.md drops the stale 'not available yet, actively being developed' framing: the server side of native Kobo sync is implemented and documented (sync/initialization endpoints, bookmark + markup sync, shelf mappings, KEPUB sidecar config), so the guide now states exactly that, keeps stock-firmware rollout as the honest remaining piece, and keeps KOReader as the supported today-path. ui-controls.md: Player settings / Shortcuts & interactions / Chapters / Bookmarks entries (templ-entity fragments for ampersand labels).
3.9 KiB
Web Reader Guide
Bookhoard's built-in web reader works in any modern browser — desktop or mobile — and keeps your position, highlights, bookmarks, and notes in sync with the Android app and KOReader. Audiobooks get their own player, covered at the end of this guide.
Opening a Book
From your library or book page, click Read. The reader opens in an immersive view with the book's cover, title, and chapter in the top bar (EPUB) or page number (PDF/comics).
Navigation
On a phone or tablet (touch)
| Gesture | Action |
|---|---|
| Swipe left / right | Turn the page |
| Tap once | Toggle the reader menu (headers, settings, drawers) |
| Tap in a corner zone | With the menu open: jump back / forward by chapter |
Paging is swipe-only by design: taps are reserved for the menu so a page turn can never fire while you're trying to select text.
On desktop
- Scroll wheel, trackpad, arrow keys, or Page Up / Page Down to page
- Click the progress bar (bottom, with the menu open) to jump
- Contents drawer for the table of contents; Pages grid for PDF/comics
Text Selection & Highlights
Selecting text (touch)
- Press and hold a word (~half a second) until it highlights
- Drag to extend the selection word by word — it stays on the visible page
- Drag the round handles (EPUB) to fine-tune the start and end points
- Lift your finger and pause — the highlight menu appears below the selection, underneath the browser's own copy menu
The browser's address bar hides while a selection is active to give the page room; it returns as soon as the selection is cleared.
Creating a highlight or note
With the selection menu open:
- Color dots — tap one to highlight immediately in that color
- Pencil — opens a note; write it and tap Highlight with note to save the highlight and its note together
- Copy — copies the selected text (works even over plain HTTP on your LAN)
- While the note editor is open, you can still change the color — the popover stays put until you save or cancel
Editing or removing a highlight
Tap anywhere on a painted highlight to reopen it in the menu. From there you can change its color, edit the note (pencil → Save note), or delete it (trash icon). Tapping anywhere else closes the menu.
PDFs and comics
Text selection works the same way on PDFs. Highlights are stored as page-anchored rectangles and sync to the Android app. Comics/manga libraries disable annotation (bookmarks still work).
Notes & Bookmarks
The annotations drawer (right side, from the open menu) lists your highlights, standalone notes, and bookmarks for the book — tap any entry to jump to it.
Where Reading Position Is Stored
Position, highlights, bookmarks, and notes sync automatically through the server (see the Sync Guide). Close the tab whenever you like — the reader resumes exactly where you left off on any device.
Listening to audiobooks and podcast episodes
Books with audio files, and podcast episodes, open in the audio player instead of the page reader. It is one player for both:
- The seek bar is your position; drag it, or use the previous / next episode controls when you are playing a sequence
- Bookmarks opens a panel of your markers for this title — tap one to jump back
- Chapters opens the chapter list (shows "currently chapter N of M"); audiobooks with embedded chapters and podcast shows with chapter marks both land here
- Player settings holds the per-player preferences: Autoplay on open, Default playback speed, and Resume rewind (a few seconds back when you resume — the defaults come from your profile and this panel overrides them per player)
- The Shortcuts & interactions panel (the ? control) lists every keyboard shortcut
Progress, bookmarks, and your speed carry across devices through the same sync as everything else.