List of events/actions for programmatic keybindings

milky30 · 12-29-2025, 10:44 PM

Hey lovely people

I'm a first time user of KOReader and just installed it on Linux. After a quick look around, it seems it has extensive support for keyboard shortcuts. So I'd like to take advantage of that and create a keyboard-driven workflow, especially since I'm on Linux, rather than a tablet. But after a quick skim through the user guide and wiki, I couldn't find a list of the possible actions (and their description) which can be assigned a hotkey.

According to this wiki page, it says that in the configuration file `event_map.lua`, "an integer key is associated to an event". I'm assuming here "event" is synonymous with action. The same page also mentions that configuration "is limited to associating predefined actions with each button." However, the page doesn't say where to find the complete list of predefined actions.

Separately, this section in the user guide mentions there are 200+ actions which "allows you to control every aspect of KOReader". However, the actions are listed in plain english, not in the format required by the `event_map.lua` file (the wiki page examples shows the action names look like "RPgBack", "Down", etc).

So if anyone could help me find the correct names for actions that I can use in `event_map.lua` for keyboard bindings, I'd be very grateful.

Many thanks in advance!

Ebookus · 01-12-2026, 10:11 AM

https://koreader.rocks/user_guide/#L2-keyboardshortcuts

milky30 · 01-23-2026, 11:19 PM

Bumping this

In case it wasn't clear, I'm looking for a programmatic way to do this. Usually this means editing a config file (my guess is event_map.lua, as I mentioned in the first post). The UI is not practical in my case, because there are too many keybdings I need to create.

milky30 · 01-25-2026, 05:43 AM

The HTTP Inspector plugin seems to provide a complete list of available "actions". My original problem (comprehensive control of koreader using keyboard) is currently being discussed on github. A couple of observations:

- the HTTP Inspector plugin can trigger each of the available 200+ actions over a remote HTTP connection to the app
- event_map.lua is actually for remapping keycodes to different keysyms

12-29-2025, 10:44 PM	#1
milky30 Junior Member Posts: 7 Karma: 10 Join Date: Dec 2025 Device: linux	List of events/actions for programmatic keybindings Hey lovely people I'm a first time user of KOReader and just installed it on Linux. After a quick look around, it seems it has extensive support for keyboard shortcuts. So I'd like to take advantage of that and create a keyboard-driven workflow, especially since I'm on Linux, rather than a tablet. But after a quick skim through the user guide and wiki, I couldn't find a list of the possible actions (and their description) which can be assigned a hotkey. According to this wiki page, it says that in the configuration file `event_map.lua`, "an integer key is associated to an event". I'm assuming here "event" is synonymous with action. The same page also mentions that configuration "is limited to associating predefined actions with each button." However, the page doesn't say where to find the complete list of predefined actions. Separately, this section in the user guide mentions there are 200+ actions which "allows you to control every aspect of KOReader". However, the actions are listed in plain english, not in the format required by the `event_map.lua` file (the wiki page examples shows the action names look like "RPgBack", "Down", etc). So if anyone could help me find the correct names for actions that I can use in `event_map.lua` for keyboard bindings, I'd be very grateful. Many thanks in advance!

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Can't get keybindings to work	codexveritas	KOReader	3	12-05-2024 09:01 PM
Programmatic dictionary access?	pete330	Kindle Developer's Corner	3	06-08-2017 03:47 PM
[Dev] Comprehensive list of system events	Aeris	Kindle Developer's Corner	4	01-15-2014 11:22 AM
Actions Interface	amfera	Library Management	2	05-04-2012 10:05 AM

01-12-2026, 10:11 AM	#2
Ebookus Digital Grenadier Posts: 225 Karma: 2500000 Join Date: Jan 2024 Device: Kindle	https://koreader.rocks/user_guide/#L2-keyboardshortcuts

01-23-2026, 11:19 PM	#3
milky30 Junior Member Posts: 7 Karma: 10 Join Date: Dec 2025 Device: linux	Bumping this In case it wasn't clear, I'm looking for a programmatic way to do this. Usually this means editing a config file (my guess is event_map.lua, as I mentioned in the first post). The UI is not practical in my case, because there are too many keybdings I need to create.

01-25-2026, 05:43 AM	#4
milky30 Junior Member Posts: 7 Karma: 10 Join Date: Dec 2025 Device: linux	The HTTP Inspector plugin seems to provide a complete list of available "actions". My original problem (comprehensive control of koreader using keyboard) is currently being discussed on github. A couple of observations: - the HTTP Inspector plugin can trigger each of the available 200+ actions over a remote HTTP connection to the app - event_map.lua is actually for remapping keycodes to different keysyms

Advert