# 🎵 **AUDIO DOWNLOAD GUIDE - FREESOUND.ORG**

**Purpose:** Quick reference for downloading all 30 audio files  
**Source:** Freesound.org (Creative Commons, free)  
**Time:** ~30-45 minutes total

---

## 📋 **DOWNLOAD WORKFLOW:**

1. **Visit:** https://freesound.org
2. **Search** for sound name (e.g., "footstep grass")
3. **Filter:**
   - License: "Creative Commons 0" (no attribution needed) OR "CC-BY" (attribution in credits)
   - Duration: Short (< 5s for SFX, < 3min for music)
   - Format: WAV or OGG preferred
4. **Download** to `/Users/davidkotnik/repos/novafarma/assets/audio/downloads/`
5. **Rename** to match our naming convention
6. **Run conversion:** `python3 scripts/convert_audio_to_ogg.py`

---

## 🎶 **MUSIC TRACKS (7 files)**

### **1. Main Theme (Menu Music)**
**Search:** "menu music loop"  
**Recommended:** https://freesound.org/search/?q=menu+music+loop&f=duration:%5B0+TO+180%5D  
**Save as:** `main_theme.wav`  
**Notes:** Calm, inviting, loops seamlessly

### **2. Farm Ambient (Farming Background)**
**Search:** "peaceful ambient nature loop"  
**Recommended:** https://freesound.org/search/?q=peaceful+ambient+nature&f=duration:%5B0+TO+240%5D  
**Save as:** `farm_ambient.wav`  
**Notes:** Relaxing, farm-like, birds chirping optional

### **3. Town Theme (Restoration Music)**
**Search:** "uplifting acoustic loop"  
**Recommended:** https://freesound.org/search/?q=uplifting+acoustic+loop  
**Save as:** `town_theme.wav`  
**Notes:** Hopeful, rebuilding vibe

### **4. Combat Theme (Battle Music)**
**Search:** "intense action music"  
**Recommended:** https://freesound.org/search/?q=intense+action+music&f=duration:%5B0+TO+120%5D  
**Save as:** `combat_theme.wav`  
**Notes:** Fast-paced, tense

### **5. Victory Theme (Quest Complete)**
**Search:** "victory jingle"  
**Recommended:** https://freesound.org/search/?q=victory+jingle&f=duration:%5B0+TO+10%5D  
**Save as:** `victory_theme.wav`  
**Notes:** Short (~5-10s), triumphant

### **6. Ana Theme (Emotional/Flashback)**
**Search:** "sad piano emotional"  
**Recommended:** https://freesound.org/search/?q=sad+piano+emotional  
**Save as:** `ana_theme.wav`  
**Notes:** Melancholic, nostalgic

### **7. Night Theme (Already exists! ✅)**
**Status:** ✅ Used in intro, keep as is  
**File:** `night_theme.wav`

---

## 🔊 **SOUND EFFECTS (23 files)**

### **FARMING (8 sounds)**

**1. Plant Seed**  
Search: "plant seed soil"  
Link: https://freesound.org/search/?q=plant+seed+soil  
Save as: `farming/plant_seed.wav`

**2. Water Crop**  
Search: "watering can pour"  
Link: https://freesound.org/search/?q=watering+can+pour  
Save as: `farming/water_crop.wav`

**3. Harvest**  
Search: "pick vegetable"  
Link: https://freesound.org/search/?q=pick+vegetable  
Save as: `farming/harvest.wav`

**4. Dig**  
Search: "shovel dig dirt"  
Link: https://freesound.org/search/?q=shovel+dig+dirt  
Save as: `farming/dig.wav`

**5. Scythe Swing**  
Search: "whoosh sword swing"  
Link: https://freesound.org/search/?q=whoosh+sword+swing  
Save as: `farming/scythe_swing.wav`

**6. Stone Mine**  
Search: "pickaxe stone"  
Link: https://freesound.org/search/?q=pickaxe+stone  
Save as: `farming/stone_mine.wav`

**7. Tree Chop**  
Search: "axe wood chop"  
Link: https://freesound.org/search/?q=axe+wood+chop  
Save as: `farming/tree_chop.wav`

**8. Cow Moo**  
Search: "cow moo"  
Link: https://freesound.org/search/?q=cow+moo  
Save as: `farming/cow_moo.wav`

---

### **COMBAT (8 sounds)**

**9. Sword Slash**  
Search: "sword slash whoosh"  
Link: https://freesound.org/search/?q=sword+slash+whoosh  
Save as: `combat/sword_slash.wav`

**10. Bow Release**  
Search: "bow arrow release"  
Link: https://freesound.org/search/?q=bow+arrow+release  
Save as: `combat/bow_release.wav`

**11. Zombie Hit**  
Search: "punch hit impact"  
Link: https://freesound.org/search/?q=punch+hit+impact  
Save as: `combat/zombie_hit.wav`

**12. Zombie Death**  
Search: "zombie groan death"  
Link: https://freesound.org/search/?q=zombie+groan+death  
Save as: `combat/zombie_death.wav`

**13. Player Hurt**  
Search: "male grunt pain"  
Link: https://freesound.org/search/?q=male+grunt+pain  
Save as: `combat/player_hurt.wav`

**14. Shield Block**  
Search: "metal shield block"  
Link: https://freesound.org/search/?q=metal+shield+block  
Save as: `combat/shield_block.wav`

**15. Explosion**  
Search: "explosion boom"  
Link: https://freesound.org/search/?q=explosion+boom  
Save as: `combat/explosion.wav`

**16. Raider Attack**  
Search: "battle shout"  
Link: https://freesound.org/search/?q=battle+shout  
Save as: `combat/raider_attack.wav`

---

### **BUILDING (5 sounds)**

**17. Chest Open**  
Search: "wooden chest open creak"  
Link: https://freesound.org/search/?q=wooden+chest+open  
Save as: `building/chest_open.wav`

**18. Door Open**  
Search: "wood door open"  
Link: https://freesound.org/search/?q=wood+door+open  
Save as: `building/door_open.wav`

**19. Door Close**  
Search: "wood door close"  
Link: https://freesound.org/search/?q=wood+door+close  
Save as: `building/door_close.wav`

**20. Hammer Nail**  
Search: "hammer nail wood"  
Link: https://freesound.org/search/?q=hammer+nail+wood  
Save as: `building/hammer_nail.wav`

**21. Repair**  
Search: "construction building"  
Link: https://freesound.org/search/?q=construction+building  
Save as: `building/repair.wav`

---

### **MISC (2 sounds)**

**22. Coin Collect**  
Search: "coin pickup"  
Link: https://freesound.org/search/?q=coin+pickup  
Save as: `misc/coin_collect.wav`

**23. Level Up**  
Search: "level up achievement"  
Link: https://freesound.org/search/?q=level+up+achievement  
Save as: `misc/level_up.wav`

---

## 🔄 **AFTER DOWNLOADING:**

### **Step 1: Create downloads folder**
```bash
mkdir -p /Users/davidkotnik/repos/novafarma/assets/audio/downloads
```

### **Step 2: Download all files to that folder**
(Use links above, save with proper names)

### **Step 3: Run conversion script**
```bash
cd /Users/davidkotnik/repos/novafarma
python3 scripts/convert_audio_to_ogg.py
```

This will:
- Convert all WAV → OGG
- Normalize volume to -14 LUFS
- Move to proper folders (music/, sfx/)
- Clean up downloads folder

### **Step 4: Test in game**
```bash
npm start
# Test audio triggers in TestVisualAudioScene
# Test music in GameScene
```

---

## 📊 **PROGRESS TRACKER:**

Music (7):
- [ ] main_theme.wav
- [ ] farm_ambient.wav
- [ ] town_theme.wav
- [ ] combat_theme.wav
- [ ] victory_theme.wav
- [ ] ana_theme.wav
- [x] night_theme.wav ✅

SFX Farming (8):
- [ ] plant_seed.wav
- [ ] water_crop.wav
- [ ] harvest.wav
- [ ] dig.wav
- [ ] scythe_swing.wav
- [ ] stone_mine.wav
- [ ] tree_chop.wav
- [ ] cow_moo.wav

SFX Combat (8):
- [ ] sword_slash.wav
- [ ] bow_release.wav
- [ ] zombie_hit.wav
- [ ] zombie_death.wav
- [ ] player_hurt.wav
- [ ] shield_block.wav
- [ ] explosion.wav
- [ ] raider_attack.wav

SFX Building (5):
- [ ] chest_open.wav
- [ ] door_open.wav
- [ ] door_close.wav
- [ ] hammer_nail.wav
- [ ] repair.wav

SFX Misc (2):
- [ ] coin_collect.wav
- [ ] level_up.wav

**Total:** 0/30 downloaded

---

## 💡 **TIPS:**

**Best Practice:**
1. Listen to preview before downloading
2. Choose short files (< 2s for SFX)
3. Prefer WAV format (higher quality)
4. Check license (CC0 or CC-BY)
5. Download multiple options if unsure

**Time Estimate:**
- Searching: ~1-2 min per file
- Downloading: ~30 sec per file
- Total: ~45-60 minutes for all 30 files

**Alternative:**
If Freesound.org is slow, try:
- OpenGameArt.org
- Zapsplat.com (requires free account)
- Sonniss.com (free game audio packs)

---

**Start downloading! Each file = 1 step closer to 100%!** 🎵