NanoDroid/doc/NanoDroidUtil.md

Table of Contents
=================

   * [NanoDroid-Util Script](#nanodroid-util-script)
      * [Purpose](#purpose)
      * [Invocation](#invocation)
      * [Feature overview](#feature-overview)
         * [Fix OTA-Update issues](#fix-ota-update-issues)
         * [Airplane Mode settings](#airplane-mode-settings)
         * [Prevent audio focus stealing](#prevent-audio-focus-stealing)
         * [Prevent clipboard reading](#prevent-clipboard-reading)
         * [Read boot count](#read-boot-count)

Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)

# NanoDroid-Util Script

## Purpose

The `nanodroid-util` Script (`nutl` in short) 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+)

## 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](https://www.xda-developers.com/broken-navigation-bar-lock-screen-ota-update/)

### Airplane Mode settings

`-a`, `--airplane-mode`

Change Airplane Mode settings. This is interactive. User will be given instructions on what to do. This allows to change which radios are disabled by Airplane Mode. It also force Android to **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 behaviour. 

[app] is the package name (`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. You can prevent this behaviour with this.

[app] is the package name (`com.organisation.application` format). For example: `com.xda.labs`

**Note:** do NOT do this in applications like Browsers or the-like as you'll disable the whole copy-paste feature for those app(s).

### Read boot count

`-b`, `--boot-count`

Show how often the device was booted; requires Android 7.0+

### 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.