Minor fixes & performance

Minor update with a fix for transparent wallpaper support. Also, I've added an option to disable the button feedback (flash on tap) for a slight input performance gain. This way it doesn't need to be disabled system-wide.

All essential features for myself are complete now, and based on the lack of reported issues, I'd say we reached a stable state. Thus, the update releases will probably continue to slow down 🤞

Enjoy 📚

2026.01 – Stable New Year

A couple of stability and a bunch of user experience improvements.

Notably, a new "Lock" menu item for those who prefer to lock by hand.
Also, the desktop support has improved a lot: global lock shortcuts Ctrl+Alt+L and Alt+Shift+L, as well as proper keyboard PIN input on the lock screen.

Have a great 2026, folks 🎇💫

2025.12-1 – It's time!

This small update just adds some status information (time, battery, frontlight) to the bottom of the panel. It also includes a render fix after device deep sleep.

Merry Christmas 🎄 and a happy new year! 🚀

2025-12 – Auto updates

If everything works out, this should be the last update that you have to do by hand. From now on, the built-in updater will check "in the background" according to configured intervals (by default up to once a week) if any new updates are available. They'll patch themselves as well (with lots of safety guards) 🤞

In addition, this update includes improvements (esp. for desktop users) and fixes.

Merry Christmas 🎄

2025.11-1 –­ See the light!

The major addition in this release is the (basic) frontlight control. Just tap anywhere but the lock screen to increase (top half) or decrease (bottom half) the screen brightness. An essential enhancement if you find yourself trying to unlock the device in the night after you've locked during in the day 😅

In addition, I completed a couple of minor issues and introduced a new public API. May it spawn some interesting extension plugins…

Enjoy! 🚀

2025.11 – Travel edition & one-handed unlocking

The lock screen becomes even more customizable. With the new panel position controls, it can be put to the side for single-handed unlocking. I, myself, put it on the right edge close to the bottom with a small size. Feels way easier now ✨

Also, as I'm going to travel soon, I just had to add customizable notes to the lock screen. A tiny insurance for when the device might get lost 🤞

Have fun!

---

Changed

• The lock screen panel size factor is slightly changed, to allow for even
  smaller panels.

Added

• #5
  The lock screen panel position is configurable.
• #14
  Notes can be written to provide on the lock screen without PIN. E.g.,
  emergency or contact information.

2025.10-3 – Major UI updates & more…

The UI has received a lot of work since the last release. Instead of the plain
white screen, you'll now see a panel on top of your configured wallpaper. Its
size can be configured, more configurations are to follow in the upcoming weeks.

Also, we now allow for 3–12 digit PINs. Choose yourself how serious you want to
take this whole lock screen thing 😅

Stay tuned! 🚀 And enjoy Halloween 👻

Changes

Security

• Use a full display refresh on unlock to prevent bleeding information on
  pressed buttons.
• Redact change pin values from logs, just in case they're somehow readable w/o
  device access. Probably not a real security issue, but let's err on the safe
  side.

Changed

• PIN change uses Notification instead of InfoMessage. The notification is
  less obtrusive, at the top of the screen.
• Allow 3–12 digits for PINs.

Added

• #3
  The lock screen draws on top of the builtin wallpaper. The white background is
  gone.
• #5
  The lock screen panel size can be configured.

2025.10-2 – Rate limiter and stability

Yet another release with a big new feature, shortly after the last one 😅

Adding a rate limiter is the last security feature on my todo list. I'm happy to find it's working just fine, despite the dynamic PIN length allowed. I've hidden an option to turn it off in the settings, not available via UI; just in case someone knows what they're doing.

Have fun! 🎉

---

Changes

Changed

• Improved the menu item texts to feel consistent with KOReader menus.

Added

• #6 Rate Limit for PIN input. Lock for 10/30/60/60/... seconds after the 4th failed attempt of any PIN length. All counters are reset after 5 minutes since the last rate limit was triggered. If you want/need to disable this feature, change the screenlockpin_ratelimit setting in your settings.reader.lua (koreader directory) by hand. It's not provided as an option in the UI.

Fixed

• Reset PIN input state on re-awake after sleep.
• #7 Lock Screen rotation for unlocked device orientation.

2025.10-1 – Lock on boot and more…

🚀 I'm happy to push this new release 🎉

With the new lock-on-boot feature, it achieves something that—to my knowledge—no other PIN lock screen plugin does. The new menu position, options, and fixed double-tap sluggishness vastly polish this plugin up.

Please star the repository if you enjoy my work ✨

---

Changes

Changed

• Moved the menu item into Screen submenu, with submenu for further options.

Added

• Toggle-Options to lock on boot #1 and / or wakeup; both are disabled by default.
  Lock on Wakeup will be enabled when migrating from an earlier plugin version.
• Restore the previously set lockscreen delay option when disabling lock on
  wakeup or the plugin altogether.
• Cleanup procedure when disabling the plugin (only once per session).

Fixed

• Disabled double tap on our widget and dialog. This solves the perceived
  sluggish input #2 when locking from an open book if double tap is enabled on
  the device.

Removed

• The Change PIN dialog is no longer movable; it should perform better, though.

2025.10 – Initial Release

Initial Release 🚀 Enjoy!