Files
novafarma/docs/AUDIO_GENERATION_MANIFEST.md
2026-01-20 01:05:17 +01:00

141 lines
4.7 KiB
Markdown

# 🎵 **AUDIO GENERATION MANIFEST - JAN 8, 2026**
**COMPLETE LIST OF ALL MISSING AUDIO FILES**
---
## 📊 **SUMMARY:**
- **SFX Needed:** 25 files (.ogg format)
- **Music Needed:** 8 files (.ogg format)
- **Total:** 33 audio files to generate
---
## 🔊 **1. SOUND EFFECTS (SFX) - 25 FILES**
### **FARMING SOUNDS (8 files)** 🌾
**Path:** `/assets/audio/sfx/farming/`
| Filename | Description | Duration | Notes |
|----------|-------------|----------|-------|
| `cow_moo.ogg` | Cow mooing sound | 2-3s | Friendly, farm animal |
| `dig.ogg` | Digging/hoeing soil | 1s | Shovel into dirt |
| `harvest.ogg` | Crop harvest/pickup | 0.5s | Satisfying pop/snap |
| `plant_seed.ogg` | Planting seed in soil | 0.5s | Soft thud |
| `scythe_swing.ogg` | Scythe swinging through air | 0.8s | Whoosh sound |
| `stone_mine.ogg` | Pickaxe hitting stone | 1s | Clink/chip sound |
| `tree_chop.ogg` | Axe chopping wood | 1s | Thunk/chop |
| `water_crop.ogg` | Watering can pouring | 1.5s | Water splash/trickle |
---
### **COMBAT SOUNDS (8 files)** ⚔️
**Path:** `/assets/audio/sfx/combat/`
| Filename | Description | Duration | Notes |
|----------|-------------|----------|-------|
| `bow_release.ogg` | Arrow release from bow | 0.3s | Twang sound |
| `explosion.ogg` | Explosion/bomb | 2s | Boom + debris |
| `player_hurt.ogg` | Player damage grunt | 0.5s | Oof/ugh |
| `raider_attack.ogg` | Enemy attack yell | 1s | Aggressive shout |
| `shield_block.ogg` | Shield blocking hit | 0.5s | Metallic clang |
| `sword_slash.ogg` | Sword swing | 0.5s | Whoosh + metal |
| `zombie_death.ogg` | Zombie dies | 1.5s | Groan + thud |
| `zombie_hit.ogg` | Zombie takes damage | 0.5s | Hurt groan |
---
### **BUILDING SOUNDS (5 files)** 🏗️
**Path:** `/assets/audio/sfx/building/`
| Filename | Description | Duration | Notes |
|----------|-------------|----------|-------|
| `chest_open.ogg` | Chest opening | 1s | Creaky wood |
| `door_close.ogg` | Door closing | 0.8s | Wood door slam |
| `door_open.ogg` | Door opening | 0.8s | Creaky hinges |
| `hammer_nail.ogg` | Hammering nail | 0.5s | Metallic bang |
| `repair.ogg` | Building repair | 1.5s | Construction sounds |
---
### **MISC SOUNDS (4 files)** ✨
**Path:** `/assets/audio/sfx/misc/`
| Filename | Description | Duration | Notes |
|----------|-------------|----------|-------|
| `coin_collect.ogg` | Picking up coin | 0.3s | Bright ching! |
| `footstep_grass.ogg` | Footstep on grass | 0.3s | Soft rustle (HAVE .wav, convert!) |
| `footstep_stone.ogg` | Footstep on stone | 0.3s | Hard tap |
| `level_up.ogg` | Level up/achievement | 2s | Triumphant chime |
---
## 🎶 **2. MUSIC TRACKS - 8 FILES**
### **BACKGROUND MUSIC (.ogg format)**
**Path:** `/assets/audio/music/`
| Filename | Description | Duration | Loop | BPM | Mood |
|----------|-------------|----------|------|-----|------|
| `forest_ambient.mp3` | **✅ HAVE!** Forest sounds | - | Yes | - | Peaceful |
| `main_theme.ogg` | Main menu theme | 2-3min | Yes | 90-110 | Epic/Adventure |
| `farm_ambient.ogg` | Farm/grassland loop | 2-3min | Yes | 70-90 | Calm/Peaceful |
| `town_theme.ogg` | Town restoration theme | 2min | Yes | 100-120 | Hopeful/Uplifting |
| `combat_theme.ogg` | Battle music | 2min | Yes | 130-150 | Intense/Action |
| `night_theme.ogg` | Nighttime ambient | 3min | Yes | 60-80 | Mysterious/Calm |
| `victory_theme.ogg` | Quest complete | 30s | No | 120 | Triumphant |
| `raid_warning.ogg` | Raid approaching | 1min | No | 140-160 | Tense/Urgent |
| `ana_theme.ogg` | Ana's memory theme | 2min | No | 80 | Emotional/Sad |
---
## 🛠️ **GENERATION INSTRUCTIONS:**
### **Option 1: AI Sound Generation (Recommended)**
Use services like:
- **ElevenLabs Sound Effects** - AI SFX generation
- **Suno AI** or **Udio** - Music generation
- **Soundraw** - Royalty-free music generator
### **Option 2: Free Sound Libraries**
Download from:
- **Freesound.org** - Community sound library
- **OpenGameArt.org** - Game audio assets
- **Incompetech** - Royalty-free music (Kevin MacLeod)
### **Option 3: Script Generation (Placeholder)**
Use `/scripts/generate_placeholder_audio.py` to create:
- Simple tone beeps (SFX placeholders)
- White noise loops (ambient placeholders)
---
## 📋 **CONVERSION CHECKLIST:**
After generating, run:
```bash
python3 /Users/davidkotnik/repos/novafarma/scripts/convert_audio_to_ogg.py
```
This will:
1. Convert all .mp3/.wav to .ogg
2. Remove .txt placeholders
3. Verify file sizes
4. Generate audio manifest
---
## ✅ **COMPLETION CRITERIA:**
- [ ] All 25 SFX .ogg files present
- [ ] All 8 music .ogg files present
- [ ] Each file is 5KB+ (not empty)
- [ ] Audio plays correctly in Phaser 3
- [ ] Volume normalized (-14 LUFS)
---
**Status:** 📝 Manifest ready, awaiting audio generation
**Last Updated:** 2026-01-08 15:48 CET