hanatsumi / rakuyomi

A manga reader plugin for KOReader.
GNU Affero General Public License v3.0
8 stars 0 forks source link

rakuyomi

rakuyomi is a manga reader plugin for KOReader.


"Ubunchu!" by Hiroshi Seo is licensed under CC BY-NC 3.0.

Installation

Download the latest release for your device from the releases page. Currently, only Kindle devices are supported (the Kindle build should work with Kobo devices, but it's untested).

Place the rakuyomi.koplugin folder inside KOReader's plugins folder.

Configuration

In order to use the plugin, you'll need to add some sources. rakuyomi is compatible with Aidoku sources. The easiest way to obtain sources is to configure source lists and download the sources through the app.

You'll most likely find links with the format https://aidoku.app/add-source-list/?url=<source list URL>. Grab the source list URL from these links and make sure it ends with /index.min.json. If it doesn't, add it yourself.

Create a rakuyomi/settings.json file inside KOReader's home directory, with the following contents:

{
    "$schema": "https://github.com/hanatsumi/rakuyomi/releases/download/main/settings.schema.json",
    "source_lists": [
        "https://samplewebsite.com/sources/index.min.json",
        "<your source list URL>",
    ],
    "languages": ["en", "<your preferred language here>"]
}

After configuring a source list, sources can be installed through the plugin, by going to the main menu and going to "Manage sources".

Usage

To open the library view, go to the "Search" menu and tap on the "Rakuyomi" entry. Tap the menu button on the top left to open the main menu.