2
0
mirror of https://gitlab.com/Nanolx/NanoDroid synced 2024-10-31 09:20:23 +00:00
NanoDroid/doc/NanoDroidUtil.md
Christopher Roy Bratusek 27a593fcd4 update NanoDroidUtil doc
2020-11-03 10:39:50 +01:00

3.2 KiB

Table of Contents

Created by gh-md-toc

NanoDroid-Util Script

Purpose

The nanodroid-util Script, respectively it's shortcut nutl is used by NanoDroid to perform various actions:

  • fix navigation bar, status bar or lock screen issues after OTA update
  • change Airplane Mode radio settings
  • prevent applications from stealing audio focus
  • prevent applications from reading the clipboard
  • display device's boot count
    • requires Android 7.0 or newer

Invocation

From within a terminal on your device, for example adb shell or Termux invoke the script using either

nanodroid-util [switch] [parameter(s)]

or

nutl [switch] [parameter(s)]

Feature overview

Fix OTA-Update issues

-f, --fix-update

fix issues with the navigation bar, status bar or lock screen after applying an OTA update; for a detailed description about this check > XDA

Airplane Mode settings

-a, --airplane-mode

change Airplane Mode settings, this is interactive, user will be given instructions what to do. This allows to change which radios are disabled by Airplane Mode and additionally it instructs Android that it does not allow re-activation of those radios until Airplane Mode is switched off

Prevent audio focus stealing

-F, --audio-focus [app]

some apps stop audio playback of other apps, when you bring them in foreground (or activate them in multi window mode), with this you can prevent Android from allowing this; [app] is the application name in com.organisation.application format, for example com.xda.labs

Prevent clipboard reading

-B, --read-clipboard [app]

many apps have the permission to read the clipboard for no reason, with this you can prevent Android from allowing this; [app] is the application name in com.organisation.application format, for example com.xda.labs

Note: don't do this in applications like Browsers or the-like, as you'll disable the whole copy-paste feature for those app(s) with this feature

Read boot count

-b, --boot-count

show how often the device was booted; requires Android 7.0 or newer

Reset GCM Connection

You can reset GCM connection of all apps using

-r, --reset-gms-data

or for a single app using

-r [appid], --reset-gms-data [appid]

this is especially useful when the ROM in use previously had GApps installed and now you're not receving any push messages anymore.

Reset Permissions

In a rare corner case applications are not granted permission to access camera or storage, despite the user granted the corresponding permission, using

-R, --reset-permissions

followed by a reboot will fix this issue.