claude-code-sounds 1.1.1 → 1.2.0

package/themes/mgs/theme.json

@@ -0,0 +1,103 @@
+{
+  "name": "Metal Gear Solid",
+  "description": "Iconic Metal Gear Solid sound effects — codec calls, alert sounds, and Snake voice lines",
+  "author": "ryparker",
+  "srcBase": "MGS",
+  "sounds": {
+    "start": {
+      "description": "Session starting — codec call incoming",
+      "files": [
+        { "src": "@myinstants/codec.mp3", "name": "codec-call.mp3" },
+        { "src": "@myinstants/metalgearcodec.mp3", "name": "codec-ring.mp3" },
+        { "src": "@myinstants/mgs2-snake-kept-you-waiting-huh.mp3", "name": "kept-you-waiting-huh.mp3" },
+        { "src": "@myinstants/codec-send.mp3", "name": "this-is-snake.mp3" }
+      ]
+    },
+    "end": {
+      "description": "Session over — mission complete",
+      "files": [
+        { "src": "@myinstants/metal_gear_solid_exit_sound_effect.mp3", "name": "codec-exit.mp3" },
+        { "src": "@myinstants/metal_gear_solid_exit_sound_effect_EQbXTbY.mp3", "name": "codec-close.mp3" },
+        { "src": "@myinstants/mgs2-snake-sweet-dreams-boyscout.mp3", "name": "sweet-dreams.mp3" },
+        { "src": "@myinstants/sfx_s_mission_qualify.mp3", "name": "mission-complete.mp3" }
+      ]
+    },
+    "prompt": {
+      "description": "User submitted prompt — acknowledging orders",
+      "files": [
+        { "src": "@myinstants/mgs2-snake-roger-that-sir.mp3", "name": "roger-that.mp3" },
+        { "src": "@myinstants/mgs2-snake-sounds-like-a-plan.mp3", "name": "sounds-like-a-plan.mp3" },
+        { "src": "@myinstants/mgs2-snake-ill-do-my-best.mp3", "name": "ill-do-my-best.mp3" },
+        { "src": "@myinstants/mgs2-snake-if-you-say-so.mp3", "name": "if-you-say-so.mp3" }
+      ]
+    },
+    "stop": {
+      "description": "Done responding — codec transmission end",
+      "files": [
+        { "src": "@myinstants/metal_gear_solid_exit_sound_effect.mp3", "name": "codec-hangup.mp3" },
+        { "src": "@myinstants/mgs2-snake-roger-that-sir.mp3", "name": "roger-that.mp3" },
+        { "src": "@myinstants/mgs2-snake-good-shooting.mp3", "name": "good-shooting.mp3" }
+      ]
+    },
+    "permission": {
+      "description": "Permission prompt — alert detected",
+      "files": [
+        { "src": "@myinstants/tindeck_1.mp3", "name": "alert.mp3" },
+        { "src": "@myinstants/metal-gear-alert-sound-effect_XKoHReZ.mp3", "name": "alert-sfx.mp3" },
+        { "src": "@myinstants/what-was-that-noise.mp3", "name": "what-was-that-noise.mp3" },
+        { "src": "@myinstants/untitled_1150.mp3", "name": "alert-mode.mp3" }
+      ]
+    },
+    "idle": {
+      "description": "Waiting for input — standing by",
+      "files": [
+        { "src": "@myinstants/mgs2-snake-kept-you-waiting-huh.mp3", "name": "kept-you-waiting.mp3" },
+        { "src": "@myinstants/why_are_we_still_here_just_to_suffer_2.mp3", "name": "just-to-suffer.mp3" },
+        { "src": "@myinstants/cigar.mp3", "name": "cigar.mp3" }
+      ]
+    },
+    "subagent": {
+      "description": "Spawning subagent — calling for backup",
+      "files": [
+        { "src": "@myinstants/codec.mp3", "name": "codec-call-out.mp3" },
+        { "src": "@myinstants/metalgearcodec.mp3", "name": "codec-dial.mp3" },
+        { "src": "@myinstants/mgs2-snake-sounds-like-a-plan.mp3", "name": "sounds-like-a-plan.mp3" }
+      ]
+    },
+    "error": {
+      "description": "Tool failure — game over",
+      "files": [
+        { "src": "@myinstants/metalgeargameov5235.mp3", "name": "game-over.mp3" },
+        { "src": "@myinstants/metal-gear-solid-solid-snake-scream.mp3", "name": "snake-scream.mp3" },
+        { "src": "@myinstants/snake-dies-game-over.mp3", "name": "snake-dies.mp3" },
+        { "src": "@myinstants/metal_gear_solid_game_over_screen_clean_background-1.mp3", "name": "game-over-screen.mp3" },
+        { "src": "@myinstants/mgs2-snake-what-the-hell-is-going-on-here.mp3", "name": "what-the-hell.mp3" }
+      ]
+    },
+    "task-completed": {
+      "description": "Task finished — mission accomplished",
+      "files": [
+        { "src": "@myinstants/youre-pretty-good_I5kzLtx.mp3", "name": "youre-pretty-good.mp3" },
+        { "src": "@myinstants/sfx_s_mission_qualify.mp3", "name": "mission-qualify.mp3" },
+        { "src": "@myinstants/mgs2-snake-good-shooting.mp3", "name": "good-shooting.mp3" },
+        { "src": "@myinstants/metal-gear-item-drop.mp3", "name": "item-drop.mp3" }
+      ]
+    },
+    "compact": {
+      "description": "Context compaction — stealth camo engaged",
+      "files": [
+        { "src": "@myinstants/metalgearsolid.swf.mp3", "name": "game-over-fade.mp3" },
+        { "src": "@myinstants/original-metal-gear-solid-game-over-screen.mp3", "name": "original-game-over.mp3" },
+        { "src": "@myinstants/ocelot-meowing.mp3", "name": "ocelot-meow.mp3" }
+      ]
+    },
+    "teammate-idle": {
+      "description": "Teammate went idle — waiting on comms",
+      "files": [
+        { "src": "@myinstants/codec.mp3", "name": "codec-beep.mp3" },
+        { "src": "@myinstants/mgs2-snake-friendly-fire.mp3", "name": "friendly-fire.mp3" },
+        { "src": "@myinstants/what-was-that-noise.mp3", "name": "what-was-that.mp3" }
+      ]
+    }
+  }
+}

package/themes/pokemon-gen1/download.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+#
+# Downloads sound files for the pokemon-gen1 theme.
+# Called by install.sh with $1 = target sounds directory, $2 = temp directory.
+#
+set -e
+
+# shellcheck disable=SC2034  # passed by install.sh, reserved for theme use
+SOUNDS_DIR="$1"
+TMP_DIR="$2"
+PKM_DIR="$TMP_DIR/PokemonGen1"
+
+mkdir -p "$PKM_DIR/SFX" "$PKM_DIR/Cries" "$PKM_DIR/Attacks"
+
+# --- General sound effects (menu, items, battle UI) ---
+echo "  Downloading Pokemon Red/Blue general sound effects..."
+SFX_ZIP="$TMP_DIR/pokemon-sfx.zip"
+curl -sL -o "$SFX_ZIP" \
+  "https://sounds.spriters-resource.com/media/assets/408/410769.zip?updated=1755537434"
+
+if ! file "$SFX_ZIP" | grep -q "Zip"; then
+  echo "  Error: Failed to download general sound effects pack."
+  exit 1
+fi
+
+unzip -qo "$SFX_ZIP" -d "$TMP_DIR"
+cp "$TMP_DIR/Pokemon Red_Blue Sound Effects/"*.wav "$PKM_DIR/SFX/"
+
+# --- Pokemon cries (151 original cries) ---
+echo "  Downloading Pokemon Gen 1 cries..."
+CRIES_ZIP="$TMP_DIR/pokemon-cries.zip"
+curl -sL -o "$CRIES_ZIP" \
+  "https://sounds.spriters-resource.com/media/assets/411/413821.zip?updated=1755538954"
+
+if ! file "$CRIES_ZIP" | grep -q "Zip"; then
+  echo "  Error: Failed to download Pokemon cries pack."
+  exit 1
+fi
+
+unzip -qo "$CRIES_ZIP" -d "$TMP_DIR"
+cp "$TMP_DIR/Pokemon RBY Cries/"*.wav "$PKM_DIR/Cries/"
+
+# --- Attack move sound effects ---
+echo "  Downloading Pokemon Gen 1 attack move sounds..."
+ATTACKS_ZIP="$TMP_DIR/pokemon-attacks.zip"
+curl -sL -o "$ATTACKS_ZIP" \
+  "https://sounds.spriters-resource.com/media/assets/408/410768.zip?updated=1755537433"
+
+if ! file "$ATTACKS_ZIP" | grep -q "Zip"; then
+  echo "  Error: Failed to download attack move sound effects pack."
+  exit 1
+fi
+
+unzip -qo "$ATTACKS_ZIP" -d "$TMP_DIR/pokemon-attacks-raw"
+
+# Copy only the specific attack sounds used by this theme
+ATTACK_FILES=(
+  "Screech.wav"
+  "Rest.wav"
+  "Teleport.wav"
+  "Confused.wav"
+  "SelfDestruct.wav"
+  "Splash.wav"
+  "Substitute.wav"
+)
+
+for FILE in "${ATTACK_FILES[@]}"; do
+  if [ -f "$TMP_DIR/pokemon-attacks-raw/$FILE" ]; then
+    cp "$TMP_DIR/pokemon-attacks-raw/$FILE" "$PKM_DIR/Attacks/"
+  else
+    echo "    Warning: Attack sound $FILE not found in archive."
+  fi
+done
+
+echo "  Download complete."

package/themes/pokemon-gen1/theme.json

@@ -0,0 +1,112 @@
+{
+  "name": "Pokemon Gen 1",
+  "description": "Pokemon Red/Blue/Yellow sound effects — cries, battle sounds, and menu bleeps from Kanto",
+  "author": "ryparker",
+  "srcBase": "PokemonGen1",
+  "sounds": {
+    "start": {
+      "description": "Session starting — a wild Claude appeared!",
+      "files": [
+        { "src": "SFX/SFX_INTRO_LUNGE.wav", "name": "intro-lunge.wav" },
+        { "src": "SFX/SFX_BALL_TOSS.wav", "name": "ball-toss.wav" },
+        { "src": "SFX/SFX_BALL_POOF.wav", "name": "ball-poof.wav" },
+        { "src": "Cries/025.wav", "name": "pikachu-cry.wav" },
+        { "src": "SFX/SFX_INTRO_WHOOSH.wav", "name": "intro-whoosh.wav" }
+      ]
+    },
+    "end": {
+      "description": "Session over — Pokemon Center healed up",
+      "files": [
+        { "src": "SFX/SFX_HEAL_UP.wav", "name": "heal-up.wav" },
+        { "src": "SFX/SFX_SAVE.wav", "name": "save-game.wav" },
+        { "src": "SFX/SFX_GO_OUTSIDE.wav", "name": "go-outside.wav" },
+        { "src": "SFX/SFX_TURN_OFF_PC.wav", "name": "turn-off-pc.wav" }
+      ]
+    },
+    "prompt": {
+      "description": "User submitted prompt — menu select acknowledgment",
+      "files": [
+        { "src": "SFX/SFX_PRESS_AB.wav", "name": "press-ab.wav" },
+        { "src": "SFX/SFX_START_MENU.wav", "name": "start-menu.wav" },
+        { "src": "SFX/SFX_TINK.wav", "name": "tink.wav" },
+        { "src": "SFX/SFX_SWAP.wav", "name": "swap.wav" }
+      ]
+    },
+    "stop": {
+      "description": "Done responding — move learned, task complete",
+      "files": [
+        { "src": "SFX/SFX_GET_ITEM_1.wav", "name": "get-item.wav" },
+        { "src": "SFX/SFX_DEX_PAGE_ADDED.wav", "name": "dex-page-added.wav" },
+        { "src": "SFX/SFX_PURCHASE.wav", "name": "purchase.wav" },
+        { "src": "SFX/SFX_HEAL_AILMENT.wav", "name": "heal-ailment.wav" }
+      ]
+    },
+    "permission": {
+      "description": "Permission prompt — wild encounter alert!",
+      "files": [
+        { "src": "SFX/SFX_COLLISION.wav", "name": "collision.wav" },
+        { "src": "SFX/SFX_SILPH_SCOPE.wav", "name": "silph-scope.wav" },
+        { "src": "SFX/SFX_DENIED.wav", "name": "denied.wav" },
+        { "src": "Attacks/Screech.wav", "name": "screech.wav" }
+      ]
+    },
+    "idle": {
+      "description": "Waiting for input — idle Pokemon waiting",
+      "files": [
+        { "src": "SFX/SFX_SLOTS_STOP_WHEEL.wav", "name": "slots-stop.wav" },
+        { "src": "SFX/SFX_POISONED.wav", "name": "poisoned.wav" },
+        { "src": "Cries/054.wav", "name": "psyduck-cry.wav" },
+        { "src": "Attacks/Rest.wav", "name": "rest.wav" }
+      ]
+    },
+    "subagent": {
+      "description": "Spawning subagent — I choose you!",
+      "files": [
+        { "src": "SFX/SFX_BALL_TOSS.wav", "name": "pokeball-throw.wav" },
+        { "src": "SFX/SFX_BALL_POOF.wav", "name": "pokeball-open.wav" },
+        { "src": "SFX/SFX_SWITCH.wav", "name": "pokemon-switch.wav" },
+        { "src": "Cries/006.wav", "name": "charizard-cry.wav" },
+        { "src": "Attacks/Teleport.wav", "name": "teleport.wav" }
+      ]
+    },
+    "error": {
+      "description": "Tool failure — it's not very effective...",
+      "files": [
+        { "src": "SFX/SFX_FAINT_FALL.wav", "name": "faint-fall.wav" },
+        { "src": "SFX/SFX_FAINT_THUD.wav", "name": "faint-thud.wav" },
+        { "src": "Attacks/Confused.wav", "name": "confused.wav" },
+        { "src": "Attacks/SelfDestruct.wav", "name": "self-destruct.wav" },
+        { "src": "Attacks/Splash.wav", "name": "splash.wav" }
+      ]
+    },
+    "task-completed": {
+      "description": "Task finished — badge earned, level up!",
+      "files": [
+        { "src": "SFX/SFX_LEVEL_UP.wav", "name": "level-up.wav" },
+        { "src": "SFX/SFX_GET_KEY_ITEM.wav", "name": "get-key-item.wav" },
+        { "src": "SFX/SFX_GET_ITEM_2.wav", "name": "get-item-fanfare.wav" },
+        { "src": "SFX/SFX_CAUGHT_MON.wav", "name": "caught-mon.wav" },
+        { "src": "SFX/SFX_POKEDEX_RATING.wav", "name": "pokedex-rating.wav" }
+      ]
+    },
+    "compact": {
+      "description": "Context compaction — PC storage and transformation",
+      "files": [
+        { "src": "SFX/SFX_ENTER_PC.wav", "name": "enter-pc.wav" },
+        { "src": "SFX/SFX_WITHDRAW_DEPOSIT.wav", "name": "withdraw-deposit.wav" },
+        { "src": "SFX/SFX_SHRINK.wav", "name": "shrink.wav" },
+        { "src": "Attacks/Substitute.wav", "name": "substitute.wav" },
+        { "src": "SFX/SFX_TRADE_MACHINE.wav", "name": "trade-machine.wav" }
+      ]
+    },
+    "teammate-idle": {
+      "description": "Teammate went idle — a Pokemon is waiting",
+      "files": [
+        { "src": "Cries/025.wav", "name": "pikachu-cry.wav" },
+        { "src": "Cries/039.wav", "name": "jigglypuff-cry.wav" },
+        { "src": "SFX/SFX_SLOTS_NEW_SPIN.wav", "name": "slots-new-spin.wav" },
+        { "src": "SFX/SFX_LEDGE.wav", "name": "ledge.wav" }
+      ]
+    }
+  }
+}

package/themes/portal/download.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+#
+# Downloads sound files for the portal theme.
+# Called by install.sh with $1 = target sounds directory, $2 = temp directory.
+#
+set -e
+
+# shellcheck disable=SC2034  # passed by install.sh, reserved for theme use
+SOUNDS_DIR="$1"
+TMP_DIR="$2"
+PORTAL_DIR="$TMP_DIR/Portal2"
+
+BASE_URL="https://raw.githubusercontent.com/sourcesounds/portal2/master/sound"
+
+# All unique sound files needed by this theme, organized by subdirectory
+declare -A DIRS
+DIRS=(
+  [weapons/portalgun]="
+    portalgun_powerup1.wav
+    portal_open1.wav
+    portal_close1.wav
+    portal_close2.wav
+    portal_enter_01.wav
+    portal_exit_01.wav
+    portalgun_shoot_blue1.wav
+    portalgun_shoot_red1.wav
+    portal_fizzle_01.wav
+    portal_invalid_surface_01.wav
+  "
+  [npc/turret_floor]="
+    active.wav
+    alert.wav
+    ping.wav
+    retract.wav
+    turret_active_1.wav
+    turret_autosearch_1.wav
+    turret_autosearch_2.wav
+    turret_search_1.wav
+    turret_search_2.wav
+    turret_deploy_1.wav
+    turret_retire_1.wav
+    turret_retire_2.wav
+    turret_shotat_1.wav
+    turret_disabled_1.wav
+  "
+  [npc/sphere]="
+    corrupt_core_attach_01.wav
+    sphere_attach.wav
+  "
+  [buttons]="
+    button_synth_positive_01.wav
+    button_synth_negative_01.wav
+    portal_button_down_01.wav
+    portal_button_up_01.wav
+    og_test_chamber_pos_01.wav
+  "
+  [ui]="
+    buttonclick.wav
+  "
+  [alarms]="
+    klaxon1.wav
+  "
+  [vfx]="
+    fizzler_start_01.wav
+    fizzler_shutdown_01.wav
+  "
+  [props]="
+    material_emancipation_01.wav
+    post_message_announcer_01.wav
+  "
+)
+
+echo "  Downloading Portal 2 sounds..."
+
+FAILED=0
+TOTAL=0
+
+for DIR in "${!DIRS[@]}"; do
+  mkdir -p "$PORTAL_DIR/$DIR"
+  for FILE in ${DIRS[$DIR]}; do
+    TOTAL=$((TOTAL + 1))
+    curl -sL -o "$PORTAL_DIR/$DIR/$FILE" "$BASE_URL/$DIR/$FILE"
+    if [ ! -s "$PORTAL_DIR/$DIR/$FILE" ]; then
+      echo "    Warning: Failed to download $DIR/$FILE"
+      rm -f "$PORTAL_DIR/$DIR/$FILE"
+      FAILED=$((FAILED + 1))
+    fi
+  done
+done
+
+if [ "$FAILED" -gt 0 ]; then
+  echo "  Warning: $FAILED of $TOTAL file(s) failed to download."
+fi
+
+echo "  Download complete ($((TOTAL - FAILED))/$TOTAL files)."

package/themes/portal/theme.json

@@ -0,0 +1,105 @@
+{
+  "name": "Portal",
+  "description": "Portal 2 sound effects — turrets, portal guns, GLaDOS alerts, and Aperture Science ambiance",
+  "author": "ryparker",
+  "srcBase": "Portal2",
+  "sounds": {
+    "start": {
+      "description": "Session starting — test chamber initiated",
+      "files": [
+        { "src": "weapons/portalgun/portalgun_powerup1.wav", "name": "portalgun-powerup.wav" },
+        { "src": "npc/turret_floor/active.wav", "name": "turret-activated.wav" },
+        { "src": "weapons/portalgun/portal_open1.wav", "name": "portal-open.wav" },
+        { "src": "buttons/og_test_chamber_pos_01.wav", "name": "test-chamber-start.wav" }
+      ]
+    },
+    "end": {
+      "description": "Session over — test complete",
+      "files": [
+        { "src": "weapons/portalgun/portal_close1.wav", "name": "portal-close.wav" },
+        { "src": "weapons/portalgun/portal_close2.wav", "name": "portal-close-alt.wav" },
+        { "src": "npc/turret_floor/turret_retire_1.wav", "name": "turret-goodbye.wav" },
+        { "src": "vfx/fizzler_shutdown_01.wav", "name": "fizzler-shutdown.wav" }
+      ]
+    },
+    "prompt": {
+      "description": "User submitted prompt — input received",
+      "files": [
+        { "src": "buttons/button_synth_positive_01.wav", "name": "button-positive.wav" },
+        { "src": "buttons/portal_button_down_01.wav", "name": "button-press.wav" },
+        { "src": "ui/buttonclick.wav", "name": "ui-click.wav" },
+        { "src": "weapons/portalgun/portal_enter_01.wav", "name": "portal-enter.wav" }
+      ]
+    },
+    "stop": {
+      "description": "Done responding — task acknowledged",
+      "files": [
+        { "src": "buttons/button_synth_positive_01.wav", "name": "synth-positive.wav" },
+        { "src": "buttons/portal_button_up_01.wav", "name": "button-release.wav" },
+        { "src": "weapons/portalgun/portal_exit_01.wav", "name": "portal-exit.wav" },
+        { "src": "npc/turret_floor/turret_retire_2.wav", "name": "turret-done.wav" }
+      ]
+    },
+    "permission": {
+      "description": "Permission prompt — turret alert",
+      "files": [
+        { "src": "npc/turret_floor/turret_search_1.wav", "name": "turret-whos-there.wav" },
+        { "src": "npc/turret_floor/alert.wav", "name": "turret-alert.wav" },
+        { "src": "alarms/klaxon1.wav", "name": "klaxon-alarm.wav" },
+        { "src": "npc/turret_floor/turret_active_1.wav", "name": "turret-i-see-you.wav" }
+      ]
+    },
+    "idle": {
+      "description": "Waiting for input — are you still there?",
+      "files": [
+        { "src": "npc/turret_floor/turret_autosearch_1.wav", "name": "turret-are-you-still-there.wav" },
+        { "src": "npc/turret_floor/turret_autosearch_2.wav", "name": "turret-searching.wav" },
+        { "src": "npc/turret_floor/turret_search_2.wav", "name": "turret-hello.wav" },
+        { "src": "npc/turret_floor/ping.wav", "name": "turret-ping.wav" }
+      ]
+    },
+    "subagent": {
+      "description": "Spawning subagent — deploying through portal",
+      "files": [
+        { "src": "weapons/portalgun/portalgun_shoot_blue1.wav", "name": "shoot-blue-portal.wav" },
+        { "src": "weapons/portalgun/portalgun_shoot_red1.wav", "name": "shoot-orange-portal.wav" },
+        { "src": "npc/turret_floor/turret_deploy_1.wav", "name": "turret-deploy.wav" },
+        { "src": "npc/sphere/corrupt_core_attach_01.wav", "name": "core-attach.wav" }
+      ]
+    },
+    "error": {
+      "description": "Tool failure — fizzled",
+      "files": [
+        { "src": "npc/turret_floor/turret_shotat_1.wav", "name": "turret-ow.wav" },
+        { "src": "weapons/portalgun/portal_fizzle_01.wav", "name": "portal-fizzle.wav" },
+        { "src": "props/material_emancipation_01.wav", "name": "emancipation-grill.wav" },
+        { "src": "buttons/button_synth_negative_01.wav", "name": "synth-negative.wav" },
+        { "src": "weapons/portalgun/portal_invalid_surface_01.wav", "name": "invalid-surface.wav" }
+      ]
+    },
+    "task-completed": {
+      "description": "Task finished — test chamber complete",
+      "files": [
+        { "src": "buttons/og_test_chamber_pos_01.wav", "name": "test-chamber-complete.wav" },
+        { "src": "npc/sphere/sphere_attach.wav", "name": "core-complete.wav" },
+        { "src": "props/post_message_announcer_01.wav", "name": "announcer-post.wav" }
+      ]
+    },
+    "compact": {
+      "description": "Context compaction — memory fizzling",
+      "files": [
+        { "src": "vfx/fizzler_start_01.wav", "name": "fizzler-start.wav" },
+        { "src": "npc/turret_floor/retract.wav", "name": "turret-retract.wav" },
+        { "src": "weapons/portalgun/portal_close1.wav", "name": "portal-whoosh-close.wav" }
+      ]
+    },
+    "teammate-idle": {
+      "description": "Teammate went idle — turret lost target",
+      "files": [
+        { "src": "npc/turret_floor/turret_search_1.wav", "name": "turret-target-lost.wav" },
+        { "src": "npc/turret_floor/turret_autosearch_1.wav", "name": "turret-hellooo.wav" },
+        { "src": "npc/turret_floor/turret_disabled_1.wav", "name": "turret-no-hard-feelings.wav" }
+      ]
+    }
+  }
+}

package/themes/star-wars/download.sh

@@ -0,0 +1,119 @@
+#!/bin/bash
+#
+# Downloads sound files for the star-wars theme.
+# Called by install.sh with $1 = target sounds directory, $2 = temp directory.
+#
+set -e
+
+# shellcheck disable=SC2034  # passed by install.sh, reserved for theme use
+SOUNDS_DIR="$1"
+TMP_DIR="$2"
+SW_DIR="$TMP_DIR/StarWars"
+
+mkdir -p "$SW_DIR/empire" "$SW_DIR/return"
+
+BASE_URL="https://www.thesoundarchive.com/starwars"
+WAVSOURCE_URL="https://www.wavsource.com/snds_2020-10-01_3728627494378403/movies/star_wars"
+
+# ── thesoundarchive.com — root-level files ──────────────────────────
+ROOT_FILES=(
+  light-saber-on.wav
+  light-saber-off.wav
+  light-saber-battle.wav
+  blaster-firing.wav
+  set-for-stun.wav
+  force.wav
+  forcestrong.wav
+  forceisstrong.wav
+  disturbence.wav
+  chewy_roar.wav
+  Chewie-chatting.wav
+  R2D2.wav
+  R2D2-do.wav
+  R2D2-hey-you.wav
+  R2D2-yeah.wav
+  swvader01.wav
+  swvader02.wav
+  swvader03.wav
+  swvader04.wav
+  WilhelmScream.wav
+  alwaystwo.wav
+  Muchfear.wav
+  Revenge.wav
+  wipthemout.wav
+  obiwan_chosenone.wav
+  emp_lordvaderrise.wav
+  dange-disturb.wav
+  yoda_twisted.wav
+  rescue.wav
+  swluke01.wav
+  fool.wav
+)
+
+echo "  Downloading Star Wars sounds from thesoundarchive.com..."
+
+FAILED=0
+for FILE in "${ROOT_FILES[@]}"; do
+  curl -sL -o "$SW_DIR/$FILE" "$BASE_URL/$FILE"
+  if [ ! -s "$SW_DIR/$FILE" ]; then
+    echo "    Warning: Failed to download $FILE"
+    rm -f "$SW_DIR/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+# ── thesoundarchive.com — subdirectory files ────────────────────────
+EMPIRE_FILES=(
+  yodalaughing.wav
+)
+
+for FILE in "${EMPIRE_FILES[@]}"; do
+  curl -sL -o "$SW_DIR/empire/$FILE" "$BASE_URL/empire/$FILE"
+  if [ ! -s "$SW_DIR/empire/$FILE" ]; then
+    echo "    Warning: Failed to download empire/$FILE"
+    rm -f "$SW_DIR/empire/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+RETURN_FILES=(
+  jabba-the-hutt-laughing.wav
+  900yearsold.wav
+)
+
+for FILE in "${RETURN_FILES[@]}"; do
+  curl -sL -o "$SW_DIR/return/$FILE" "$BASE_URL/return/$FILE"
+  if [ ! -s "$SW_DIR/return/$FILE" ]; then
+    echo "    Warning: Failed to download return/$FILE"
+    rm -f "$SW_DIR/return/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+# ── wavsource.com — supplemental clips ──────────────────────────────
+echo "  Downloading supplemental clips from wavsource.com..."
+
+WAVSOURCE_FILES=(
+  bad_feeling.wav
+  trap.wav
+  your_father.wav
+  do_or_do_not.wav
+  dark_side.wav
+  destroy_you.wav
+  destiny.wav
+)
+
+for FILE in "${WAVSOURCE_FILES[@]}"; do
+  curl -sL -o "$SW_DIR/$FILE" "$WAVSOURCE_URL/$FILE"
+  if [ ! -s "$SW_DIR/$FILE" ]; then
+    echo "    Warning: Failed to download $FILE from wavsource"
+    rm -f "$SW_DIR/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+if [ "$FAILED" -gt 0 ]; then
+  echo "  Warning: $FAILED file(s) failed to download."
+fi
+
+echo "  Download complete."