Kho Sách - manual install
=========================

Kho Sách is an OPDS catalog browser for jailbroken Kindles. It shows up on
the home screen as "Kho Sách"; tap it to browse catalogs and download books.

Requirements
------------
- A jailbroken Kindle with the KindleModding Universal Hotfix installed.
  It provides fbink (used for drawing) and SH_Integration, which turns .sh
  files in documents/ into home-screen entries ("scriptlets").
- Tested on a Kindle Paperwhite 5 (2021), firmware 5.19.2, Véra jailbreak.
  Other models are untested.

Install
-------
1. Connect the Kindle to your computer over USB.
2. Copy the two folders in this zip onto the Kindle drive, merging with
   the folders already there:

     documents/opds.sh                 -> Kindle/documents/opds.sh
     extensions/opds/bin/opds          -> Kindle/extensions/opds/bin/opds
     extensions/opds/feeds.conf        -> Kindle/extensions/opds/feeds.conf

   UPGRADING? Do not copy feeds.conf over your existing one: it holds your
   catalog list. Copy only opds.sh and bin/opds.
3. Eject the Kindle and tap "Kho Sách" on the home screen.

Configure
---------
Edit Kindle/extensions/opds/feeds.conf with a plain-text editor. One
catalog per line:

  Project Gutenberg|https://www.gutenberg.org/ebooks.opds/
  My Calibre-Web|http://192.168.1.10:8083/opds|user:password

Add "lang=vi" on its own line for a Vietnamese interface (default: English).
Logins are stored in plain text; use an account you don't mind exposing.

Where books go
--------------
azw3, mobi, pdf and txt go to documents/ and appear in the Kindle library.
EPUB goes to opds-books/ and needs KOReader to open.

Uninstall
---------
Delete Kindle/documents/opds.sh and the Kindle/extensions/opds folder.
Your downloaded books stay where they are.

Licence: MIT (see LICENSE).
