> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peanutsapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hands-Free Mode

> Full-screen voice conversation for logging entries without touching your phone

Hands-Free Mode provides a complete voice conversation loop for logging entries when you can't use your hands. Perfect for driving, cooking, exercising, or any situation where touching your phone isn't practical.

<Info>
  Hands-Free Mode costs approximately **21 credits per entry**: Speech-to-text (8) + AI parsing (1) + Text-to-speech (12).
</Info>

## How It Works

Hands-Free Mode creates a full-screen overlay with a continuous voice conversation:

1. **You speak** your entry naturally
2. **Peanuts processes** and extracts the data
3. **Peanuts reads back** what it understood
4. **You confirm** with voice commands

The loop continues until you save or cancel.

## Activating Hands-Free Mode

<Steps>
  <Step title="Open a Helper">
    Navigate to the helper where you want to add an entry.
  </Step>

  <Step title="Tap the Headphone Icon">
    Look for the headphone icon in the entry area (mobile only).
  </Step>

  <Step title="Grant Microphone Access">
    Allow microphone access if prompted.
  </Step>

  <Step title="Start Speaking">
    The overlay appears with a pulsing waveform. Speak your entry naturally.
  </Step>
</Steps>

## Voice Commands

During a Hands-Free session, use these commands:

| Command                 | Action                                   |
| ----------------------- | ---------------------------------------- |
| "Save" or "Confirm"     | Save the entry and exit                  |
| "Cancel" or "Exit"      | Discard and exit                         |
| "Edit" or "Change"      | Modify what was captured                 |
| "Read back" or "Repeat" | Hear the entry again                     |
| "Next"                  | Move to next field (multi-field entries) |

<Tip>
  Speak naturally. You don't need to use exact command words. "That's correct, save it" works just as well as "Save."
</Tip>

## Session Flow

```mermaid theme={null}
graph TD
    A[Activate Hands-Free] --> B[Listening...]
    B --> C[Processing speech]
    C --> D[Reading back entry]
    D --> E{Confirm?}
    E -->|Yes| F[Entry saved]
    E -->|No| G[Edit or try again]
    G --> B
    E -->|Cancel| H[Session ended]
```

## Visual Feedback

The Hands-Free overlay shows:

* **Pulsing waveform**: Indicates active listening
* **Processing indicator**: Shows when speech is being analyzed
* **Entry preview**: Displays what was captured
* **Status text**: Current state (listening, processing, confirming)

## Tips for Best Results

<AccordionGroup>
  <Accordion title="Speak Clearly">
    Use a normal speaking pace. Avoid mumbling or speaking too quickly.
  </Accordion>

  <Accordion title="Reduce Background Noise">
    Find a quieter environment when possible. The AI handles some noise, but clarity helps.
  </Accordion>

  <Accordion title="Include All Details">
    Mention all relevant fields in one statement: "Lunch at Chipotle, \$12.50, paid with credit card."
  </Accordion>

  <Accordion title="Wait for the Beep">
    After activation, wait for the listening indicator before speaking.
  </Accordion>
</AccordionGroup>

## Credit Costs

Each Hands-Free entry uses approximately **21 credits**:

| Component            | Credits | Purpose                |
| -------------------- | ------- | ---------------------- |
| Speech-to-Text (STT) | 8       | Transcribe your voice  |
| AI Parsing           | 1       | Extract entry data     |
| Text-to-Speech (TTS) | 12      | Read back confirmation |

<Tip>
  To save credits, use regular [Voice Input](/features/voice-input) (9 credits) when you can see the screen for visual confirmation.
</Tip>

## Difference from Voice Input

| Feature      | Voice Input Button   | Hands-Free Mode         |
| ------------ | -------------------- | ----------------------- |
| Interface    | Stays in normal view | Full-screen overlay     |
| Confirmation | Manual review        | Voice confirmation      |
| Multi-turn   | Single input         | Continuous conversation |
| Credits      | 9 per entry          | \~21 per entry          |
| Best for     | Quick entries        | Can't touch phone       |

## Supported Helpers

Hands-Free Mode works best with helpers that have:

* Clear, distinct fields
* Numeric or short text values
* Date/time fields

Complex helpers with many optional fields may require more back-and-forth to capture all data.

## Exiting Hands-Free Mode

To exit at any time:

* Say "Cancel" or "Exit"
* Tap anywhere on the screen
* Press the back button (Android)
* Swipe down (iOS)

If you exit without saving, the entry is discarded.

## Related

<CardGroup cols={2}>
  <Card title="Voice Input" icon="microphone" href="/features/voice-input">
    Quick voice entry without full-screen mode
  </Card>

  <Card title="Telegram Voice" icon="paper-plane" href="/integrations/telegram">
    Send voice messages via Telegram
  </Card>
</CardGroup>