# 🎵 AUDIO DOWNLOAD QUICK GUIDE
## Step-by-Step Instructions for Getting DEMO Audio (45 files)

**Created:** January 9, 2026, 14:36 CET  
**Target:** DEMO Audio Complete (45 files)  
**Time:** ~1-2 hours total

---

## ✅ CHECKLIST OVERVIEW

- [ ] **Step 1:** Convert existing .wav → .ogg (15 min)
- [ ] **Step 2:** Download Kenney Sound Packs (30 min)
- [ ] **Step 3:** Download specific missing sounds (30-45 min)
- [ ] **Step 4:** Organize and test (15 min)

**Total:** ~1.5-2 hours → DEMO audio 100% ✅

---

## 📦 STEP 1: CONVERT EXISTING MUSIC (15 min)

### **What you have:**
- 8 music tracks as `.wav` files in `/assets/audio/music/`

### **What to do:**
```bash
cd /Users/davidkotnik/repos/novafarma
python3 scripts/convert_audio_to_ogg.py
```

**This converts:**
- `main_theme.wav` → `main_theme.ogg` ✅
- `farm_ambient.wav` → `farm_ambient.ogg` ✅
- `town_theme.wav` → `town_theme.ogg` ✅
- `combat_theme.wav` → `combat_theme.ogg` ✅
- `night_theme.wav` → `night_theme.ogg` ✅
- `victory_theme.wav` → `victory_theme.ogg` ✅
- `ana_theme.wav` → `ana_theme.ogg` ✅
- `raid_warning.wav` → `raid_warning.ogg` (if exists)

**Result:** 8/9 music tracks DONE! ✅

**Note:** You already have `forest_ambient.mp3` - that works!

---

## 📥 STEP 2: DOWNLOAD KENNEY PACKS (30 min)

### **🆓 Kenney.nl - FREE Sound Library**

**URL:** https://kenney.nl/assets?q=audio

### **Packs to download:**

#### **1. RPG Audio Pack**
- **URL:** https://kenney.nl/assets/rpg-audio
- **Size:** ~50 MB
- **Contains:** Sword swings, bow shots, magic, footsteps, UI sounds
- **License:** CC0 (completely free!)

**Download → Extract → You'll get:**
- `sword1.ogg` → rename to `sword_slash.ogg`
- `footstep_grass.ogg` ✅
- `footstep_stone.ogg` ✅
- `bow_shoot.ogg` → rename to `bow_release.ogg`
- `ui_click.ogg` ✅
- `ui_hover.ogg` (might need to find)
- `coin1.ogg` → rename to `coin_collect.ogg`

#### **2. Impact Sounds Pack**
- **URL:** https://kenney.nl/assets/impact-sounds
- **Size:** ~30 MB
- **Contains:** Hits, explosions, crashes, hammering
- **License:** CC0

**Download → Extract → You'll get:**
- `wood_hit.ogg` → rename to `hammer_nail.ogg`
- `explosion.ogg` ✅
- `stone_hit.ogg` → rename to `stone_mine.ogg`

#### **3. Interface Sounds Pack**
- **URL:** https://kenney.nl/assets/interface-sounds
- **Size:** ~20 MB
- **Contains:** UI clicks, errors, confirmations
- **License:** CC0

**Download → Extract → You'll get:**
- `click1.ogg` → `ui_click.ogg`
- `error.ogg` → `ui_error.ogg`
- `confirm.ogg` → `ui_confirm.ogg`
- `select.ogg` → `ui_hover.ogg`

#### **4. Digital Audio Pack**
- **URL:** https://kenney.nl/assets/digital-audio
- **Size:** ~15 MB
- **Contains:** Power ups, level ups, achievements
- **License:** CC0

**Download → Extract → You'll get:**
- `powerUp.ogg` → rename to `level_up.ogg`

**After Kenney downloads:** ~15-20 SFX ready! 🎉

---

## 🔍 STEP 3: DOWNLOAD SPECIFIC SOUNDS (30-45 min)

### **Freesound.org - Community Library**

**URL:** https://freesound.org

**You'll need to:**
1. Create FREE account (2 min)
2. Search for specific sounds
3. Download (must be .ogg or .wav)

### **Sounds to get from Freesound:**

#### **Farming Sounds (8 needed):**

**1. `dig.ogg`** - Digging/hoeing
- Search: "shovel dig soil"
- Look for: Short (1s), dirt sound
- Example: https://freesound.org/search/?q=shovel+dig

**2. `plant_seed.ogg`** - Planting
- Search: "plant seed soil"
- Look for: Soft plop sound
- Can use: Soft thud/drop sound

**3. `water_crop.ogg`** - Watering
- Search: "water pour splash"
- Look for: 1-2s water pouring

**4. `harvest.ogg`** - Harvest pickup
- Search: "crop harvest snap"
- Look for: Satisfying pop/snap

**5. `scythe_swing.ogg`** - Scythe
- Search: "scythe swing whoosh"
- Can use: Sword whoosh from Kenney!

**6. `tree_chop.ogg`** - Already have as `wood_chop.wav`!
- Just convert: Already done! ✅

**7. `cow_moo.ogg`** - Cow sound
- Search: "cow moo"
- Look for: Friendly farm cow

**8. `stone_mine.ogg`** - From Kenney Impact pack!

---

#### **Combat Sounds (8 needed):**

**Most from Kenney RPG Audio pack!**

**Missing ones:**

**1. `zombie_hit.ogg`** - Zombie hurt
- Search: "zombie groan hurt"
- Look for: Short grunt

**2. `zombie_death.ogg`** - Zombie dies
- Search: "zombie death groan"
- Look for: 1-2s death sound

**3. `player_hurt.ogg`** - Player damage
- Search: "male grunt hurt oof"
- Look for: Short pain sound

**4. `raider_attack.ogg`** - Enemy yell
- Search: "war cry yell attack"
- Look for: Aggressive shout

**5. `shield_block.ogg`** - Shield block
- Search: "shield block metal"
- From Kenney Impact pack!

---

#### **Building Sounds (5 needed):**

**Most from Kenney!**

**Missing ones:**

**1. `door_open.ogg`** - Door opening
- Search: "door creak open wood"
- Look for: Creaky hinge sound

**2. `door_close.ogg`** - Door closing
- Search: "door close slam wood"
- Look for: Wood door slam

**3. `chest_open.ogg`** - Chest
- Search: "chest open treasure wood"
- From Kenney RPG Audio!

**4. `repair.ogg`** - Building repair
- Can use: Multiple hammer hits
- Or: Construction sounds

---

## 🌀 STEP 4: AMBIENT LOOPS (3 files)

### **OpenGameArt.org**

**URL:** https://opengameart.org/art-search-advanced?keys=&field_art_type_tid%5B%5D=13

**1. `wind_gentle.ogg`** - Gentle wind
- Search: "wind loop ambient"
- Look for: Seamless loop, peaceful

**2. `crickets_night.ogg`** - Night crickets
- Search: "crickets night loop"
- Look for: Seamless loop, nighttime

**3. `birds_daytime.ogg`** - Day birds
- Search: "birds chirping loop"
- Look for: Seamless loop, peaceful

**Tip:** Look for "seamless loop" or "loopable" tags!

---

## 📁 FILE ORGANIZATION

### **Where to put files:**

```
/Users/davidkotnik/repos/novafarma/assets/audio/

├── music/
│   ├── main_theme.ogg           ✅ (convert .wav)
│   ├── farm_ambient.ogg         ✅ (convert .wav)
│   ├── night_theme.ogg          ✅ (convert .wav)
│   ├── forest_ambient.mp3       ✅ (already have!)
│   ├── combat_theme.ogg         ✅ (convert .wav)
│   ├── victory_theme.ogg        ✅ (convert .wav)
│   ├── raid_warning.ogg         ⚠️ (need to find/make)
│   ├── town_theme.ogg           ✅ (convert .wav)
│   └── ana_theme.ogg            ✅ (convert .wav)
│
├── sfx/
│   ├── farming/
│   │   ├── dig.ogg              📥 (Freesound)
│   │   ├── plant_seed.ogg       📥 (Freesound)
│   │   ├── water_crop.ogg       📥 (Freesound)
│   │   ├── harvest.ogg          📥 (Freesound)
│   │   ├── tree_chop.ogg        ✅ (have wood_chop.wav)
│   │   ├── stone_mine.ogg       📥 (Kenney Impact)
│   │   ├── scythe_swing.ogg     📥 (Kenney RPG or Freesound)
│   │   └── cow_moo.ogg          📥 (Freesound)
│   │
│   ├── combat/
│   │   ├── sword_slash.ogg      📥 (Kenney RPG)
│   │   ├── zombie_hit.ogg       📥 (Freesound)
│   │   ├── zombie_death.ogg     📥 (Freesound)
│   │   ├── player_hurt.ogg      📥 (Freesound)
│   │   ├── bow_release.ogg      📥 (Kenney RPG)
│   │   ├── shield_block.ogg     📥 (Kenney Impact)
│   │   ├── explosion.ogg        📥 (Kenney Impact)
│   │   └── raider_attack.ogg    📥 (Freesound)
│   │
│   ├── building/
│   │   ├── hammer_nail.ogg      📥 (Kenney Impact)
│   │   ├── repair.ogg           📥 (Kenney or Freesound)
│   │   ├── door_open.ogg        📥 (Freesound)
│   │   ├── door_close.ogg       📥 (Freesound)
│   │   └── chest_open.ogg       📥 (Kenney RPG)
│   │
│   └── misc/
│       ├── footstep_grass.ogg   📥 (Kenney RPG)
│       ├── footstep_stone.ogg   📥 (Kenney RPG)
│       ├── coin_collect.ogg     📥 (Kenney Interface)
│       └── level_up.ogg         📥 (Kenney Digital)
│
├── ambient/
│   ├── wind_gentle.ogg          📥 (OpenGameArt)
│   ├── crickets_night.ogg       📥 (OpenGameArt)
│   └── birds_daytime.ogg        📥 (OpenGameArt)
│
└── ui/
    ├── ui_click.ogg             📥 (Kenney Interface)
    ├── ui_hover.ogg             📥 (Kenney Interface)
    ├── ui_error.ogg             📥 (Kenney Interface)
    ├── ui_confirm.ogg           📥 (Kenney Interface)
    ├── quest_complete.ogg       📥 (Kenney Digital)
    ├── danger_stinger.ogg       📥 (Freesound or OpenGameArt)
    ├── discovery_stinger.ogg    📥 (Kenney Digital)
    └── sleep_heal.ogg           📥 (Kenney Digital or Freesound)
```

---

## ✅ FINAL CHECKLIST

### **After downloading:**

**Music (9 files):**
- [x] main_theme.ogg
- [x] farm_ambient.ogg
- [x] night_theme.ogg
- [x] forest_ambient.mp3
- [x] combat_theme.ogg
- [x] victory_theme.ogg
- [ ] raid_warning.ogg
- [x] town_theme.ogg
- [x] ana_theme.ogg

**SFX - Farming (8 files):**
- [ ] dig.ogg
- [ ] plant_seed.ogg
- [ ] water_crop.ogg
- [ ] harvest.ogg
- [x] tree_chop.ogg (wood_chop.wav)
- [ ] stone_mine.ogg
- [ ] scythe_swing.ogg
- [ ] cow_moo.ogg

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

**SFX - Building (5 files):**
- [ ] hammer_nail.ogg
- [ ] repair.ogg
- [ ] door_open.ogg
- [ ] door_close.ogg
- [ ] chest_open.ogg

**SFX - Misc (4 files):**
- [ ] footstep_grass.ogg
- [ ] footstep_stone.ogg
- [ ] coin_collect.ogg
- [ ] level_up.ogg

**Ambient (3 files):**
- [ ] wind_gentle.ogg
- [ ] crickets_night.ogg
- [ ] birds_daytime.ogg

**UI (8 files):**
- [ ] ui_click.ogg
- [ ] ui_hover.ogg
- [ ] ui_error.ogg
- [ ] ui_confirm.ogg
- [ ] quest_complete.ogg
- [ ] danger_stinger.ogg
- [ ] discovery_stinger.ogg
- [ ] sleep_heal.ogg

**TOTAL: 45 files**

---

## 🎯 QUICK LINKS SUMMARY

### **Main Resources:**

1. **Kenney.nl** - https://kenney.nl/assets?q=audio
   - RPG Audio: https://kenney.nl/assets/rpg-audio
   - Impact Sounds: https://kenney.nl/assets/impact-sounds
   - Interface Sounds: https://kenney.nl/assets/interface-sounds
   - Digital Audio: https://kenney.nl/assets/digital-audio

2. **Freesound.org** - https://freesound.org
   - Create account (free!)
   - Search for specific sounds

3. **OpenGameArt** - https://opengameart.org
   - Audio category: https://opengameart.org/art-search-advanced?keys=&field_art_type_tid%5B%5D=13

---

## 💡 TIPS

### **Finding Good Sounds:**

1. **Listen before downloading!** Most sites have preview
2. **Check license:** Must be CC0, CC-BY, or public domain
3. **File format:** .ogg preferred, .wav or .mp3 also work
4. **Duration:** Keep SFX short (0.5-2s), ambient can be longer
5. **Quality:** 44.1kHz sampling rate is standard

### **If sound is .mp3 or .wav:**
No problem! Game engine (Phaser 3) supports all formats!
But .ogg is smaller file size = faster loading.

Convert with: `ffmpeg -i input.mp3 output.ogg`

---

## 🚀 WHEN YOU'RE DONE

**Message me with:**
1. How many files you got (out of 45)
2. Which ones you couldn't find
3. Ready to test/organize!

**I'll help you:**
- Convert any .mp3/.wav to .ogg if needed
- Find alternatives for missing sounds
- Test audio in game
- Clean up organization

**GOOD LUCK!** 💪🎵

---

**Status:** ✅ **DOWNLOAD GUIDE READY!**  
**Target:** 45 DEMO audio files  
**Let me know when done!** 🎉