A KOReader plugin for taking regular breaks.
This plugin is based on the built-in KOReader read timer plugin. It starts automatically, and allows the user to set a break interval and length. During the break, a message box overlays the screen. There is no way to dismiss the break until the break time has elapsed. I should add an option to allow dismissing the break timer or not. Follow the instructions here to install the plugin to an instance of KOReader on a Kobo reader.
-
Clone this project’s repository.
git clone https://github.com/jwillikers/koreader-break-timer.git
-
Change into the project directory.
cd koreader-break-timer -
Plug in the Kobo reader and mount its filesystem.
-
Copy the plugin directory to the KOReader plugins directory.
mkdir /run/media/$(id --name --user)/KOBOeReader/.adds/koreader/plugins/breaktimer.koplugin cp --recursive breaktimer.koplugin/* /run/media/$(id --name --user)/KOBOeReader/.adds/koreader/plugins/breaktimer.koplugin/
-
Now unmount the Kobo reader’s filesystem.
-
Reboot the Kobo reader.
❗Any changes to the plugin seem to require a reboot to take effect.
Contributions in the form of issues, feedback, and even pull requests are welcome. Make sure to adhere to the project’s Code of Conduct.
Refer to the project’s Code of Conduct for details.
This repository is licensed under the MIT license.
© 2025 Jordan Williams