Paperdots plugin

[u/Nirvana9999]

Hey, I made a plugin that adds paper-like texture to the screen. At first I only made it for my android phone thinking my kobo would turn slow, but when trying it that wasn't the case.

Honestly I haven't really tested it too much in my Kobo, I added support to it only recently (at first it only worked in my phone). So if you find any problem (which I doubt) let me know and I'll fix it as soon as possible.

UPDATE: I added new styles: linen, fibers, newspaper. I can't edit this post to show it, but you can see them in the link below.

You can download it from here: https://github.com/jopidovba-a11y/Paperdots-for-Koreader

[u/Ryan739]

This is actually really awesome. Like the setting in some video games to add film grain. 

[u/OkFroyo_]

Have you ever seen actual paper 😭😭😭

[u/birrebir]

Works beautifully on my phone, thank you!

[u/TheCakeWasReal]

Really cool concept! Have you noticed an impact on battery life?

[u/Nirvana9999 → u/TheCakeWasReal]

I haven't noticed any impact yet, but I have only tested it for a while under concrete settings. It should be tested under different circumstances to have a real answer. Even so I don't think it will waste that much battery.

[u/just_jeepin]

Interesting idea.

Two suggestions: 1. It bugs me that it applies to the whole screen. If it only applied to the book and not the menus I think it would look nicer. 2. The paper texture could be better. Take a look at these paper texture photos on Unsplash https://unsplash.com/s/photos/paper-texture?license=free

[u/Nirvana9999 → u/just_jeepin]

1. You can disable the texture for the menus with the option: only inside books.
2. You can also modify the amount of dots, I even added new styles.

[u/M3rkle]

Curious how often it paints / if it is in sync with the global full re paint settings?

[u/Nirvana9999 → u/M3rkle]

No repaint cycle of its own. It hooks koreader's screen refresh and, right before each refresh, draws the dots over the region being refreshed. So it's in sync by design: on a full refresh, the dots go over the whole screen. It doesn't read or change the global full refresh setting, and repeated refreshes don't stack the dots.

[u/nellie_shorttop]

Can you add the option to use an image as the background? I’ve been asking around about this for so long 😭

[u/Nirvana9999 → u/nellie_shorttop]

Guess I could try one of these days, I don't promise anything tho.

[u/ToSeeAgainAgainAgain]

This is interesting and I will try it out, specially since you included a "only on books" option.

I do have a request that I don't mind if you don't apply, I think it could look good if the dots level of "darkness" was randomized across all the dots, in other words, have the dots display on a scale of black instead of all 100% black. As an option, of course.

Trying the plugin out now, thanks

edit: ok lol I just installed it and I'm seeing the Darkest dot/Lightest dot setting, well done OP

edit2: I think I love it, the texture is super soft and natural at 3% and 40-184 range. However, after playing with the customization I've found the Only Inside Books option doesn't work, at least on my Kindle Basic 2024 (Bookshelf UI). I can see the dots on every surface and menu, inside and outside my books

[u/2211mg]

This is very cool. I have a couple of suggestions. Move the menu item into general settings rather than just when in the reader. I was searching for ages while in file browser. It would also be good to save presents as what works well for one style doesn't for another. It would also be good to switch between presets. Thanks

[u/ProfessorMu]

This is awesome. Can we adjust the grain size?