Short:        eBook, comic and document reader
Author:       Falke_34
Uploader:     falke 34 gmx de (Falke_34)
Type:         text/dtp
Version:      1.3
Requires:     68020 or better recommended; RTG graphics card (cybergraphics.library, e.g. Picasso96/CyberGraphX - AGA-only systems are not supported); Fast RAM recommended for larger PDFs/scans
Architecture: m68k-amigaos >= 3.2
Distribution: Aminet

================================================================
 AmiBookReader (AmigaOS 3.2 / 68k)
 An eBook and document reader for classic AmigaOS
================================================================

Description
-----------
AmiBookReader is a native 68k AmigaOS application for reading e-books,
comics and documents. It uses a statically linked MuPDF as its
rendering engine together with a classic ReAction/GadTools GUI, so it
feels right at home on Workbench. This is the AmigaOS 3.2 sibling of
the AmigaOS 4.1 PowerPC version of AmiBookReader.

Supported formats:
  * epub, pdf, cbz, xps, oxps, fb2, mobi   - documents / e-books
  * html, htm, xhtml                       - (X)HTML documents
  * png, jpg, jpeg, gif, bmp, tiff, tif     - standard images
  * svg, txt                               - vector graphics / text
  * jp2, jpx                               - JPEG 2000
  * jbig2                                  - often embedded in scanned
                                              PDFs, can also be opened
                                              directly
  * pnm, pbm, pgm, ppm, pam                 - Unix bitmap formats

Features
--------
  - Native ReAction/GadTools GUI, resizable window
  - Contents/bookmarks panel showing the document outline (when
    available); the "Contents" menu item is greyed out if the
    document has no outline
  - Search panel: find text, jump to previous/next match, page
    position is remembered
  - Export menu: export the current page or the whole book as PDF,
    PNG, JPEG, HTML, XHTML or plain text (menu entries that don't
    make sense for the current document, e.g. re-exporting a PNG as
    PNG, are automatically greyed out)
  - Zoom panel with +/- buttons and reset, or +/- keyboard shortcuts
    when the panel is closed
  - Mouse wheel scrolling (scrolls within page, turns page at edge)
  - Vertical and horizontal scrollbars
  - Fullscreen mode (View menu, checkbox)
  - Night mode and Sepia reading mode (experimental)
  - Bookmarking: automatically remembers the last opened book and page
  - "Start with Last Document" option (Settings menu)
  - "Keep Window Size on Exit" option (Settings menu) - also saves
    and restores the main window's position, not just its size
  - Contents, Search and Zoom panel positions/sizes are saved and
    restored reliably
  - Jump to first/last page, direct page selection
  - Drag & Drop: drop a file onto AmiBookReader to open it directly;
    files dropped onto the iconified AppIcon open right away, no need
    to uniconify first
  - Double-clicking a document whose default tool is set to
    AmiBookReader opens that document directly
  - Shell support with command line arguments (see below)
  - Iconify support
  - Workbench icon and screen title integration
  - Icons created by McFly

Requirements
------------
  - AmigaOS 3.2 (should also work on other AmigaOS 3.x versions with
    ReAction installed, but only tested on 3.2)
  - 68020 or better recommended - MuPDF rendering is CPU-intensive,
    a plain 68000/68010 will be very slow
  - An RTG graphics card with cybergraphics.library support
    (Picasso96, CyberGraphX, or compatible) - AGA-only systems are
    NOT supported, page rendering is blitted through
    cybergraphics.library
  - A reasonable amount of Fast RAM is recommended for larger PDFs or
    high-resolution scans

Installation
------------
  1. Copy the AmiBookReader drawer to your hard disk (e.g. Work:).
  2. Double-click the AmiBookReader icon to launch.
  3. Optionally drag a supported file onto the icon/window to open
     it directly, or set AmiBookReader as the default tool of a
     supported document to open it via double-click.

Usage from Shell
-----------------
  AmiBookReader [FILE] [PAGE <n>] [PUBSCREEN <n>]

  FILE       - path to a document, e-book or image to open
  PAGE       - page number to jump to (1 = first page)
  PUBSCREEN  - name of a public screen to open the window on

  Examples:
    AmiBookReader Work:Books/manual.pdf
    AmiBookReader Work:Books/manual.pdf PAGE 42
    AmiBookReader Work:Books/manual.pdf PUBSCREEN MyScreen

  Without any arguments, AmiBookReader resumes the last opened book
  and page automatically, unless "Start with Last Document" has been
  disabled in the Settings menu.

Known Issues
------------
  - Night mode and Sepia are experimental and may still need some
    fine-tuning on certain images or colour profiles.
  - HTML/XHTML export is meant for viewing in a real web browser or
    feeding into another XML/e-book toolchain - MuPDF's own HTML
    writer output is not intended to be re-opened by AmiBookReader
    (or by MuPDF-based readers in general).

Credits
-------
  - Rendering engine: MuPDF (https://mupdf.com)
  - GUI: ReAction / GadTools classes (window.class, layout.class,
    button.class, space.class, scroller.class, listbrowser.class)

Contact
-------
  Author:  Falke_34
  Email:   falke.34@gmx.de

================================================================
 History / Changelog
================================================================

v1.3 (14.07.26)
  - Initial Aminet release of the AmigaOS 3.2/68k version.