Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart

Add keep screen awake toggle in Playback settings, resets on app restart

Nathan Poulsonb37aa999434b
diff --git a/lib/screens/settings_screen.dart b/lib/screens/settings_screen.dart
index 2b087258..efefb050 100644
--- a/lib/screens/settings_screen.dart
+++ b/lib/screens/settings_screen.dart
@@ -77,6 +77,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
bool _localServerEnabled = false;
String _localServerUrl = '';
late final TextEditingController _localServerController;
+ bool _keepScreenAwake = false;
bool _disableAudioFocus = false;
bool _trustAllCerts = false;
bool _loaded = false;
@@ -1082,6 +1083,18 @@ class _SettingsScreenState extends State<SettingsScreen> {
} : null,
),
const Divider(height: 1, indent: 16, endIndent: 16),
+ SwitchListTile(
+ title: const Text('Keep screen awake'),
+ subtitle: Text(
+ _keepScreenAwake ? 'On - screen stays on during playback' : 'Off',
+ style: tt.bodySmall?.copyWith(color: cs.onSurfaceVariant)),
+ value: _keepScreenAwake,
+ onChanged: _loaded ? (v) {
+ setState(() => _keepScreenAwake = v);
+ PlayerSettings.keepScreenAwake = v;
+ } : null,
+ ),
+ const Divider(height: 1, indent: 16, endIndent: 16),
// ── Auto-Rewind ──
SwitchListTile(
title: const Text('Auto-rewind on resume'),
diff --git a/lib/services/audio_player_service.dart b/lib/services/audio_player_service.dart
index 524226ae..1109eabe 100644
--- a/lib/services/audio_player_service.dart
+++ b/lib/services/audio_player_service.dart
@@ -7,6 +7,7 @@ import 'package:just_audio/just_audio.dart';
import 'package:audio_service/audio_service.dart';
import 'package:audio_session/audio_session.dart';
import 'package:shared_preferences/shared_preferences.dart';
+import 'package:wakelock_plus/wakelock_plus.dart';
import 'api_service.dart';
import 'download_service.dart';
import 'playback_history_service.dart' hide PlaybackEvent;
@@ -184,6 +185,8 @@ class PlayerSettings {
static Future<bool> getSkipChapterBarrier() => _get('skipChapterBarrier', true);
static Future<void> setSkipChapterBarrier(bool value) => _set('skipChapterBarrier', value);
+ static bool keepScreenAwake = false;
+
/// Cached value for synchronous access in widget build methods.
static bool showExplicitBadge = true;
static Future<bool> getShowExplicitBadge() => _get('showExplicitBadge', true);
@@ -2081,6 +2084,14 @@ class AudioPlayerService extends ChangeNotifier {
));
}
+ void _updateWakeLock(bool playing) {
+ if (PlayerSettings.keepScreenAwake && playing) {
+ WakelockPlus.enable();
+ } else {
+ WakelockPlus.disable();
+ }
+ }
+
void _clearState() {
_currentItemId = null;
_currentEpisodeId = null;
@@ -2644,6 +2655,7 @@ class AudioPlayerService extends ChangeNotifier {
_player?.play();
_logEvent(PlaybackEventType.play);
_onPlaybackStateChangedCallback?.call(true);
+ _updateWakeLock(true);
// Check auto sleep on every resume — catches window entry between pauses
SleepTimerService().checkAutoSleep();
notifyListeners();
@@ -2656,6 +2668,7 @@ class AudioPlayerService extends ChangeNotifier {
await _player?.pause();
_logEvent(PlaybackEventType.pause);
_onPlaybackStateChangedCallback?.call(false);
+ _updateWakeLock(false);
notifyListeners();
final pos = position;
debugPrint('[Player] Saving on pause: ${(pos.inMilliseconds / 1000.0).toStringAsFixed(1)}s');
@@ -2866,6 +2879,7 @@ class AudioPlayerService extends ChangeNotifier {
await _player?.stop();
_onPlaybackStateChangedCallback?.call(false);
+ _updateWakeLock(false);
_clearState();
_chapters = [];
_handler?.updateChaptersQueue(const []);