# Desktop app

The desktop app for Mac and Windows runs the same Opisense as the web, and can also let bots use
your own computer.

## Install

- Mac: [download Opisense](https://github.com/Opisense/opisense-desktop/releases/latest/download/Opisense.dmg)
  (Apple silicon and Intel), open it, and drag Opisense to Applications.
- Windows: [download the installer](https://github.com/Opisense/opisense-desktop/releases/latest/download/Opisense-Setup.exe)
  and run it.

The app updates itself.

## Choose a server

The first time it opens, the app asks which server to use:

- **Opisense Cloud**: sign in to your Opisense Cloud account.
- **Existing instance**: connect to an Opisense server you or your team already run. Enter its
  **Server address** and choose **Check connection**.

To switch later, use **Change Opisense Server…** in the app menu (Cmd+Shift+K, or Ctrl+Shift+K on
Windows).

To keep a second account signed in on the same server, choose **Add account** in the account menu.
See [More than one account](/docs/account/#more-than-one-account).

## Let bots use this computer

The desktop app can give bots access to the computer it runs on, to run commands and work with your
files.

Turn on **Let bots use this computer** in **Settings → General** under **Computers**. Your computer
then shows as **Connected** or **Offline** there.

The app asks **Allow bots to use this computer?** before access is granted. Each signed-in account
is asked on its own: allowing one never lets another account's bots use this computer. See
[The bot's computer](/docs/computer/#use-your-own-computer).

> [!WARNING]
> With **Use this Mac**, bots can run commands without asking. Don't choose it for a server other
> people use.

## Updates

The app checks for updates and downloads them in the background. When one is ready, an
**Install update** button appears at the bottom of the sidebar, or choose **Restart** when asked.
**Check for Updates…** in the app menu checks now.

## Shortcuts

- Cmd+N (Ctrl+N): create a bot, group or space.
- Cmd+K (Ctrl+K): jump to any bot.
- Cmd+, (Ctrl+, in the desktop app): open Settings.
- Ctrl+Tab / Ctrl+Shift+Tab (desktop app): switch to the next or previous bot.
- Cmd/Ctrl+Shift+Down / Cmd/Ctrl+Shift+Up (browser): switch to the next or previous bot.

The dock icon shows a badge count of unread chats.
