Skip to content

KOReader

Paweł Jastrzębski edited this page Oct 4, 2026 · 4 revisions

Metadata

By default KOReader don't know how to parse ComicInfo.xml embeded in Inksetter output.
Third-party plugin is required: comicmeta.koplugin

Settings

To properly read CBZ files created by Inksetter in KOReader, two conditions must be met:

  • The entire screen must be available for the content.

  • KOReader must not process or resize the loaded images in any way.

This requires a specific configuration of the reader:

  • The status bar must be hidden. You can do this by clicking on it several times until it hides.

  • The bottom of the configuration menu must be set as follows:

Page Crop - none

image

Margin - 0

image

Fit - width

image

View Mode - page

image

The remaining options can be left at their default settings after ensuring that all options in the “Additional Effects” tab are disabled:

image

Persistent configuration

However, these settings are saved per book, and constantly having to remember them can be inconvenient. I therefore recommend creating a directory to store the entire context created by Inksetter so that you can set default settings for the entire directory.

For example, a manga directory can be created at the root of the Kindle storage, and the file koreader/settings/directory_defaults.lua can be used to set the default options for the entire directory:

return {--do NOT change this line

 --HELP:
 -- You can override default settings for documents per directory in this file.
 -- The directories must be under the home folder.
 -- You can find settings to change in the metadata.lua in the .sdr folder.
 -- The path must start with "/" (absolute path).
 -- The path must not end with a "/" it must end with the folder name.

 -- syntax:

 --   ["path/to/folder"] = {
 --         ["setting_to_override"] = value,
 --    },

 -- examples:

 --[[
    ["/mnt/us/documents/hebrew"] = {
        ["inverse_reading_order"] = true
        ["invert_ui_layout"] = true
    },
    ["/mnt/onboard/smalltext"] = {
        ["copt_font_size"] = 34,
        ["copt_line_spacing"] = 130,
    },
    ["/sdcard/Books/smalltext"] = {
        ["copt_font_size"] = 34,
        ["copt_line_spacing"] = 130,
    },
--]]

 -- comment out line ("--" at line start) to disable


 -- ADD YOUR DEFAULTS HERE:
    ["/mnt/us/manga"] = {
        ["inverse_reading_order"] = true, -- Enable RTL reading mode by default
        ["kopt_page_scroll"] = 0,
        ["kopt_trim_page"] = 3,
        ["kopt_page_margin"] = 0,
        ["kopt_zoom_mode_type"] = 0
    },
}--do NOT change this line

Clone this wiki locally