[Enhancement]: Keep screen on when reading a ebook #967

Closed
opened 2026-04-24 23:44:27 +02:00 by adam · 8 comments
Owner

Originally created by @samkottler on GitHub (May 18, 2024).

Describe the Feature/Enhancement

Currently, if the screen lock timeout goes off before I’ve finished reading a “page” my phone/ipad will lock the screen. This requires me to touch the screen periodically to prevent this. It’d be nice if the app automatically prevented screen locking while in the in ebook reader.

Why would this be helpful?

It often takes me longer to read a “page” than the screen lock timeout on my phone/ipad. Keeping the screen on when reading an ebook would prevent this.

Future Implementation (Screenshot)

image

Audiobookshelf App Version

Android App - 0.9.63, iOS App - 0.9.63

Current Implementation (Screenshot)

No response

Originally created by @samkottler on GitHub (May 18, 2024). ### Describe the Feature/Enhancement Currently, if the screen lock timeout goes off before I’ve finished reading a “page” my phone/ipad will lock the screen. This requires me to touch the screen periodically to prevent this. It’d be nice if the app automatically prevented screen locking while in the in ebook reader. ### Why would this be helpful? It often takes me longer to read a “page” than the screen lock timeout on my phone/ipad. Keeping the screen on when reading an ebook would prevent this. ### Future Implementation (Screenshot) <img width="744" alt="image" src="https://github.com/advplyr/audiobookshelf-app/assets/8450431/a3687175-b3b5-46c8-b124-f778533b028b"> ### Audiobookshelf App Version Android App - 0.9.63, iOS App - 0.9.63 ### Current Implementation (Screenshot) _No response_
adam added the enhancement label 2026-04-24 23:44:27 +02:00
adam closed this issue 2026-04-24 23:44:28 +02:00
Author
Owner

@advplyr commented on GitHub (May 18, 2024):

This might be better handled by adjusting the screen timeout on the device. I could see adding this feature causing more unexpected permission related issues. What is your screen timeout currently set at? I keep mine at 5 minutes.

@advplyr commented on GitHub (May 18, 2024): This might be better handled by adjusting the screen timeout on the device. I could see adding this feature causing more unexpected permission related issues. What is your screen timeout currently set at? I keep mine at 5 minutes.
Author
Owner

@samkottler commented on GitHub (May 18, 2024):

1 minute on my phone and 5 minutes on my iPad. I don’t really want to just adjust the timeout device wide because in every other situation those are the timeouts I want.

I’m not sure about how permissions work, but wouldn’t the app just ask for whatever permission it needs when a user toggles setting? I know other apps are able to prevent screen locking while they’re open.

@samkottler commented on GitHub (May 18, 2024): 1 minute on my phone and 5 minutes on my iPad. I don’t really want to just adjust the timeout device wide because in every other situation those are the timeouts I want. I’m not sure about how permissions work, but wouldn’t the app just ask for whatever permission it needs when a user toggles setting? I know other apps are able to prevent screen locking while they’re open.
Author
Owner

@samkottler commented on GitHub (May 18, 2024):

It looks like on android at least no permission is required to keep the screen on. I’m not sure about iOS.

@samkottler commented on GitHub (May 18, 2024): It looks like on android at least no permission is required to keep the screen on. I’m not sure about iOS.
Author
Owner

@citizenxnz commented on GitHub (May 25, 2024):

I was going to raise the same issue - in any other reader I've used the screen timeout is disabled (it's often a preference flag) - would like to see the same here. Having to remember to push the screen halfway through a page is annoying.

Like @samkottler I don't wish to manually adjust my system systems each time - that is not effortless UX

@citizenxnz commented on GitHub (May 25, 2024): I was going to raise the same issue - in any other reader I've used the screen timeout is disabled (it's often a preference flag) - would like to see the same here. Having to remember to push the screen halfway through a page is annoying. Like @samkottler I don't wish to manually adjust my system systems each time - that is not effortless UX
Author
Owner

@advplyr commented on GitHub (May 25, 2024):

@citizenxnz Can you share some mobile apps that have this setting so I can check them out?
The Kindle app on Android doesn't have this setting as far as I can find

@advplyr commented on GitHub (May 25, 2024): @citizenxnz Can you share some mobile apps that have this setting so I can check them out? The Kindle app on Android doesn't have this setting as far as I can find
Author
Owner

@samkottler commented on GitHub (May 26, 2024):

The Libby app on android doesn’t allow it to be configured, but does keep the screen on while in the ebook reader.

@samkottler commented on GitHub (May 26, 2024): The Libby app on android doesn’t allow it to be configured, but does keep the screen on while in the ebook reader.
Author
Owner

@paulo-erichsen commented on GitHub (Jun 27, 2024):

I'm not an android developer, but hopefully some of these links will help

I've also noticed that Moon+ Reader Pro automatically keeps the screen awake when I read ebooks without the need to change any settings which would be a nice UX to see on the Audiobookshelf app. IMO ABS app should automatically enable this for ebooks, but I don't think audiobooks would benefit from this.

Perhaps the change needs to be done somewhere in components/readers or in whatever page that opens the reader?

@paulo-erichsen commented on GitHub (Jun 27, 2024): I'm not an android developer, but hopefully some of these links will help - https://stackoverflow.com/questions/3723634/how-do-i-prevent-an-android-device-from-going-to-sleep-programmatically - https://developer.mozilla.org/en-US/docs/Web/API/WakeLock - https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API - https://developer.chrome.com/docs/capabilities/web-apis/wake-lock - https://github.com/mealie-recipes/mealie/blob/f1b53483da50ca73e16314998c501d8707f54ecb/frontend/components/Domain/Recipe/RecipePage/RecipePage.vue#L197-L229 -> mealie is a webapp and does it automatically when a recipe is opened (it also doesn't require configuration - it just happens automatically which is nice) - https://github.com/mealie-recipes/mealie/pull/1006/files ^ pull request from the above change - https://vueuse.org/core/useWakeLock/ I've also noticed that Moon+ Reader Pro automatically keeps the screen awake when I read ebooks without the need to change any settings which would be a nice UX to see on the Audiobookshelf app. IMO ABS app should automatically enable this for ebooks, but I don't think audiobooks would benefit from this. Perhaps the change needs to be done somewhere in [components/readers](https://github.com/advplyr/audiobookshelf-app/tree/c349a0bf00b4839b7f14d279056d202323c324f2/components/readers) or in whatever page that opens the reader?
Author
Owner

@github-actions[bot] commented on GitHub (Jan 19, 2025):

Fixed in v0.9.78-beta.

@github-actions[bot] commented on GitHub (Jan 19, 2025): Fixed in [v0.9.78-beta](https://github.com/advplyr/audiobookshelf-app/releases/tag/v0.9.78-beta).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf-app#967