# Desktop App Quick Start

This guide walks you from a fresh laptop to a completed recording — install, connect, record, review. If you already have a Treasure AI Voice account and just need the installer, jump to [Download](/ja/products/ai-voice/desktop#download).

Prerequisites
- A Treasure AI Voice user account (if you don't have one, ask your administrator — see [Account Activation](/ja/products/ai-voice/account-activation)).
- A supported computer (see [system requirements](/ja/products/ai-voice/desktop#system-requirements)).
- Microphone access permission on macOS or Windows.


## 1. Install

Download the appropriate build from the [Download](/ja/products/ai-voice/desktop#download) section on the overview page.

### macOS

1. Open the downloaded `.dmg` file.
2. Drag the **Treasure AI Voice** icon into the **Applications** folder.
3. Eject the DMG and launch **Treasure AI Voice** from the Applications folder or Launchpad.
4. On first launch, macOS may prompt you to allow the app to run — click **Open**.


### Windows

1. Run the downloaded `Treasure-AI-Voice-Setup-*.exe`.
2. Follow the installer prompts. The default location and shortcuts are recommended.
3. Launch **Treasure AI Voice** from the Start menu.


Automatic updates (Windows)
On Windows, the app checks for new releases in the background and installs them the next time you quit and relaunch. On macOS, install updates by downloading and re-running the DMG.

## 2. Connect your account

On first launch, the app shows a two-step setup wizard.

Setup wizard Connect step showing the Connect Treasure AI Voice button
1. On the **Welcome** step, click **Continue**.
2. On the **Connect** step, click **Connect Treasure AI Voice**. Your default browser opens the Treasure AI Voice sign-in page.
3. Sign in with the same method you use for the mobile app or the web admin dashboard (Sign in with Google, or Email / Password).
4. When the browser confirms the connection, return to the desktop app. The wizard advances to **Done** and the Meetings page opens.


For details on sign-in methods and supported identity providers, see the [Administrator Guide](/ja/products/ai-voice/administrator-guide#authentication).

Connection failed?
If the Connect button returns an error, verify that outbound HTTPS to `*.treasure.ai` is not blocked by your VPN or corporate firewall. Contact your administrator if the block is intentional.

## 3. Get to know the two windows

The desktop app has two surfaces:

| Surface  | Purpose |
|  --- | --- |
| **Status Popover** (menu bar / system tray) | A small window that opens when you click the app icon in the macOS menu bar or Windows system tray. Use it to start, pause, resume, and stop a recording without switching windows. |
| **Meeting Manager** | The main window. Shows your recordings list, transcripts, summaries, action items, and settings. Open it by double-clicking the tray icon, or by choosing **Open Meetings** from the tray's right-click menu. |


div
Status popover showing the idle state with a Start Recording button
br
Right-clicking the tray icon opens a menu with **Open Meetings**, pause / resume / stop actions while a recording is in progress, the current app version, **Check for updates…** (Windows only — macOS updates by re-running the DMG), and **Quit**. The version entry is handy for confirming which build you're running before reporting a beta issue.

Closing the Meeting Manager window hides it to the tray — it does not quit the app. To fully quit, right-click the tray icon and choose **Quit**.

## 4. Grant microphone permission

The first time you start a recording, the operating system asks for microphone access.

- **macOS**: Allow access when prompted. If you missed the prompt, open **System Settings → Privacy & Security → Microphone** and enable **Treasure AI Voice**.
- **Windows**: Allow access when prompted. If you missed the prompt, open **Settings → Privacy & security → Microphone** and enable **Treasure AI Voice** under *Let apps access your microphone*.


## 5. Record your first meeting

1. Click the tray icon to open the Status Popover, then click **Start Recording**.
2. The **Recording Consent** dialog opens.

Read the consent script aloud to every participant and wait for their verbal consent. Then:
  - Choose a **summary template** for this recording (you can change the default in Settings; see [Summary Templates](/ja/products/ai-voice/summary-templates)).
  - Click **I have consent — start recording**.
3. The Meeting Manager shows an **Active Recording** banner with a live mic-level indicator, a timer, and Pause / Resume / Stop controls.

The mic-level bar turns green as your voice is detected. If it stays flat while you're speaking, the wrong input device is selected — see [Troubleshooting](#troubleshooting).
4. When the meeting ends, click **Stop**. The recording moves to the queue and uploads in the background.


Consent is required
Every participant must give verbal consent before you start recording. The consent script in the dialog is the exact wording legal has approved. This applies to all Treasure AI Voice recordings — mobile, desktop, and PLAUD device — and is logged locally as part of the recording's audit trail.

## 6. Review the transcript and summary

Once the upload completes, the recording appears in the Meetings list. Click it to expand the detail panel.

Meetings page showing a recording with summary, action items, and transcript expanded
You'll see:

- **Summary** — an AI-generated summary in the template you chose.
- **Action items** — extracted tasks and next steps.
- **Transcript** — the full transcript with speaker labels and timestamps.


Each section has a **Copy** button that copies the raw markdown to your clipboard.

Transcription usually finishes within a few minutes for meetings under an hour. Longer recordings take proportionally longer. If a recording gets stuck in the **Failed** state, click **Retry** on the row to re-upload from the local copy (available until the local retention window expires — see Settings below).

## 7. Configure Settings

Open the Meeting Manager and click the **Settings** icon in the left sidebar.

Settings page showing account status, health check, retention, transcription language, UI language, theme, and legal links
Notable settings:

| Setting  | Description |
|  --- | --- |
| **Local recording retention** | How long the app keeps the original audio file on your computer after upload. Default is **1 day**. Increase this if you expect to retry failed uploads; decrease it to free disk space sooner. Cloud retention is set separately by your administrator (7 years by default for compliance). |
| **Transcription language** | **Auto** (recommended), **English**, or **Japanese**. Auto lets the transcription service detect the language of each recording. |
| **App language** | English or Japanese. Follows the OS locale on first launch. |
| **Appearance** | Light, Dark, or System. |
| **Legal** | Links to Privacy Statement, Terms of Service, Voice Supplemental Terms, AI Terms, and AI Acceptable Use Policy. |


## Troubleshooting

### The mic level stays flat while I'm speaking

The wrong input device is selected. The desktop app auto-selects a working input device on launch, but plugging in a headset or switching monitors after launch can leave a stale selection.

**Fix**: Stop the current recording, quit and relaunch the app, then start a new recording. The app re-picks the best available input on launch.

### A recording is stuck in "Failed"

The upload didn't complete — usually a transient network issue. Click **Retry** on the recording row. The app re-uploads from the local audio file (available until the retention window expires).

If retry keeps failing:

1. Open Settings and click **Check connection** under the account section.
2. Confirm outbound HTTPS to `*.treasure.ai` is allowed on your network.
3. Retry is only offered for rows in the `FAILED` state. If a recording is stuck in another state (for example `UPLOADING`), leave it — the app will finish the upload or move it to `FAILED` automatically.


### The app doesn't remember my sign-in

Tokens are stored encrypted per user on the machine. If you sign into a different macOS/Windows user account, or wipe the app's data directory, you'll need to reconnect. Data directory locations:

- **macOS**: `~/Library/Application Support/Treasure AI Voice/`
- **Windows**: `%APPDATA%/Treasure AI Voice/`


## What's next

- [Summary Templates](/ja/products/ai-voice/summary-templates) — customize what your summaries look like.
- [Administrator Guide](/ja/products/ai-voice/administrator-guide) — how organizations manage users, devices, and recordings.
- [Troubleshooting & FAQ](/ja/products/ai-voice/troubleshooting-and-faq) — full troubleshooting reference (mobile + desktop + hardware).


Feedback on the beta? Contact your Treasure AI account team.