# Shortcuts

## Why nOversight Requires a Shortcut

Apple does not allow apps to access detailed Wi‑Fi connection data through normal system APIs.

Instead, Apple provides a secure and user‑controlled mechanism via the Shortcuts app. This is the only supported method Apple allows for sharing detailed Wi‑Fi diagnostics.

nOversight uses this official mechanism.

***

## Shortcut Setup

During setup, nOversight guides you to install a Shortcut named **Network to nOversight**.

When prompted, choose **Always Allow** for data sharing.

This ensures Wi‑Fi data can flow correctly while remaining fully under your control.

***

## After Installing the Shortcut

{% stepper %}
{% step %}

### Return to nOversight

Go back to the nOversight app after installing the Shortcut.
{% endstep %}

{% step %}

### Tap the Play button

Tap the **Play ▶︎** button in the top‑right corner of the app.
{% endstep %}

{% step %}

### Start observing

Start walking and observing live Wi‑Fi data.\
If the Play button is not pressed, no data will appear.
{% endstep %}
{% endstepper %}

***

## Troubleshooting: No Data Appearing

{% hint style="info" %}
If needed, delete **Network to nOversight** from Shortcuts and re‑run setup.
{% endhint %}

{% stepper %}
{% step %}

### Open Shortcuts

Open the Shortcuts app on your device.
{% endstep %}

{% step %}

### Delete the Shortcut

Delete **Network to nOversight** from Shortcuts.
{% endstep %}

{% step %}

### Re-run setup in nOversight

Return to nOversight and re‑run the setup process.
{% endstep %}

{% step %}

### Allow data sharing

When prompted during setup, select **Always Allow**.\
This resolves most setup issues.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://numerous-networks.gitbook.io/noversight-docs/noversight-tutorial/noversight-for-ios/shortcuts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.