Files
novafarma/AUDIO_DOWNLOAD_GUIDE.md
David Kotnik 263b0259a7 📋 Jan 8 Final Demo TODO - Audio Priority
 CREATED AUDIO DOWNLOAD GUIDE:

**File:** AUDIO_DOWNLOAD_GUIDE.md

**Contents:**
- Direct Freesound.org links for all 30 files
- 7 music tracks + 23 SFX
- Proper naming conventions
- Download workflow
- Conversion instructions
- Progress tracker

**User Decision:**
-  Audio replacement = Priority 1
-  Farming mechanics = Priority 2 (already exists!)
- ⏸️ Tiled map = LATER (after systems complete)

**Status Check:**
-  FarmingSystem.js exists and functional
-  Already integrated in GameScene
-  Has: tillSoil, plantSeed, harvestCrop, updateDay
-  Ready to use, just needs testing

**Next Steps:**
1. Download 30 audio files (45-60 min)
2. Run conversion script (5 min)
3. Test farming in GameScene (15 min)

**Demo Completion Path:**
1. Audio (this session)
2. Farming test (this session)
3. Tiled map (future session)
2026-01-08 18:02:52 +01:00

7.5 KiB

🎵 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

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

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

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
  • 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%! 🎵