Name
lijn-gestures — reader gestures, controls, and keyboard shortcuts
Synopsis
Lijn has two readers: the comic reader (fixed pages) and the book reader (reflowed text for EPUB, MOBI, and AZW3). Both open immersive; a tap reveals the controls overlay.
Reading Modes (Comic Reader)
- Single Page
- Engine: UIPageViewController with
.pageCurl— Apple Books-style interactive page curl. Default mode. - Double Page
- Engine: UIPageViewController with
.scroll. Two pages per spread; the cover and wide pages render alone.
Gestures (Comic Reader)
| Page turn | Edge drag or swipe, handled by the page view controller. Direction-aware (reversed in right-to-left mode). |
| Single tap | Toggle controls overlay. |
| Double tap | Toggle between 1× and 2.5× zoom (single page mode only). |
| Pinch | Zoom 1×–4× via UIScrollView (single page mode only). |
| Pan (when zoomed) | Pan around the zoomed page. |
| Two-finger swipe down | Dismiss the reader. Requires >120pt vertical and <80pt horizontal displacement. |
Double page mode has no zoom.
Controls Overlay (Comic Reader)
Controls auto-hide after 3 seconds; auto-hide can be turned off in Settings.
- Top bar
- Close (dismiss reader), title capsule, Favorite toggle, Bookmark toggle on the current page (yellow when set).
- Bottom panel
- Reading mode (Single / Double page), text engine switch (PDF only: reflowed text reading), color temperature (Normal / Warm / Night), More (extended controls sheet), brightness slider (software overlay).
- Scrubber
- Page slider, previous/next chevrons, and a tappable “N / M” indicator that opens Go to Page. Layout flips in right-to-left mode. A thin progress bar runs along the top edge.
- More sheet
- Contrast (0.5×–2×) and saturation (0–2×) sliders, reading direction (LTR/RTL), orientation lock (auto/portrait/landscape), bookmarks list, rating, and annotation mode.
Display Controls
- Brightness
- Software overlay (black transparent layer), independent of system brightness.
- Color Temperature
- Normal: no overlay. Warm: orange tint at 10% opacity (multiply). Night: warm tint at 15% opacity (multiply).
- Contrast / Saturation
- Applied directly to the page content.
- Orientation Lock
- Auto-rotate, portrait, or landscape.
- Keep Screen On
- Enabled by default while reading (system idle timer disabled until the reader closes).
Reading Direction
- Left to Right
- Default.
- Right to Left
- Auto-applied when the comic’s format is manga; can be changed in the More sheet. Page order, spreads, and the scrubber flip accordingly.
Keyboard Shortcuts
| Comic reader | |
|---|---|
| ← | Previous page (direction-aware) |
| → | Next page (direction-aware) |
| Space | Next page |
| Esc | Dismiss reader |
| b | Toggle bookmark on current page |
| f | Toggle controls overlay |
| [ | Jump to previous bookmark |
| ] | Jump to next bookmark |
| Book reader | |
|---|---|
| ← / → | Previous / next page |
| Space | Next page |
| Esc | Dismiss reader |
| Library | |
|---|---|
| ← / → | Move between filter tabs |
| Esc | Exit selection mode |
| ⌘I | Import files |
| ⌘, | Open Settings |
| ⌘⇧L | Toggle grid/list view |
Book Reader (EPUB / MOBI / AZW3)
Native paginated engine with the same page-curl turns; the curl can be disabled in the reading settings.
| Center tap | Toggle controls (center half of the page; edges belong to the page curl). |
| Edge drag | Turn page. |
| Text selection | Long-press; the menu offers Copy, Highlight, Define (system dictionary), and Translate. |
| Tap link | Internal links navigate in-book; external links open in the browser. |
Top bar: Close, tappable title (opens the table of contents), Search, Bookmarks. Bottom panel: theme pills (Light / Sepia / Dark / Black), font size A−/A+, settings, brightness slider, and a position/chapter label.
Settings panel: font family (7 choices), font size, text alignment and hyphenation, margins, line spacing, page curl toggle, plus the shared display controls.
Annotations (Comic Reader)
Annotation mode is entered from the More sheet. Tools:
- Text note
- Tap a location to place a text note.
- Highlight
- Drag a rectangle over a region.
- Drawing
- Freehand PencilKit drawing on the page.
Annotations use normalized coordinates (0–1 relative to page dimensions) for resolution independence. Undo/redo stacks are maintained per session. Exportable to Markdown, JSON, or annotated PDF.
In the book reader, highlights attach to the selected text range within a chapter.
See Also
Author
Aymane Bengrina — Studio Alticcio
alticc.io