# Mood Music — Scene Background Audio

These files are **real CC0-1.0 music tracks** from [freepd.com](https://freepd.com/),
redistributed via [github.com/SoundSafari/CC0-1.0-Music](https://github.com/SoundSafari/CC0-1.0-Music).
CC0-1.0 = public domain, no attribution required (but crediting the source is polite).

## Moods

| Mood | File | Title | Source |
|------|------|-------|--------|
| combat | `combat.mp3` | Battle Ready | freepd.com (via SoundSafari/CC0-1.0-Music) |
| investigation | `investigation.mp3` | Dark Hallway | freepd.com (via SoundSafari/CC0-1.0-Music) |
| tension | `tension.mp3` | Abstract Anxiety | freepd.com (via SoundSafari/CC0-1.0-Music) |
| victory | `victory.mp3` | Heroic Adventure | freepd.com (via SoundSafari/CC0-1.0-Music) |
| eerie | `eerie.mp3` | Ancient Rite | freepd.com (via SoundSafari/CC0-1.0-Music) |

## How to Swap in Your Own Tracks

1. **Find DRM-free music** from sources like:
   - [Kevin MacLeod / incompetech.com](https://incompetech.com/) — CC-BY (requires attribution)
   - [Pixabay Music](https://pixabay.com/music/) — mostly CC0
   - [Free Music Archive](https://freemusicarchive.org/) — various licenses
   - [Musopen](https://musopen.org/) — public domain classical

2. **Drop your file in** this directory with the same name (e.g. `combat.mp3`).
   The file can be any audio format the browser supports (WAV, MP3, OGG).

3. **Update `manifest.json`** if you change filenames or add new moods:
   ```json
   {
     "mood": "combat",
     "file": "combat.mp3",
     "title": "Your Track Title",
     "license": "CC-BY Kevin MacLeod"
   }
   ```

4. **No code changes needed** — the frontend reads the manifest dynamically.

## License Notes

- **CC0** — no attribution required, free for any use.
- **CC-BY** — attribution required. Add the artist name in the `license` field
  of `manifest.json` and display it in your app if desired.
- Never use copyrighted music without explicit permission.

## Technical Details

- Audio is served statically at `/music/<filename>` by Express.
- The manifest is available at `GET /api/music/manifest`.
- The GM plays music from the **GM Kit** tab → **Scene Music** section.
- Tracks loop automatically; switching moods fades out the current track.