Files
novafarma/AUDIO_GENERATION_MANIFEST.md
David Kotnik 5b07de56da 📊 Jan 8 Audio System Complete Organization + Generation Manifest
 AUDIO REORGANIZATION COMPLETE:

**Files Moved:**
- Moved 2 SFX WAV: footstep_grass.wav, wood_chop.wav → /sfx/
- Moved 1 Music MP3: forest_ambient.mp3 → /music/
- Moved 43 Voiceover WAV: prologue_sl files → /voiceover/
- Existing 20 Voice MP3: Ana, Kai, Mayor, Narrator, Teacher → /voices/

**Folder Structure Created:**
/assets/audio/
├── sfx/
│   ├── farming/ (8 placeholder .txt)
│   ├── combat/ (8 placeholder .txt)
│   ├── building/ (5 placeholder .txt)
│   └── misc/ (4 placeholder .txt)
├── music/ (8 placeholder .txt + 1 MP3 )
├── voices/ (20 MP3 )
└── voiceover/ (43 WAV )

📋 CREATED DOCUMENTATION:

1. **AUDIO_GENERATION_MANIFEST.md**
   - Complete list of 33 missing audio files
   - Detailed specifications (duration, format, mood)
   - SFX: 25 files (farming, combat, building, misc)
   - Music: 8 files (themes, ambients, victory)
   - Generation instructions (AI tools, free libraries)

2. **scripts/convert_audio_to_ogg.py**
   - Auto-remove .txt placeholders
   - Convert MP3/WAV → OGG (ffmpeg)
   - Verify file integrity
   - Generate audioManifest.json for Phaser

 STILL MISSING:
- 25 SFX .ogg files (placeholders only)
- 7 Music .ogg files (placeholders only)

🎯 NEXT STEPS:
1. Generate audio using AI tools (ElevenLabs, Suno, etc.)
2. Run: python3 scripts/convert_audio_to_ogg.py
3. Verify all 33 files present

**Current Audio Status:** 66/99 files (67% complete)
2026-01-08 15:50:30 +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