Skip to content

Device Idle Controller (deviceidle) Commands

The Device Idle Controller (deviceidle) is a set of commands used to manage and control the idle state of an Android device. These commands allow you to manipulate idle states, check current statuses, and configure idle-related settings via ADB (Android Debug Bridge). Below are the available commands with their respective functionalities:

adb shell cmd deviceidle help

Immediately step to next state, without waiting for alarm.

adb shell cmd deviceidle step [light|deep]

Force directly into idle mode, regardless of other device state.

adb shell cmd deviceidle force-idle [light|deep]

Force to be inactive, ready to freely step idle states.

adb shell cmd deviceidle force-inactive

Resume normal functioning after force-idle or force-inactive.

adb shell cmd deviceidle unforce

Retrieve the current given state

adb shell cmd deviceidle get [light|deep|force|screen|charging|network]

Completely disable device idle mode.

adb shell cmd deviceidle disable [light|deep|all]

Re-enable device idle mode after it had previously been disabled.

adb shell cmd deviceidle enable [light|deep|all]
adb shell cmd deviceidle enabled [light|deep|all]
adb shell cmd deviceidle whitelist

Add (prefix with +) or remove (prefix with -) packages.

adb shell cmd deviceidle whitelist [package ...]

Manage system whitelist packages and reset to original state.

adb shell cmd deviceidle sys-whitelist [package ...|reset]

Manage exception idle whitelist, non-persistent across boots.

adb shell cmd deviceidle except-idle-whitelist [package ...|reset]
adb shell cmd deviceidle tempwhitelist

Temporarily whitelist a package for a specified duration.

adb shell cmd deviceidle tempwhitelist [-u USER] [-d DURATION] [-r] [package]

Simulate a motion event to bring the device out of deep doze.

adb shell cmd deviceidle motion

Set a new factor to idle time before stepping to idle.

adb shell cmd deviceidle pre-idle-factor [0|1|2]

Reset factor to idle time to default.

adb shell cmd deviceidle reset-pre-idle-factor