davidkotnik/novafarma
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e1cc570e29126bc8733bcf48f4ddbdc5819da366
novafarma/docs/AUDIO_DOWNLOAD_GUIDE.md
David Kotnik cbb2b64f92 ok
2026-01-20 01:05:17 +01:00

7.5 KiB
Raw Blame History

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

Reference in New Issue View Git Blame Copy Permalink