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

# Bird Audio

> Listen to authentic bird calls and songs from the Macaulay Library.

Each bird in BirdTab comes with a recording of its call or song, sourced from the [Macaulay Library](https://www.macaulaylibrary.org/) at the Cornell Lab of Ornithology.

<video controls playsInline width="1584" height="1080" style={{ borderRadius: '0.5rem', width: '100%', height: 'auto' }}>
  <source src="https://mintcdn.com/birdtab/mMS_-hy5jDGR5gcB/videos/audio-features-quiet-hours.mp4?fit=max&auto=format&n=mMS_-hy5jDGR5gcB&q=85&s=719788dbf9bea1d8c154bfad99afdf5c" type="video/mp4" data-path="videos/audio-features-quiet-hours.mp4" />
</video>

<Note>
  Audio is available in **photo mode only**. When video mode is active, the video's own audio plays instead.
</Note>

## Controls

<CardGroup cols={3}>
  <Card title="Play / Pause" icon="play">
    Click the play button in the toolbar to start or stop playback.
  </Card>

  <Card title="Volume" icon="volume-high">
    Drag the slider to adjust from 0–100%. Defaults to **30%** on first install. Your level is remembered.
  </Card>

  <Card title="Mute" icon="volume-xmark">
    Click the speaker icon to mute or unmute. Mute state persists between sessions.
  </Card>
</CardGroup>

## Auto-play

When **Auto-play Media** is enabled in Settings, the bird's call starts playing automatically each time you open a new tab. Disabled by default.

<Tip>
  Auto-play is automatically suppressed during Quiet Hours — no need to manually disable it at night.
</Tip>

## Quiet Hours

Quiet Hours prevent audio from auto-playing during a set window so BirdTab doesn't make noise when you don't want it to.

| Setting         | Value                                     |
| --------------- | ----------------------------------------- |
| Window          | 8:00 PM – 8:00 AM (fixed)                 |
| Indicator       | Moon icon appears in the toolbar          |
| Auto-play       | Suppressed during the window              |
| Manual playback | Always available, even during Quiet Hours |

Enable Quiet Hours in **Settings → Quiet Hours**.

## Keyboard shortcuts

With the new tab page focused:

| Key        | Action                 |
| ---------- | ---------------------- |
| `+` or `=` | Increase volume by 10% |
| `-` or `_` | Decrease volume by 10% |

## Recordist credit

Each audio clip is credited to the original recordist with a link to the Macaulay Library asset.

<Info>
  Not all birds have an audio recording. If no recording is available for the current bird, the audio controls are hidden.
</Info>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How do I stop bird audio from playing automatically?">
    Open **Settings → Auto-play Media** and toggle it **off**. Once disabled, audio will never start on its own — you can still play it manually at any time by clicking the play button in the toolbar.
  </Accordion>

  <Accordion title="How do I turn on Quiet Hours?">
    Go to **Settings → Quiet Hours** and enable it. Quiet Hours automatically suppress audio auto-play between **8:00 PM and 8:00 AM**. When Quiet Hours are active, a **moon icon** appears in the toolbar as a reminder. You can still trigger playback manually during this window.
  </Accordion>

  <Accordion title="How do I make bird audio play automatically when I open a new tab?">
    Open **Settings → Auto-play Media** and toggle it **on**. BirdTab will then start playing the current bird's call each time you open a new tab.

    <Tip>
      If audio doesn't auto-play even with this enabled, check whether Quiet Hours is active (look for the moon icon). Quiet Hours overrides Auto-play during the 8 PM – 8 AM window.
    </Tip>
  </Accordion>
</AccordionGroup>