diff --git a/AUDIO_DOWNLOAD_QUICK_GUIDE.md b/AUDIO_DOWNLOAD_QUICK_GUIDE.md new file mode 100644 index 000000000..038b90d9f --- /dev/null +++ b/AUDIO_DOWNLOAD_QUICK_GUIDE.md @@ -0,0 +1,422 @@ +# 🎵 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!** 🎉