# Audio Tag Usage Guide

A content creator's guide to using audio tags for expressive, professional voice synthesis.

## What Are Audio Tags?

Audio tags are special markers in your script that tell the voice synthesis system how to deliver specific parts of your content. They control:

- **Emotion** - How the voice feels
- **Reactions** - Physical sounds like sighs or laughter
- **Pacing** - Speed and pauses
- **Tone** - Overall quality of voice
- **Delivery** - How words are spoken

## Quick Reference

### Most Common Tags for Meditation

| Tag | Effect | When to Use |
|-----|--------|-------------|
| `[calm]` | Peaceful, serene voice | Throughout meditation content |
| `[warmly]` | Friendly, nurturing | Welcoming, closing |
| `[sigh]` | Gentle exhale sound | After settling, release moments |
| `[pauses]` | Thoughtful pause | Before important instructions |
| `[whispers]` | Soft, intimate voice | Sleep content, intimate moments |
| `[deliberate]` | Slow, measured speech | Key instructions |

### Basic Syntax

Tags go in square brackets, placed before the text they affect:

```
[calm] Welcome to your meditation practice.
```

Multiple tags can be combined:

```
[calm] [warmly] Welcome to this moment of peace.
```

## Tag Categories

### Emotional Tags

Set the feeling of the voice:

| Tag | Feel | Best For |
|-----|------|----------|
| `[calm]` | Peaceful, serene | Meditation, relaxation |
| `[happy]` | Joyful, upbeat | Affirmations, celebration |
| `[excited]` | Energetic, enthusiastic | Morning practice, motivation |
| `[sorrowful]` | Deep sadness | Grief meditation, letting go |
| `[nervous]` | Anxious energy | Character dialogue |
| `[surprised]` | Unexpected reaction | Discovery moments |

**Example:**
```
[calm] Allow yourself to settle into stillness.

[happy] You did it! A full week of practice.

[sorrowful] We hold space for this loss, this grief.
```

### Reaction Tags

Add natural human sounds:

| Tag | Sound | When to Use |
|-----|-------|-------------|
| `[sigh]` | Exhale of relief | After tension release |
| `[laughs]` | Natural laughter | Joyful moments |
| `[whispers]` | Soft, quiet | Intimate content, sleep |
| `[gasps]` | Sharp intake | Surprise, revelation |
| `[clears throat]` | Throat clear | Before formal statement |

**Example:**
```
[sigh] After all that work, you can finally rest.

[whispers] In the quiet of this moment, listen closely.

[laughs] And sometimes, we just have to laugh at ourselves.
```

### Tone Tags

Set the overall voice quality:

| Tag | Quality | Best For |
|-----|---------|----------|
| `[warmly]` | Friendly, caring | Welcome, comfort |
| `[cheerfully]` | Bright, upbeat | Kids content, celebration |
| `[playfully]` | Light, fun | Children, games |
| `[seriously]` | Grave, important | Key teachings |
| `[flatly]` | Emotionless | Contrast, deadpan |

**Example:**
```
[warmly] Welcome back. I'm glad you're here.

[seriously] This next part is important.

[playfully] Now, let's have some fun with this.
```

### Delivery Tags

Control how words are spoken:

| Tag | Effect | Purpose |
|-----|--------|---------|
| `[pause]` | Brief silence | Between thoughts |
| `[pauses]` | Thoughtful pause | Before emphasis |
| `[deliberate]` | Slow, measured | Key instructions |
| `[rushed]` | Fast speech | Urgency (rare in meditation) |
| `[whispered]` | Very soft | Deep intimacy |
| `[drawn out]` | Extended sounds | Emphasis |

**Example:**
```
[deliberate] Breathe... in... [pause] and... out.

[pauses] And now, we come to the heart of the practice.
```

## Content-Specific Tag Sets

### Sleep Meditations

**Preferred tags:**
- `[calm]` - Primary emotional tone
- `[whispers]` - Create intimacy
- `[sigh]` - Release sounds
- `[warmly]` - Comfort and safety
- `[deliberate]` - Slow pacing

**Avoid:**
- `[excited]` - Too stimulating
- `[rushed]` - Opposite of restful
- `[shouted]` - Jarring

**Example sleep script:**
```
[calm] [warmly] Allow your body to sink into the bed.
[sigh]
[whispers] There's nowhere you need to go.
Nothing you need to do.
[deliberate] Just... rest.
[pause]
Let your eyes grow heavy.
[whispers] Heavier still.
```

### Standard Meditation

**Preferred tags:**
- `[calm]` - Baseline tone
- `[warmly]` - Opening and closing
- `[pauses]` - Before key points
- `[deliberate]` - Important instructions
- `[thoughtful]` - Reflective moments

**Example meditation script:**
```
[warmly] Welcome to your practice.
[pause]
[calm] Find a comfortable position.
Let your body settle.
[pauses]
[deliberate] Now... bring your attention to your breath.
[pause]
[thoughtful] Notice... without trying to change anything.
```

### Kids Content

**Preferred tags:**
- `[cheerfully]` - Primary tone
- `[playfully]` - Games and activities
- `[excited]` - Celebrations
- `[happy]` - General positivity
- `[warmly]` - Comfort moments

**Avoid:**
- `[sorrowful]` - Too heavy
- `[whispers]` - May be harder to hear
- `[fearful]` - Inappropriate

**Example kids script:**
```
[cheerfully] Hi there, little explorer!
[excited] Are you ready for an adventure?
[playfully] Let's pretend we're butterflies!
[happy] Spread your wings and flutter around.
[laughs]
[warmly] Great job! You're doing wonderfully.
```

### Energizing/Morning

**Preferred tags:**
- `[cheerfully]` - Bright energy
- `[excited]` - Building motivation
- `[happy]` - Positive outlook
- `[warmly]` - Welcome warmth

**Example energizing script:**
```
[cheerfully] Good morning!
[warmly] Welcome to a brand new day.
[pause]
[happy] Today is full of possibilities.
[excited] You have the power to make it amazing!
[deliberate] Take a deep, energizing breath...
```

### Healing/Therapeutic

**Preferred tags:**
- `[warmly]` - Safety and nurturing
- `[calm]` - Peaceful presence
- `[sigh]` - Release and relief
- `[pauses]` - Space for processing
- `[thoughtful]` - Gentle reflection

**Example healing script:**
```
[warmly] You are safe here.
[calm] In this moment, you are okay.
[pause]
[sigh]
Whatever you're carrying... you don't have to carry alone.
[pauses]
[thoughtful] Allow healing to flow through you.
[warmly] You are worthy of this care.
```

## Placement Guidelines

### Rule 1: Tags Before Text

Always place tags before the text they affect:

```
✓ [calm] Welcome to your practice.
✗ Welcome to your practice. [calm]
```

### Rule 2: Space Between Tags

Leave breathing room—don't stack too many:

```
✓ [calm] Welcome. [warmly] I'm glad you're here.
✗ [calm] [warmly] [pauses] [deliberate] Welcome.
```

### Rule 3: Natural Placement

Put emotional tags at natural speech boundaries:

```
✓ [calm] Allow yourself to settle.
   Notice your breath.
   [warmly] You are exactly where you need to be.

✗ Allow yourself [calm] to settle.
```

### Rule 4: Reactions Before Content

Place reaction sounds before related text:

```
✓ [sigh] Let it all go.
✓ [whispers] This is just between us.

✗ Let it all go. [sigh]
```

### Rule 5: One Emotional Tag Per Section

Don't change emotions too rapidly:

```
✓ [calm] This entire section maintains peace.
   The voice stays consistent.
   Building a sense of safety.
   [warmly] And now we transition to closing.

✗ [calm] Peace. [excited] Energy! [sad] Sorrow. [happy] Joy!
```

## Tag Transitions

### Smooth Emotional Shifts

When changing emotional tone, use transitional moments:

```
[calm] Allow yourself to rest in this stillness.
[pause]
The practice is complete.
[warmly] Carry this peace with you.
```

### Building Energy

Gradually increase energy with tag progression:

```
[calm] Begin in stillness.
[pause]
[warmly] Feel the life within you.
[happy] Energy beginning to flow.
[excited] You are fully awake, fully alive!
```

### Calming Down

Reverse the progression for settling:

```
[excited] Feel all that energy!
[happy] Now, let it settle.
[warmly] Finding your center.
[calm] Returning to stillness.
```

## Combining with Pauses

### Marked Pauses

Use pause tags for intentional silences:

```
Take a deep breath.
[pause]
And release.
[pause]
Again.
[pause]
And release.
```

### Pause Notation in Scripts

For longer silences, use time notation:

```
Rest in this awareness.
[5 second pause]
Notice what arises.
[10 second pause]
Now, gently return.
```

### Pause Placement

Strategic pauses enhance meaning:

```
[calm] [pauses] This is the most important thing I'll say.

The breath... [pause] is always here.

May you be [pause] happy.
May you be [pause] healthy.
May you be [pause] safe.
```

## Common Mistakes

### 1. Over-Tagging

**Problem:**
```
[calm] [warmly] [pauses] [deliberate] [sigh] Welcome.
```

**Solution:**
```
[calm] [warmly] Welcome.
```

### 2. Conflicting Tags

**Problem:**
```
[excited] [calm] Find your stillness.
```

**Solution:** Choose one appropriate emotion:
```
[calm] Find your stillness.
```

### 3. Ignoring Content Type

**Problem:** Using `[excited]` in sleep content
**Solution:** Match tags to content purpose

### 4. Abrupt Transitions

**Problem:**
```
[calm] Rest in peace. [excited] NOW WAKE UP!
```

**Solution:**
```
[calm] Rest in peace.
[pause]
[warmly] Gently begin to return.
```

### 5. Tags in Wrong Position

**Problem:**
```
Welcome to your practice [calm].
```

**Solution:**
```
[calm] Welcome to your practice.
```

## Previewing Your Tags

### Review Checklist

Before finalizing your script:

- [ ] Tags are placed before text
- [ ] Emotional tone matches content type
- [ ] No conflicting adjacent tags
- [ ] Adequate spacing between tag changes
- [ ] Reactions are naturally placed
- [ ] Pauses are marked appropriately
- [ ] Energy builds and releases smoothly

### Testing Tips

1. **Read aloud** - Does the emotion feel natural?
2. **Time your pauses** - Are they long enough?
3. **Check transitions** - Are emotional shifts smooth?
4. **Consider the listener** - Would this feel jarring?

## Quick Templates

### Sleep Script Opening
```
[calm] [warmly] Welcome to your rest.
[sigh]
[whispers] Allow your body to sink into the bed.
[deliberate] Let... everything... go.
```

### Meditation Opening
```
[warmly] Welcome to your practice.
[pause]
[calm] Find your seat.
Let your body settle.
[pauses]
[deliberate] Bring your attention to this moment.
```

### Energizing Opening
```
[cheerfully] Good morning!
[happy] A new day is here.
[excited] You have so much potential today!
[warmly] Let's begin.
```

### Closing Any Session
```
[warmly] Thank you for your practice today.
[calm] Carry this peace with you.
[pause]
Go gently into your day.
```

## Related Resources

- [Meditation Script Writing Guide](./meditation-script-writing.md)
- [Voice Selection Guide](./voice-selection.md)
- [Quality Guidelines](./quality-guidelines.md)
