> For the complete documentation index, see [llms.txt](https://guide-on.gitbook.io/telltail/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide-on.gitbook.io/telltail/installation/make-it-easy-to-access-telltail-on-your-android.md).

# Make it Easy to Access Telltail on Your Android

While there is an upper limit on the things we can achieve on iOS, there isn't that much on Android. For example, in both Android and iOS, looking for clipboard changes in the background isn't allowed. But you can topple this restriction on Android if you could root your device or have ADB access. There are many options to do automation as well: Tasker, Automate by LlamaLab, MacroDroid. You could use any of them with the [APIs that Center provides](/telltail/centers-apis.md) to store and retrieve text on any motion or gesture you make, or button or icon you press.  &#x20;

As such, I can't document all of them here. I leave it to you guys — [open a ticket](https://github.com/ajitid/telltail-center/issues/new) and tell me about a neat and intuitive way you found to trigger copy/paste. And I'll finalize and put them here.

## Using Tasker

> Tasker support requires at least Telltail v0.3.0. You can see what your Telltail version is by typing `./telltail --version` . At the time of writing, v0.3.0 hasn't been released. If you need this feature, you can [request it here](https://github.com/ajitid/telltail-center/issues/new) so an early release can be made.

Tasker is a paid app which can be bought from [Play Store](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm) or from [their website](https://taskernet.com/?licenses).

### Prerequisites

* A computer
* Know-how of Tasker
* Tailscale enabled on your phone&#x20;

### Disable Battery Optimisations

You have to disable any battery optimisation for Tailscale and Tasker. You can find instructions for some of the devices [here](https://help.cardata.co/article/175-how-to-turn-off-your-androids-battery-optimizer).

### Setting Up Permissions

Download [Tasker Permissions](https://github.com/joaomgcd/Tasker-Permissions/releases/latest) app and open it. The Permissions app will display instructions in its bottom half.  Follow them.

If you see a popup like this on your phone during the setup process, you should enable "Always allow from this computer" and then click Allow:

<figure><img src="https://300375748-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwiNFwwSoN1dOn5OxxIS%2Fuploads%2FnXFHMdzevJQQqQusDTlh%2FScreenshot_20240811_031821_Settings.jpg?alt=media&amp;token=3f17f069-8d99-4c88-b455-b4d32dbecb4b" alt="" width="375"><figcaption></figcaption></figure>

Once the screen changes, we land on configuration. There are two things we need to do here:

#### Setup Permissions

To enable the following permissions, click on the red boxes so they turn green.

<figure><img src="https://300375748-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwiNFwwSoN1dOn5OxxIS%2Fuploads%2FyXoFEO0ehBv1DcQwsw54%2Fimage.png?alt=media&amp;token=2f5dc03a-f613-45fc-8a1e-b8bfd29837ef" alt=""><figcaption></figcaption></figure>

#### Enable ADB WiFi

Click Confirm for "Enable ADB Wifi in Tasker with port". This option usually appears right below "Reload Devices/Permissions", positioned at the left of the window.&#x20;

<figure><img src="https://300375748-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwiNFwwSoN1dOn5OxxIS%2Fuploads%2FBRHeNm2ORXCmhzI0AEix%2Fimage.png?alt=media&amp;token=2fc401f4-f0ec-490f-a64c-d5295b3f5a54" alt=""><figcaption><p>Enabling ADB WiFi</p></figcaption></figure>

Alternatively, if you know ADB you can run this on CLI instead:

```bash
adb tcpip 5555
```

You can disconnect your phone from your computer now.

### Initialising Tasker

Keep your tailnet name handy.&#x20;

Open [this link](https://taskernet.com/shares/?user=AS35m8l7TR3q%2Ftmyuvt%2F%2B4vYhTCWN6IPxKhPwlYAGI9HUTqZ6MnPu%2FN%2BVIE0Lz4Yc1Z8ESzIHCFu\&id=Project%3ATelltail) on your phone. Tap on Import. Select Yes whenever it asks you a Yes/No question. You can keep 'android' as your device name if you don't have multiple Android devices. Otherwise, specify a different name for each of your device.

### Tell Telltail About Your Android Device

Open Tailscale's [admin console](https://login.tailscale.com/admin/machines) to find out what the machine name is for your Android device. Keep the name handy.&#x20;

In the computer you have installed Telltail Center, run this command:

```bash
./telltail edit center-custom-url
```

It will ask you to enter a URL. Use `http://<android-machine-name>:1821` as the URL wherein you would replace `<android-machine-name>` with the name you saw on admin's console.

Once this is setup, Telltail should be working. You can copy and paste as usual and the copied text will appear on other devices where Telltail is installed.

### About Restarts

When you would restart your phone, you may see notifications from Tasker about missing permissions. Unfortunately there's no set-and-forget workaround. You have to do these steps whenever you restart your phone:

1. [Enable ADB WiFi](#enable-adb-wifi)
2. Revoke and then re-grant "Read System Logs" [permission](#setup-permissions)

### Removing Tasker Support

In the machine you have installed Telltail Center, run this command:

```bash
./telltail edit center-custom-url
```

When it asks you to enter a URL, use a dash `-`.

Open Tasker on your phone. Hold your tap on "Telltail" profile written at the bottom till a context menu appears. Tap on Delete › Delete Contents. Then tap on the checkmark that appears at the top of the screen.
