Prevent automatic screen blanking during music playback if lyrics panel is open

[ebkalderon]

This issue respects the following points:

• This issue is not already reported on GitHub (I've searched it).
• I agree to follow Jellyfin's Code of Conduct.
• This report addresses only a single issue; If you encounter multiple issues, kindly create separate reports for each one.

Describe the bug

If you play music in the official Jellyfin Android client and view synchronized music lyrics in the Jellyfin Android client, the screen eventually goes dim after a period of no touchscreen interaction and then locks itself.

Reproduction Steps

1. Ensure your device is configured to automatically lock itself after a period of inactivity before continuing. This behavior should come default on basically all Android devices.
2. Open the Jellyfin Android app.
3. Play any music track with lyrics available.
4. While the track is playing, open the lyrics viewer. Do not touch the screen while watching the lyrics scroll by.
5. Wait a while, and see that the screen will eventually dim and then go blank, thereby locking the device.

Expected/Actual behaviour

Personally, I would've expected the screen to remain on indefinitely while the lyrics viewer remains open and there's some music playing, so that I can follow the lyrics without needing to tap my phone every few seconds to wake it up. I'm pretty sure this app already behaves this way during video playback, but apparently not during music playback with lyrics visible.

Logs

No response

Server version

10.11.11

Web version

10.11.11

Build version

10.11.11

Platform

Android 15 (Samsung Galaxy S22+), Android 16 (Samsung Galaxy S26+)

Browser

Chrome 150.0.781.187, Jellyfin Android 2.6.3, Jellyfin Android 2.7.0

Additional information

Originally reported here: jellyfin/jellyfin-android#1783

Thanks so much for making and maintaining this awesome project, Jellyfin dev team! 🤗

[ebkalderon]

According to this reference page on MDN, there exists a JavaScript WakeLock request API that seems to do what we want. It is considered "newly available" across all major browsers as of Baseline 2025. Perhaps we could use this API to keep the screen awake while (a) the lyrics panel is open, (b) synchronized lyrics exist for the current track, and (3) music is actively playing?