Troubleshooting

Words or ambient sound stop when my screen is off

This is almost always your phone's battery optimization settings — some manufacturers (OnePlus, Xiaomi, Samsung especially) apply extra background-app restrictions on top of standard Android, which can pause audio apps even when they're doing everything right.

On most phones: Settings → Apps → Nyxlo → Battery → set to Unrestricted (Pixel) or Don't optimize (most other Android phones).

On OnePlus specifically: also check Settings → Battery → Battery optimization → the ⋮ menu → Advanced optimization, and turn off "Deep optimization." OnePlus has been known to silently reset this setting after system updates — if the issue comes back after an update, this is the first thing to recheck.

Playback controls don't show up on my lock screen

Audio should keep playing fine either way — this only affects whether you see pause/skip controls without unlocking your phone. A couple of settings control this, both outside Nyxlo itself:

1. Make sure notifications are allowed for Nyxlo: Settings → Apps → Nyxlo → Notifications.
2. On Pixel phones specifically, there's a separate master switch for showing any app's media player on the lock screen: Settings → Display → Lock screen → Media → turn on "Show media on lock screen." If this is off, no app's controls appear on your lock screen, Nyxlo included — worth checking if Spotify or another music app has the same issue on your phone, which confirms it's this setting rather than anything app-specific.

I can't hear anything

1. Check your phone's media volume (not ringer volume) isn't muted.
2. On the controls screen, confirm Speak words and/or Soft ambient bed is actually turned on — if both are off, nothing plays.
3. If only the ambient bed is silent, check its volume slider hasn't been left near 0%.

The pause between words feels inconsistent

If Gradually widen the gap is turned on, the pause is designed to slowly grow longer as your session goes on — that's expected, not a bug. If it feels genuinely irregular rather than gradually increasing, try reinstalling the latest version from the Play Store.

A word doesn't play, or a session skips ahead unexpectedly

Nyxlo is built to skip a word cleanly rather than get stuck if one clip fails to load — so an occasional silent skip is by design, not a crash. If this happens frequently, please get in touch (below) — that's not expected behavior.