Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Tags: wahello/koreader

Tags

v2024.04

Toggle v2024.04's commit message
KOReader 2024.04 "Sourdough"

![Sonnenfee - KOReader - Theme - sourtough](https://github.com/koreader/koreader/assets/202757/08671da1-eb68-4398-aeb2-b6969d36e2c7)

As usual, there have been so many changes that it's difficult to tell a coherent story about them. One of the more noticeable changes is that the sleep screen menu (formerly known as the screensaver menu) has been reworked (koreader#11549). But there's also been a lot of work on the backend, updating the build infrastructure and crengine.

This month's logo was contributed by @Sonnenfee

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* Input: Don't let wacom pens clobber the slot of the next contact (koreader#11520) @NiLuJe
* Use Bresenham's algorithm and anti-aliasing for rounded corners (koreader#11498) @zwim
* Menu, DictQuickLookup, TextViewer: allow mousewheel scrolling (koreader#11525) @poire-z
* CoverBrowser: show cached cover of deleted file in history (koreader#11523) @hius07
* Bookmarks: edit highlighted text (koreader#11484) @hius07
* Fulltext search: default mode, fixes (koreader#11507) @hius07
* ReaderFooter: chapter progress bar (koreader#11505) @hius07
* bump crengine: better conformance to the HTML Standard rendering (koreader#11527) @poire-z
	Includes:
	- Hyphenation: update French.pattern koreader/crengine#553
	- [CI] Add stylelint to help prevent typos in CSS koreader/crengine#556
	- koreader/crengine#555 :
	- In-page footnotes: better handle duplicated ids
	- lvrend: handle in-page footnotes in table `<caption>`
	- lvstsheet: fix compiler warnings
	- LVString: ignore CJK chars in `lStr_findWordBounds()`
		Closes koreader#11478.
	- lvtext: `AddLine()`: handle some CJK + space edge case
		See koreader#11478 (comment).
	- EPUB: look for EPUB3 cover even when EPUB2 cover advertized
		See around koreader#11491 (comment).
                Hat tip @DanielKauss for discussion. ^_^
	- List items: proper per-specs positionning and sizing
		Closed koreader/crengine#521.
	- epub.css: add/use `@media (-cr-max-cre-dom-version: 20180527)`
	- fb2def.h: add more HTML element and attributes names
	- CSS: generic support for handling presentational hints
		Closed koreader/crengine#551
	- CSS: add support for private `-cr-apply-func`:
	- ldomDocumentWriterFilter: remove attribute to CSS conversion
	- lvrend: more proper rendering of block images
	- lvrend: keep margin_left/right updated when "auto"
	- CSS: add support for handling HTML's `align=` attribute
	- lvrend: fix HR and images positionning when floats involved
	- epub.css, html5.css: minor updates for easier stylesheet switch
	- epub.css, html5.css: major updates for better conformance
		Closes koreader#10770.
	- fb2.css: fix CI stylelint warnings
* ReaderTypeset: tweak Style> menu logic and defaults (koreader#11527) @poire-z
* Style tweaks: add tweak to avoid some presentational hints (koreader#11527) @poire-z
* util.prettifyCSS(): handle better :is() and similar (koreader#11527) @poire-z
* Wikipedia: tweak EPUB css to force epub.css look (koreader#11527) @poire-z
* Wallabag: properly deal with mimetype actually being content-type (koreader#11532) @Frenzie
* Screensaver: 0% only on first page, 100% only on final page (koreader#11541) @Commodore64user
* ReaderZooming: make auto-crop default be page content (koreader#11438) @hugleo
* Book style tweak: add more suggestions in "CSS ≡" (koreader#11533) @poire-z
* Wikipedia EPUBs: add settings for include/highres images (koreader#11544) @poire-z
* Allow asymmetric margins for autocrop (koreader#11540) @hugleo
* Dictionary: Fix download message when connection fails (koreader#11548) @jovanbulck
* appimage: get full path before changing to assets dir (koreader#11552) @pazos
* Android: Add Linfiny eNote / Avalue ENT-13T1 / QuirkLogic Papyr (koreader#11554) @davide125
* ReaderView: ensure that the pan zoom direction is not nil (koreader#11557) @hius07
* ReaderStatus: update status modification time (koreader#11568) @hius07
* [fix] ReaderLink: fix copy link (koreader#11569) @Frenzie
* covermenu: fix file dialog (koreader#11576) @hius07
* ReaderToc: add option to show chapter lengths (koreader#11546) @poire-z
* bump crengine: various fixes, improved Russian typography (koreader#11578)
	Includes:
	- koreader/crengine#558 :
	- In-page footnotes: avoid with '-cr-hint: noteref-ignore'
	- In-page footnotes: ensure they don't cross "flows"
	- Tables: fix rendering when negative text-indent
	- FB2 cover drawing: ensure _invertImages flag
		Closes koreader#11574.
	- EPUB: fallback to look for a cover in the first fragment
		Closes koreader#11571.
	- TextLang: Russian: add typography rules koreader/crengine#557
* ReaderTypography: update menu features symbols for Russian (koreader#11570) @dmalinovsky
* [i18n] Add en-GB and Romanian translation to UI (koreader#11577) @Frenzie
* PocketBook: remove unused `color_saturation` parameter (koreader#11597) @dmalinovsky
* ReaderView: increase underline thickness (koreader#11586) @Commodore64user
* FileChooser collates: use "item.sort_percent" for sorting + extra `on-hold` handling (koreader#11592) @hasezoey
* bump base: fix sdcv binaries on non-Android/macOS platforms (koreader#11609) @benoit-pierre
* [i18n] Font UI fallbacks: insert replacement characters with template for Weblate compatibility (koreader#11614) @Frenzie
* ReaderHighlight: ~~strikeout~~ → Strikethrough (koreader#11619) @Commodore64user
* File manager: fix classic mode item font size (koreader#11626) @hius07
* Do `flashui` refresh for first display of History page (koreader#11603) @dmalinovsky
* Add support for C64P (koreader#11636) @ovehbe
* NetworkMgr: Fix PocketBook losing net access (koreader#11601) @liskin
* NetworkMgr: Use cheaper/simpler hasDefaultRoute in isOnline (koreader#11601) @liskin
* NetworkMgr: Limit the hasDefaultRoute check in isOnline to PocketBooks (koreader#11601) @liskin
* bump crengine: various fixes, updated russian hyphenation (koreader#11637) @poire-z
	Includes:
	- koreader/crengine#561 :
	- Russian hyphenation: allow hyphens after Russian "не" prefix
	- koreader/crengine#560 :
	- EPUB: add "identifiers" to doc props
	- koreader/crengine#563 :
	- EPUB: avoid crash when '@font-face' in <head><style>
	- FB2: fix block images sizing and centering
		Closes koreader#11623.
	- lvrend: fix positioning of bottom border on empty block elements
		Closes koreader#11594.

	Also includes:
	- cre: add 'identifiers' to doc props koreader/koreader-base#1758
	- build and ci: various tweaks:
	koreader/koreader-base#1759 @benoit-pierre
	koreader/koreader-base#1762 @benoit-pierre
	koreader/koreader-base#1763 @benoit-pierre
	koreader/koreader-base#1764 @benoit-pierre
* CreDocument: support added 'identifier' metadata (koreader#11628) @baswag
* Sleep screen menu reworked (koreader#11549, koreader#11647) @Commodore64user
* GetText: fix crash if a value is used as unique value and as singular/plural (koreader#11643) @Frenzie
* [i18n] GetText: fix fuzzy detection for certain strings (koreader#11648) @Frenzie
* bump base, luajit-launcher, avoid assert failure in sub-processes (koreader#11658) @poire-z
* make: fix test rule (koreader#11659) @benoit-pierre
* Various AppImage fixes and improvements (koreader#11662, koreader#11669, koreader#11665, koreader#11671) @benoit-pierre @Frenzie
* ci: bump CircleCI docker images, other CI improvements (koreader#11677) @benoit-pierre
* Stop touching night mode when control_nightmode == false (koreader#11685) @imax9000
* Kindle Scribe: find accelerometer based on hardware (koreader#11642, koreader#11696) @mergen3107
* Hide hidden flows and custom toc from non-touch devices (koreader#11690) @Commodore64user
* NewsDownloader: use <content:encoded> from RSS item, if available (koreader#11694) @imax9000
* Add PocketBook Era Color (PB700K3) (koreader#11695) @ElimGarak1
* Keyboard: detect tap if swipes are disabled (koreader#11699) @hius07
* Add relevant nil guards to prevent reflow crashes (koreader#11715) @Galunid
* Gesture: add jump to random page (koreader#11727) @vyaus
* pocketbook: simplify device model detection (koreader#11721) @benoit-pierre

[Full changelog](koreader/koreader@v2024.03...v2024.04) — [closed milestone issues](https://github.com/koreader/koreader/milestone/72?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)

v2024.03.1

Toggle v2024.03.1's commit message
KOReader 2024.03.1

Fixes a crash when opening the menu using the keyboard (koreader#11509).

v2024.03

Toggle v2024.03's commit message
KOReader 2024.03 "Read 'n Relax"

![Sonnenfee - KOReader - 1000 x 852](https://github.com/koreader/koreader/assets/202757/8dc5be9f-02a5-44d2-bf4c-df8fdb25de41)

The cover grid is now adjustable, allowing you to display more or fewer book covers at once (koreader#11232).

<kbd><img src=https://github.com/koreader/koreader/assets/62179190/37a2283a-d6ca-4472-a8d4-f50195cf9232 width=49%> <img src=https://github.com/koreader/koreader/assets/62179190/2175db42-8f9b-496c-ab0b-5e27a8daf608 width=49%></kbd>

In more technical news, the CSS pseudoclasses :is(), :where() and :not() are now supported (koreader#11353), as well as a private syntax extension for matching text in user stylesheets (koreader#11323). Also of note is the new HttpInspector plugin, that can be used to inspect KOReader internals while it's running (koreader#11457). This can be useful when the program is running on a device.

Last but not least, the user guide received a big update again by @offset-torque, full details [here](koreader#11147 (comment)).

This month's logo was contributed by @Sonnenfee

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* CoverBrowser: adjustable mosaic grid (koreader#11232) @hius07
* Reader: Do less work on same-orientation non-gyro rotations (koreader#11297) @zwim
* Input: Simplify input slot storage alloc (koreader#11296) @NiLuJe
* Fix missing diacritics on first row of Slovak keyboard layout (koreader#11343) @sonix-github
* OTAManager: Slightly less cryptic error on connectivity issues (koreader#11341) @NiLuJe
* Text selection: add option to disable corner scroll (koreader#11327) @poire-z
* Text selection: show top left icon when very-long-press delay reached (koreader#11327) @poire-z
* bump base: add cre.findAllText(), many 3rd party bumps (koreader#11347) @poire-z
* Fulltext search: all entries in entire document (koreader#11313, koreader#11388) @hius07
* bump crengine: fix CSS cascade, support :is(), other fixes (koreader#11353) @poire-z
* ReaderStatus: Fix some more lifecycle issues in onEndOfBook (koreader#11350) @NiLuJe
* InputDialog: Don't close the VirtualKeyboard when you tap inside a key's *border* (koreader#11350) @NiLuJe
* reMarkable: More robust Wi-Fi scripts (koreader#11287) @gbyl
* Frontlight widget: add left button as close key on hasFewKeys devices (koreader#11376) @a-ignatev
* Virtual keyboard: add Scandinavian layouts (Norwegian, Swedish & Danish) (koreader#11365) @cookiebit
* TextBoxWidget: allow showing bits of text in bold (koreader#11362) @poire-z
* UI: Add a verbose debug logging checkbox next to "Report a bug" (koreader#11366) @NiLuJe
* PRSTux: Disable OTAs, since we actually stopped offering them a few years ago (koreader#11395) @NiLuJe
* Terminal: Clearer error message on prereq failures, and disable it (koreader#11395) @NiLuJe
* Text editor: refresh path on saving file (koreader#11396) @hius07
* CoverBrowser: use bookinfo cache in Classic mode (koreader#11404) @hius07
* PathChooser: fix calling Folder shortcuts (koreader#11367) @hius07
* Clear UI leftovers before doing an OTA-install, add unmovable to InfoMessage and ConfirmBox (koreader#11412) @zwim
* TextViewer: make find result bold (koreader#11427) @hius07
* CoverBrowser: do not call lfs on every item (koreader#11449) @hius07
* [i18n] ReaderSearch: add translation context to "All" button (koreader#11352) @Frenzie
* bump base: libjpeg-turbo, libpng, and other tweaks (fixes some PocketBook devices like PocketBook Basic 613) (koreader#11462) @poire-z @NiLuJe
* HttpInspector: new plugin for developers to inspect KOReader (koreader#11457) @poire-z with thanks to @bneo99
* bump crengine: text selection and footnotes fixes and tweaks (allows for single images in footnotes) (koreader#11468) @poire-z
* Style tweaks: add inpage foootnote classnames and a tweak (koreader#11468) @poire-z
* FileChooser: add new `percent - unopened - 100% or complete` sorting method (koreader#11369, koreader#11472) @hasezoey
* Various pan zoom mode fixes (koreader#11325, koreader#11408, koreader#11425) @hugleo
* Kindle oasis has no ambient brightness sensor (koreader#11456) @Hzj-jie
* Alt status bar: custom metadata support (koreader#11463) @hius07
* VocabBuilder.koplugin: support batch operations in book filtering (koreader#11475) @weijiuqiao
* Wallabag: match `text/html` mimetype as starting with rather than exactly (koreader#11492) @Frenzie
* MenuSearch: open upper menu when needed only (koreader#11495) @hius07

[Full changelog](koreader/koreader@v2024.01...v2024.03) — [closed milestone issues](https://github.com/koreader/koreader/milestone/71?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)

v2024.01

Toggle v2024.01's commit message
KOReader 2024.01 "Snowy Summit"

![koreader-logo-2024-01-fs8](https://github.com/koreader/koreader/assets/202757/6050cfaf-a5d2-429c-af1a-55b9451ccccd)

We wish everyone a happy and prosperous 2024!

Image credit for snowy mountains: Bing Dall-E

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* DocSettings (again) (koreader#11020) @hius07
* [AutoWarmth] Fix sanity checks with disabled schedule entries (koreader#11062) @zwim
* Various improvements by @benoit-pierre (koreader#11069)
* virtualkeyboard: add setting to disable swipes (koreader#11066) @hius07
* menu_keyboard_layout: add setting to disable swipes (koreader#11066) @hius07
* Kindle: The KT5 requires the same input delving shenanigans as the PW5 (koreader#11064) @NiLuJe
* Device: Don't leave hasSeamlessWifiToggle enabled when hasWifiToggle is disabled (koreader#11060) @NiLuJe
* Open with... improvement (koreader#11056) @hius07
* Add new PocketBook InkPad Color 3 (743K3) (koreader#11079) @ElimGarak1
* Profiles: fix updating gestures (koreader#11072) @hius07
* History: search (koreader#11084) @hius07
* Fix connection bug with non-ASCII SSIDs in wpa_supplicant (koreader#11089) @wfdewith
* History: update on deleting a folder (koreader#11090) @hius07
* Page browser: show nightmode thumbnails when in nightmode (koreader#11091) @poire-z
* FileChooser: fix reverse sorting of folders (koreader#11093) @hius07
* InputDialog: tap outside to close dialog if keyboard is hidden (koreader#11094) @hius07
* MoveToArchive: fix DocSettings:updateLocation() call (koreader#11103) @hius07
* Folder shortcuts: new markers, buttons (koreader#11108) @hius07
* ReaderHighlight: adjustable highlight dialog position (koreader#11116) @hius07
* Bump base: some dependencies, minor Makefile fixes (koreader#11127) @NiLuJe @benoit-pierre
* Bump luajit-luancher: support Onyx Nova, warmth support Tolino Vision 4, LuaJIT 20231109 (koreader#11128) @ailin-nemui @hugleo @NiLuJe
* Exporter: add XMNote export (koreader#11087) @Merpyzf
* Exporter: fix XMNote export, add author field (koreader#11134) @ben-29
* UIManager: Don't block gestures for new widgets when input is disabled (koreader#11122) @NiLuJe
* Widgets: Unschedule timeouts on early close (koreader#11126) @NiLuJe
* Dispatcher: Allow toggling USBMS (koreader#11123) @NiLuJe
* Add English to Persian dictionary (koreader#11160, koreader#11165) @Monirzadeh
* Gestures: Make the edge swipe zones configurable (koreader#11158) @NiLuJe
* Kindle: Fix a smattering of frontlight bugs (koreader#11158) @NiLuJe
* ReaderView: Flash when paging *away* from images, too (koreader#11152) @NiLuJe
* QuickMenu: keep open on apply (koreader#11135) @hius07
* Kindle scribe gyro and pen support (koreader#11159, koreader#11285) @mergen3107
* ScreenSaverLock: Hide the popup on suspend (koreader#11174) @NiLuJe
* Profiles: fix update actions in gestures (koreader#11175) @hius07
* bump crengine: various optimizations and fixes (koreader#11191) @poire-z
* ReaderStyleTweak: minor CSS suggestions popup fixes (koreader#11191) @poire-z
* InputText: Delete all and fix Select (koreader#11182) @hius07
* Autocrop fix (koreader#11194) @hugleo
* GestureDetector: Switch buddy contacts to voidState in a safer manner (koreader#11198) @NiLuJe
* Refactor FileManager collation for easier patching  (koreader#11150) @wfdewith
* AppImage: remove hasMultiTouch = no (koreader#11212) @Frenzie
* File browser, Collection: improve group actions (koreader#11178) @hius07
* ImageViewer: menu to invert rotations and set auto rotation (koreader#11206) @poire-z
* TextViewer: add dialog to set font size and justify text (koreader#11210) @hius07
* Terminal Emulator: Fix former_buffer crash (koreader#11230) @mergen3107
* Screenshot: set as book custom cover (koreader#11227) @hius07
* DeviceListener: Rejig calculateGestureDelta algorithm (koreader#11226) @zwim
* Dispatcher: Allow custom intensity/warmth gesture to be setup in gesture distance mode, like the default edge swipe, and not only with a fixed increment (koreader#11226) @NiLuJe
* bump crengine: fix stylesheet possibly not applied (koreader#11239) @poire-z
* History, Collection: title bar in FM style (koreader#11243) @hius07
* Debian package: add X-Purism-FormFactor to koreader.desktop (koreader#11249) @Frenzie
* File manager: fix height of menu widget (koreader#11251) @hius07
* Fix "Open next file" (koreader#11272) @hius07
* Statistics: fix a crash in continuous mode opening statistics page (koreader#11279) @greatyingzi
* Statistics: Also skip hidden flows stuff in continuous mode (koreader#11284) @NiLuJe
* [plugin] Add folder check in move-to-archive (koreader#11262)  @mergen3107
* filemanagerhistory: fix untranslated strings (koreader#11282) @hius07
* [android] toggle warmth on onyx devices (koreader#11275) @mergen3107
* Add viewport for PB743K3 (koreader#11302) @SilverGreen93
* Fix "Move current book to archive" (koreader#11321) @liskin
* Exporter: memos, replace space with underscore for # tag creation (koreader#11107) @Ibesnard

[Full changelog](koreader/koreader@v2023.10...v2024.01) — [closed milestone issues](https://github.com/koreader/koreader/milestone/69?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)

v2023.10

Toggle v2023.10's commit message
KOReaver 2023.10 "Ovis"

![koreader-2023-10-sheep](https://github.com/koreader/koreader/assets/202757/c76bd295-5185-4e2e-b6cb-db0e8c0e8762)

Image credit: [Bing Image Creator (Dall-E 3)](https://www.bing.com/images/create/a-simplistic-vector-image-of-a-sheep/653e6e4e71dd442f8642cd4ce2420f66?id=kl6qDqFKwGMPxyNv%2boj1qw%3d%3d&view=detailv2&idpp=genimg&FORM=GCRIDP&mode=overlay)

The user guide has had a big update. Included below is the full release announcement.

This is the biggest ever update to the guide. 2 years ago I started with the intention to make a simple how-to guide. With this release, user guide reached **60** A4 pages ! KOReader might be the best documented reader app now :)

Our guide is now a HTML document:
[https://koreader.rocks/user_guide/](https://koreader.rocks/user_guide/)

It was very tedious to recreate the PDF as a web page (especially considering that I had to learn CSS to do it).
But there are many benefits like:
	- More frequent and real-time updates
	- Better compatibility for smaller devices
	- Ability to directly link to it in issues and discussions
	- Possibility to be packed as an EPUB
	- PDF sucks

Also I recently noticed that our color palette in the guide was not suitable for **color blind** people. Some important items were indistinguishable for color blind users so I updated the colors to provide nice contrast for them too. Also added icons and visual aids to make the text more accessible.

---

**GUIDE CHANGES:**
- Recreated the guide in HTML
- Updated the colors, fonts and styles to accomodate **color blind** users
- Optimized all the images to make them as small as possible without degradation (Achieved ~50% reduction in size)

**MAJOR CHANGES:**
- **Fonts** has its own section now
- **Quick Menu and Profiles** has its own section now
- Expanded **Plugins** section to include **contrib** and **external** plugins
- Rewritten **Highlighting, Bookmarks and Notes** section
	- "Highlight icon" in the File Browser
	- Bookmarks: filter by highlight style
	- Multiple highlights and notes
- Expanded **Export** section
	 - Export multiple files
	 - Export to **clippings** format
	 - Export to **memos** format
	 - See and choose export folder
- Added **Keyboard shortcuts** section for non-touch devices and Linux
- Added full list of actions that is available in **Gesture Manager**

**ADDED INFO ABOUT:**
- Partial rendering
- Translate current page
- Scrolling modes
- Creating a profile with current document settings
- Open with: **Archive viewer**
- Open with: **Image viewer**
- Patch manager
- Menu search
- Location history
- Setting to turn off flashing on pages with images
- Ability to change statistics calculation time
- Clearing PDF cache
- Switching the style to HTML5 to fix some problems
- Toggle status bar via gestures or **Quick Menu**
- Scrollable **Quick Menu**
- "Move to archive" availability in Gesture Manager
- Custom book cover setting
- Using "Exit screensaver" gesture as a pseudo lock screen
- Tap on time to show date
- Verbose logs procedure in **How to report problems** section

**UPDATED IMAGES:**
- File Browser
- Skim widget
- Book map menu

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* NetworkManager: Decode SSID to UTF-8 (koreader#10864) @NiLuJe
* bump crengine: revamp CSS 'inherit' handling, other fixes (koreader#10865) @poire-z
* Custom metadata (koreader#10861, koreader#10869, koreader#10889, koreader#10894, koreader#10919) @hius07
* Device: Try harder to properly setup the charging LED on plug/unplug (koreader#10855) @NiLuJe
* VirtualKeyboard: Revamp visibility handling (koreader#10852) @NiLuJe
* PDF contrast: incorrect set by a gesture (koreader#10798) @hius07
* copt deduplicate: smooth_scaling, nightmode_images (koreader#10801) @hius07
* Exporter: custom metadata (koreader#10874) @hius07
* Reset settings/cover/metadata separately (koreader#10866) @hius07
* Various code optimizations @hius07
  * copt deduplicate: embedded_css, embedded_fonts (koreader#10876)
  * copt deduplicate: line_spacing (koreader#10768)
  * copt deduplicate: render_dpi, margins, rotation_mode (koreader#10880)
  * copt deduplicate: font_size, visible_pages (koreader#10882)
  * copt deduplicate: font settings (koreader#10885)
  * copt/kopt options: deduplicate some defaults (koreader#10893)
  * screen_rotation_menu_table: deduplicate (koreader#10954)
  * md5: centralize and deduplicate (koreader#11003)
* [doc] Building: add libtool-bin to Debian/Ubuntu prerequisites as a workaround for ancient libzmq (koreader#10897) @Frenzie
* Actions for Go to first/last bookmark (koreader#10899) @hius07
* Check for Noto Emoji font in UI fallback fonts (koreader#10908) @wfdewith
* Device: Make sure `input_no_key_repeat` survives a suspend/resume cycle (koreader#10904) @NiLuJe
* TextViewer: font size (koreader#10911) @hius07
* Add Onyx Poke5 support (koreader#10917) @hugleo
* NetworkMgr: Handle non-blocking turnOnWifi implementations better (koreader#10863) @NiLuJe
* Revert "Kobo: Disable HW inversion on MTK (koreader#10841)" (koreader#10928) @NiLuJe
* screensaver_menu: radio buttons (koreader#10931) @hius07
* ReaderRolling: Guard against races between scheduled tasks and CloseDocument (koreader#10934) @NiLuJe
* TimeSync: Probe for root & ntpd/ntpdate dynamically (koreader#10935) @NiLuJe
* tests: tag tests relying on a working internet access (koreader#10939) @benoit-pierre
* [PocketBook] Add PB-Verse_(PB629) and PB-Verse Pro_(PB634) (koreader#10938) @ElimGarak1
* sdl: ensure dialogs are displayed after window change events (koreader#10929) @hrdl-github
* Status: setting status of current book in History and Collections (koreader#10946) @hius07
* [plugin] CoverBrowser: improve title & authors layout (koreader#10942) @benoit-pierre
* Coverbrowser: event for cache refreshing (koreader#10956) @hius07
* readerhighlight: fix OCRed text dictionary lookups (koreader#10967) @benoit-pierre
* New menu option and filemanager filter to hide finished books koreader#7158 (koreader#10895) @mytskine
* Kobo: Deal with some more frontlight edge cases on devices with the AW99703 PWM controller (koreader#10971) @NiLuJe
*  ReaderHandmade: support for custom TOC and hidden flows. BookMap and PageBrowser tweaks (koreader#10982) @poire-z
* Finished books: freeze history timestamp and statistics (koreader#10968, koreader#10968) @hius07
* Add hash-based document metadata storage option (koreader#10945) @ryanwwest
* File search, FileChooser and others (koreader#10994) @hius07
* otamanager: fix OTA model name for Android x86_64 (koreader#10997) @benoit-pierre
* util.htmlEntitiesToUtf8: add some more semi common entities (koreader#10979) @yparitcher
* Minor code quality improvements (koreader#10905) @mytskine
* Add new PocketBook PB-Basic Lux 4 (PB618) (koreader#10987)
* Exporter: fix memos export, add flomo export (koreader#10988)
* Device:Android: always call "_decideFrontlightState" in "setIntensityHW" (koreader#10737)
* History: update on renaming/moving a folder (koreader#10999)
* WakeupMgr: Forward rtc_dev & dodgy_rtc to the backend (koreader#11010) @NiLuJe
* UIManager: Always send PowerOff & Reboot events (koreader#11010) @NiLuJe
* Reader: re-enable File search, Folder shortcuts (koreader#11028) @hius07
* webdav: do not allow trailing slash in start folder (koreader#11026) @hius07
* Kindle: Initial Scribe support (koreader#11047) @NiLuJe
* Kindle: Handle the PW5 SE properly (koreader#11049, koreader#11051, koreader#11052) @NiLuJe

[Full changelog](koreader/koreader@v2023.08...v2023.10) — [closed milestone issues](https://github.com/koreader/koreader/milestone/68?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)

v2023.08

Toggle v2023.08's commit message
KOReader 2023.08 "Lavender"

v2023.06.1

Toggle v2023.06.1's commit message
KOReader 2023.06.1

The main purpose of this point release is to add a notification on Android devices that will no longer be supported if they use the built-in update functionality (koreader#10639).

This will be the final release to support **Android 4.0 – Android 4.2**, after which support for those versions will be **removed**. The new minimum supported version will be Jelly Bean MR2 (API18/Android 4.3). For more information see koreader#10614.

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* Input: Be more through in resetState (koreader#10612) @NiLuJe
* Disabled touch input: always active gestures (koreader#10624) @hius07
* libk2pdfopt, fix ffi cdecls, improved ccache (koreader#10638) @benoit-pierre
* QuickMenu: anchor to gesture position (koreader#10636, koreader#10646)  @yparitcher @hius07
* Text search: normalize input text (koreader#10637) @poire-z
* Text search: various Kopt search fixes (koreader#10637) @poire-z
* Remarkable: support the mainline touchscreen (koreader#10585) @alistair23
* Decrease fonts memory use (koreader#10618) @benoit-pierre
* [ota]: deprecation check & notice (koreader#10639) @pazos

[Full changelog](koreader/koreader@v2023.06...v2023.06.1) — [closed milestone issues](https://github.com/koreader/koreader/milestone/69?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)

v2023.06

Toggle v2023.06's commit message
KOReader 2023.06 "Hydrangea"

Hydrangea seems to be the common English name for what I know as the hortensia. They're quite pretty this month, bumblebees buzzing all around.

This will be the final release to support **Android 4.0 – Android 4.2**, after which support for those versions will be **removed**. The new minimum supported version will be Jelly Bean MR2 (API18/Android 4.3). For more information see koreader#10614.

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* Profiles: disable inapplicable actions in QuickMenu (koreader#10500) @hius07
* MoveToArchive register to Dispatcher (koreader#10524) @hius07
* QuickMenu: scrollable (koreader#10528) @hius07
* PageBrowser: smaller margins if no thumbnail page numbers
* BookMap improvements (koreader#10530, koreader#10544) @poire-z
  * nicer alignment of the vertical page number
  * add option "Page browser on tap"
  * add option "10-page markers"
  * add "Overview" mode
  * fix help text wording
* bump base: expose the kindle mxcfb temperature constants (koreader#10548) @yparitcher
* File popup dialog buttons (koreader#10537) @hius07
* Bookmarks: filter by highlight style (koreader#10549) @hius07
* bump crengine: minor NCX ToC and createXPointer(pt) fixes (koreader#10554) @poire-z
* CoverImage: custom cover support (koreader#10553) @hius07
* [plugin] AutoWarmth: fix resume and frontlight issue, fix nightmode issue on non natural light devices (koreader#10556,  koreader#10557, koreader#10570) @zwim
* OPDS: view book cover (koreader#10555) @hius07
* kindle: show require error trace (koreader#10569) @benoit-pierre
* Open with: images (koreader#10561) @hius07
* persist: fix possible leak on error (koreader#10568) @benoit-pierre
* credocument: epub alternative mimetype (koreader#10575) @hius07
* Overlap: fix detecting reflow mode (koreader#10576) @hius07
* PocketBook: add alternative definition for PB840 (koreader#10582) @Frenzie
* Archive viewer (koreader#10584) @hius07
* History: shorten date/time field (koreader#10594) @hius07
* History: update short date/time correctly (koreader#10601) @hius07
* PowerD: Unbreak frontlight toggle notifications outside of Kobo (koreader#10597) @NiLuJe
* SDL: Fix initial position & size (koreader#10619) @NiLuJe

[Full changelog](koreader/koreader@v2023.05.1...v2023.06) — [closed milestone issues](https://github.com/koreader/koreader/milestone/65?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)

v2023.05

Toggle v2023.05's commit message
KOReader 2023.05 "Azalea"

![koreader-2023-05-azalea](https://github.com/koreader/koreader/assets/202757/a64eb64f-504a-44b3-9317-4aa50aa5ade8)

This is neat. The FSF published an interview with me about KOReader. You can read it [here](https://www.fsf.org/blogs/licensing/frans-de-jonge-tells-us-about-koreader-in-this-agplv3-interview).

Like any human I'm a bag of contradictions. I often studiously upload the correct cover to LibraryThing, yet in KOReader I'm perfectly satisfied with auto-generated covers if the metadata doesn't specify any. But if you're not, and you don't want to edit the file itself, you can now set custom covers right within KOReader (koreader#10329). A custom cover can be added or removed in the program through the book information page, or you can put a cover image in the .sdr folder manually.

Of course there are many other improvements. Enjoy!

Image credit: adapted from [Bilder ur Nordens flora](https://commons.wikimedia.org/wiki/File:150_Rhododendron_lapponicum.jpg)./wiki/File:150_Rhododendron_lapponicum.jpg

We'd like to thank all contributors for their efforts. Some highlights since the previous release include:

* KeyValuePage: fix corner-case alignment bug (koreader#10326) @weijiuqiao
* Exporter plugin:
  * Feature: Export to kindle's myClippings (koreader#10263) @Mochitto
  * Fix: exporting all notes and single doc now both use metadata for author and title (koreader#10280) @Mochitto
  * Fix crash exporting to Markdown with missing authors (koreader#10278) @Mochitto
* [fix] Reintroduce "Start with" default to prevent nil string on startup (koreader#10369) @Frenzie
* Dispatcher: add "Save book metadata" (koreader#10370) @poire-z
* PageBrowser: show page number alongside thumbnails (koreader#10370) @poire-z
* Fix some screen refresh effects on Kobo Sage (koreader#10306) @zwim
* Kobo: Refactor frontlight toggle ramp behavior (koreader#10305) @zwim
* koptoptions: fix default margin (koreader#10376) @hius07
* ReaderFooter: separate ToggleFooterMode from TapFooter (koreader#10361) @yparitcher
* ConfirmBox: add widgets (koreader#10364) @hius07
* kindle voyage: no framework: whispertouch button activation (koreader#10290) @doremiyeon
* Add Esperanto–English dictionary (koreader#10297) @jmthackett
* Custom book covers (koreader#10329) @hius07
* Kindle: toggle cover events (koreader#10363) @yparitcher
* DataStorage: create parent config home if it doesn't exist yet, this allows for starting the program in a fresh WSL (koreader#10382, koreader#10390) @Frenzie
* Statistics: fix ReaderProgress bad layout in RTL UI (koreader#10389) @poire-z
* Dispatcher: add `addCurrentLocationToStack` (koreader#10387) @yparitcher
* FileChooser: fix percent sorting (koreader#10393) @hius07
* crengine: BiDi, floats, and FB2 cover related fixes (koreader#10398) @poire-z
* Page overlap: add "Horizontal line" marker (koreader#10401) @hius07
* Exporter: correct access to doc settings (koreader#10407) @hius07
* bump base/LunaSVG: minor upstream fixes (koreader#10412) @poire-z
* SDL: use render buffer size instead of window size (koreader#10428) @hrdl-github
* ButtonDialog, ScrollableContainer: add support for step/grid scrolling (koreader#10424) @poire-z
* DictQuickLookup: add button to show list of results (koreader#10424) @poire-z
* OTM: Attempt to deal with wonky config states (koreader#10429) @NiLuJe
* Bump base (koreader#10434) @NiLuJe
  * Respect output scaling on wayland (koreader/koreader-base#1610) @hrdl-github
* mac: github actions macos-13 (koreader#10404) @yparitcher
* Fix cutout on android 13 (koreader#10439) @yparitcher
* Translator: translate current page (koreader#10438) @hius07
* [plugin] Exporter: add memos export (koreader#10411) @fierceX
* Bump base (koreader#10458) @Frenzie
  * ffi/koptcontext: fix language handling (koreader/koreader-base#1613) @benoit-pierre
  * Return size of PDF page document (koreader/koreader-base#1612) @hrdl-github
* pdfdocument: cache page text (koreader#10450) @hrdl-github
* [plugin] Exporter: choose folder (koreader#10448) @hius07
* Exporter: selected files (koreader#10453) @hius07
* PM: Minor refactor to suspend/resume code flow (koreader#10426) @NiLuJe
  [Ed. Minor doesn't quite seem to be the appropriate word.]
* Wikipedia EPUBs: strip out invalid-XHTML <link> (koreader#10462) @poire-z
* PB: Add Inkpad 4 (koreader#10468, koreader#10481) @roshavagarga, @ElimGarak1
* rM: Work around LD_PRELOAD weirdness on forks on rM 2 (koreader#10490) @TheLastZombie
* ReaderHighlight: manage overlapped highlights (koreader#10492) @hius07
* [plugin] Statistics: sync the last_open field (koreader#10498) @snelg

[Full changelog](koreader/koreader@v2023.04...v2023.05) — [closed milestone issues](https://github.com/koreader/koreader/milestone/64?closed=1)

---

Installation instructions: [Android](https://github.com/koreader/koreader/wiki/Installation-on-Android-devices) • [Cervantes](https://github.com/koreader/koreader/wiki/Installation-on-BQ-devices) • [ChromeOS](https://github.com/koreader/koreader/wiki/Installation-on-Chromebook-devices) • [Kindle](https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices) • [Kobo](https://github.com/koreader/koreader/wiki/Installation-on-Kobo-devices) • [PocketBook](https://github.com/koreader/koreader/wiki/Installation-on-PocketBook-devices) • [ReMarkable](https://github.com/koreader/koreader/wiki/Installation-on-ReMarkable) • [Desktop Linux](https://github.com/koreader/koreader/wiki/Installation-on-desktop-linux) • [MacOS](https://github.com/koreader/koreader/wiki/Installation-on-MacOS)