-
-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Change defaults
The easiest way to set a global default setting is from within the KOReader application — long press the option you wish to make the default. KOReader will ask you to confirm the new default.
For users who wish to edit config files directly, there are two such files that contain the initial settings for KOReader's behavior and appearance:
-
- The
defaults.lualocated atkoreader/defaults.lua.
- The
-
- The
cr3.inilocated atkoreader/data/cr3.ini, especially for EPUB/FB2 documents.
- The
A very few examples (some of these settings are actually available in the UI, too).
| Settings(default) | Location | Change range | Description | Affected parts |
|---|---|---|---|---|
DSHOWOVERLAP = false |
defaults.lua |
false or true
|
showing gray area to indicate page overlap | PDF/DJVU |
DHINTCOUNT = 1 |
defaults.lua |
0 - 3
|
number of pages to render ahead in background | PDF/DJVU |
DCREREADER_VIEW_MODE = "page" |
defaults.lua |
"page" or "scroll"
|
pagination in "page" mode, no pagination in "scroll" mode | EPUB/FB2 |
DCREREADER_CONFIG_DEFAULT_FONT_SIZE = 22 |
defaults.lua |
16 - 44
|
default font size | EPUB/FB2 |
DSHOWHIDDENFILES = false |
defaults.lua |
false or true
|
showing hidden files (name begins with a ".") | FileManager |
Note that configuration changes to the koreader/defaults.lua file will be overridden by nightly releases/OTA updates automatically and without warning. To make configuration changes persist between updates, you need to move your changes into koreader/defaults.custom.lua.
Alternatively, you can lookup or modify these settings from within KOReader, via the Tools > More tools > Advanced settings menu (top menu, in the File Manager). The modifications will be properly (i.e., in defaults.custom.lua) stored on exit.
Of particular interest in there are the various tap zones (DTAP_ZONE_*), as well as the default ranges for the various CRe settings available in the bottom menu (DCREREADER_CONFIG_*).
A (very) few settings, not (yet) available in menus, can be manually added to settings.reader.lua (while KOReader is not running). They are documented at https://github.com/koreader/koreader/issues/2589#issuecomment-323927682
Home |
- Changelog
- Install on Android
- Install on Cervantes
- Install on ChromeOS
- Install on Kindle
- Install on Kobo
- Install on PocketBook
- Install on reMarkable
- Install on Desktop Linux
- Install on MacOS
- Install on Windows with WSL
- Install using Linux container (Docker, Podman)
Basic reading controls (click to open)
Advanced reading controls (click to open)
- Getting started
- Gestures
- Change defaults
- DPI control
- Style tweaks for misbehaving books
- Reflowing tweaks
- Screenshots
- Troubleshooting
- Android tips and tricks
- Auto frontlight
- Auto standby
- Auto suspend
- Background runner
- Battery statistics
- Calibre
- Cover browser
- Cover image
- Frontlight gesture controller
- Goodreads (deprecated)
- Highlight exporter
- Japanese Support
- Keep alive
- News downloader
- Perception expander
- Progress sync
- Read timer
- Reading statistics
- Send2Ebook
- SSH
- System statistics
- Terminal emulator
- Time sync
- Vocabulary builder
- Wallabag