# Notifications and widgets

> The app can notify you about bitsrun sessions, endpoints and your balance, and its home screen widgets show your balance and awake endpoints.

Source: https://bitsrun.com/docs/mobile/notifications-and-widgets/
Updated: 2026-11-09

## Notifications

Allow notifications when the app asks, or later in **Account**, **Notifications**. Each type has its own switch:

| Group | Notification | When it comes |
|---|---|---|
| Remote control | Remote control turned on | bitsrun on one of your computers starts a remote session |
| Remote control | Session needs approval | bitsrun is waiting for you to allow or deny a change or command |
| Remote control | Session finished | a longer bitsrun turn is done |
| Endpoints | Endpoint could not start | an endpoint failed to load its model |
| Endpoints | Always-on endpoint stopped | an always-on endpoint stopped because your balance ran out |
| Balance | Low balance | your balance dropped under your alert level |
| Security alerts | Always on | a new device, app or command line signed in to your account |

Security alerts cannot be turned off, so you always hear about a sign-in you did not make.

If notifications are off for BitsRun in your phone's settings, the screen says "Notifications are off for BitsRun". Tap **Turn on**.

### Answer from the notification

Tapping a notification opens the right screen: the session that needs you, or the playground whose endpoint is ready. An approval asks for Face ID, your passcode, your fingerprint or your screen lock before it is sent.

### Ready notifications from the playground

When you send a message to a sleeping endpoint and leave the playground, the app asks for one "ready" notification for that endpoint. It is cancelled when you come back, so you get it only if you are away.

> [!TIP]
> Prefer email? In **Account**, turn on **Email me when a slow start finishes** to get one email when an endpoint that took more than 2 minutes to start is ready. The same switch is on the dashboard's Billing page.

## While a session runs

While you follow a bitsrun session, the iPhone shows a Live Activity on the lock screen and in the Dynamic Island, and Android shows an ongoing notification. They show what bitsrun is doing and when it needs you.

## Home screen widgets

Add the BitsRun widgets from your home screen's widget picker:

| Widget | What it shows |
|---|---|
| **Balance** | Your balance and what you are spending right now |
| **Awake endpoints** | Which endpoints are running or starting, and your balance |

Widgets refresh on their own; open the app for the latest numbers.