claude-code-sounds 1.1.1 → 1.2.0

package/README.md

@@ -8,7 +8,7 @@
 
 Plays sound effects when sessions start, prompts are submitted, responses finish, errors occur, and more.
 
-Ships with a **WC3 Orc Peon** theme and a **Zelda: Ocarina of Time** theme. Bring your own sounds or create new themes.
+Ships with 7 themes. Bring your own sounds or create new ones.
 
 *"Something need doing?"*
 
@@ -53,297 +53,19 @@ npx claude-code-sounds --uninstall  # Remove all sounds and hooks
 npx claude-code-sounds --help       # Show help
 ```
 
-## WC3 Orc Peon Theme
+## Themes
 
-57 sounds from Warcraft 3 Orc units mapped across 11 Claude Code lifecycle events.
-
-> After installing, preview all sounds with `./preview.sh` or a specific category with `./preview.sh start`
-
-<details open>
-<summary><b>start</b> — Session starting, being summoned (5 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `ready-to-work.wav` | *"Ready to work!"* | Peon |
-| `something-need-doing.wav` | *"Something need doing?"* | Peon |
-| `more-work.mp3` | *"More work?"* | Peon (WC2) |
-| `how-can-i-help.wav` | *"How can I help?"* | Shaman |
-| `someone-call-for-the-doctor.wav` | *"Someone call for the doctor?"* | Witch Doctor |
-
-</details>
-
-<details>
-<summary><b>prompt</b> — User submitted a prompt, acknowledging order (7 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `yes.wav` | *"Yes"* | Peon |
-| `dabu.wav` | *"Dabu"* | Grunt |
-| `zug-zug.wav` | *"Zug zug"* | Grunt |
-| `right-away.wav` | *"Right away"* | Shaman |
-| `immediately.wav` | *"Immediately!"* | Tauren |
-| `anything-you-want.wav` | *"Anything you want"* | Headhunter |
-| `more-work.mp3` | *"More work?"* | Peon (WC2) |
-
-</details>
-
-<details>
-<summary><b>stop</b> — Claude finished responding (9 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `zug-zug.wav` | *"Zug zug"* | Grunt |
-| `get-em.wav` | *"Get 'em!"* | Peon |
-| `ok.wav` | *"OK"* | Peon |
-| `i-can-do-that.wav` | *"I can do that"* | Peon |
-| `be-happy-to.wav` | *"Be happy to"* | Peon |
-| `understood.wav` | *"Understood"* | Shaman |
-| `of-course.wav` | *"Of course"* | Far Seer |
-| `it-is-certain.wav` | *"It is certain"* | Far Seer |
-| `whatever-you-say.wav` | *"Whatever you say"* | Grom Hellscream |
-
-</details>
-
-<details>
-<summary><b>permission</b> — Permission prompt, waiting for approval (5 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `hmmm.wav` | *"Hmmm?"* | Peon |
-| `what-you-want.wav` | *"What you want?"* | Peon |
-| `what-you-want-me-to-do.wav` | *"What you want me to do?"* | Headhunter |
-| `who-you-want-me-kill.wav` | *"Who you want me kill?"* | Headhunter |
-| `you-seek-me-help.wav` | *"You seek me help?"* | Witch Doctor |
-
-</details>
-
-<details>
-<summary><b>subagent</b> — Spawning a subagent (7 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `work-work.wav` | *"Work, work"* | Peon |
-| `zug-zug.wav` | *"Zug zug"* | Grunt |
-| `get-em.wav` | *"Get 'em!"* | Peon |
-| `ill-try.wav` | *"I'll try"* | Peon |
-| `why-not.wav` | *"Why not?"* | Peon |
-| `for-the-horde.wav` | *"For the Horde!"* | Grunt |
-| `taste-the-fury.wav` | *"Taste the fury of the Warsong!"* | Grom Hellscream |
-
-</details>
-
-<details>
-<summary><b>idle</b> — Waiting for user input (7 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `me-busy-leave-me-alone.wav` | *"Me busy, leave me alone!"* | Peon |
-| `no-time-for-play.wav` | *"No time for play!"* | Peon |
-| `me-not-that-kind-of-orc.wav` | *"Me not that kind of orc!"* | Peon |
-| `why-you-poking-me.wav` | *"Why are you poking me again?"* | Grunt |
-| `not-easy-being-green.wav` | *"It's not easy being green"* | Grunt |
-| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
-| `outlook-not-so-good.wav` | *"Outlook... not so good"* | Far Seer |
-
-</details>
-
-<details>
-<summary><b>error</b> — Tool call failed (4 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `peon-death.wav` | *(death sound)* | Peon |
-| `grunt-death.wav` | *(death sound)* | Grunt |
-| `headhunter-death.wav` | *(death sound)* | Headhunter |
-| `reply-hazy-try-again.wav` | *"Reply hazy, try again"* | Far Seer |
-
-</details>
-
-<details>
-<summary><b>end</b> — Session ending (3 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `well-done.wav` | *"Well done!"* | Tauren |
-| `finally.wav` | *"Finally!"* | Grom Hellscream |
-| `okie-dokie.wav` | *"Okie dokie"* | Peon |
-
-</details>
-
-<details>
-<summary><b>task-completed</b> — Task marked done (2 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `well-done.wav` | *"Well done!"* | Tauren |
-| `finally.wav` | *"Finally!"* | Grom Hellscream |
-
-</details>
-
-<details>
-<summary><b>compact</b> — Context compaction, memory fading (4 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `concentrate-and-ask-again.wav` | *"Concentrate... and ask again"* | Far Seer |
-| `reply-hazy-try-again.wav` | *"Reply hazy, try again"* | Far Seer |
-| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
-| `death.wav` | *(death sound)* | Peon |
-
-</details>
-
-<details>
-<summary><b>teammate-idle</b> — Teammate went idle (4 sounds)</summary>
-
-| Sound | Quote | Unit |
-|---|---|---|
-| `what.wav` | *"What?!"* | Peon |
-| `me-busy-leave-me-alone.wav` | *"Me busy, leave me alone!"* | Peon |
-| `no-time-for-play.wav` | *"No time for play!"* | Peon |
-| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
-
-</details>
-
-## Zelda: Ocarina of Time Theme
-
-47 sounds from Navi, Link, Ganondorf, and iconic OOT jingles mapped across 11 Claude Code lifecycle events.
-
-*"Hey! Listen!"*
-
-<details open>
-<summary><b>start</b> — Session starting, Navi greets you (5 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `hey.wav` | *"Hey!"* | Navi |
-| `hello.wav` | *"Hello!"* | Navi |
-| `listen.wav` | *"Listen!"* | Navi |
-| `great-fairy-laugh.wav` | *(magical laugh)* | Great Fairy |
-| `open-chest.wav` | *(opening big chest)* | SFX |
-
-</details>
-
-<details>
-<summary><b>prompt</b> — User submitted a prompt, adventure continues (5 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `hey.wav` | *"Hey!"* | Navi |
-| `look.wav` | *"Look!"* | Navi |
-| `menu-select.wav` | *(menu select)* | SFX |
-| `dialogue-next.wav` | *(continue dialogue)* | SFX |
-| `get-heart.wav` | *(get heart)* | SFX |
-
-</details>
-
-<details>
-<summary><b>stop</b> — Claude finished responding (5 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `secret-discovered.wav` | *(secret jingle)* | SFX |
-| `get-item.wav` | *(get small item)* | SFX |
-| `get-rupee.wav` | *(get rupee)* | SFX |
-| `open-small-chest.wav` | *(open small chest)* | SFX |
-| `song-correct.wav` | *(song played correctly)* | SFX |
-
-</details>
-
-<details>
-<summary><b>permission</b> — Permission prompt, waiting for approval (5 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `watch-out.wav` | *"Watch out!"* | Navi |
-| `hey.wav` | *"Hey!"* | Navi |
-| `listen.wav` | *"Listen!"* | Navi |
-| `pause-menu.wav` | *(pause menu open)* | SFX |
-| `z-target.wav` | *(Z-target enemy)* | SFX |
-
-</details>
-
-<details>
-<summary><b>subagent</b> — Spawning a subagent (5 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `sword-draw.wav` | *(draw sword)* | SFX |
-| `link-attack.wav` | *(attack shout)* | Adult Link |
-| `link-strong-attack.wav` | *(strong attack)* | Adult Link |
-| `hey.wav` | *"Hey!"* | Navi |
-| `spin-attack.wav` | *(spin attack)* | SFX |
-
-</details>
-
-<details>
-<summary><b>idle</b> — Waiting for user input (5 sounds)</summary>
-
-| Sound | Description | Source |
+| Theme | Sounds | Vibe |
 |---|---|---|
-| `hey.wav` | *"Hey!"* | Navi |
-| `listen.wav` | *"Listen!"* | Navi |
-| `watch-out.wav` | *"Watch out!"* | Navi |
-| `low-health.wav` | *(low health beep)* | SFX |
-| `snore.wav` | *(Talon snoring)* | Talon |
+| **WC3 Orc Peon** (`wc3-peon`) | 57 | *"Something need doing?"* — Peons, Grunts, Shamans, and Grom Hellscream |
+| **Zelda: Ocarina of Time** (`zelda-oot`) | 47 | *"Hey! Listen!"* — Navi, Link, and iconic OOT jingles |
+| **Super Mario Bros** (`mario`) | 47 | *"Let's-a go!"* — Coins, power-ups, and Mario's voice from NES to N64 |
+| **Star Wars** (`star-wars`) | 36 | *"May the Force be with you"* — Lightsabers, R2-D2, and the dark side |
+| **Metal Gear Solid** (`mgs`) | 40 | *"Kept you waiting, huh?"* — Codec calls, alert sounds, and Snake |
+| **Pokemon Gen 1** (`pokemon-gen1`) | 49 | *"Wild PIKACHU appeared!"* — Cries, battle sounds, and Kanto menus |
+| **Portal** (`portal`) | 42 | *"Are you still there?"* — Turrets, portal guns, and Aperture Science |
 
-</details>
-
-<details>
-<summary><b>error</b> — Tool call failed (4 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `error.wav` | *(error sound)* | SFX |
-| `song-error.wav` | *(wrong note)* | SFX |
-| `link-hurt.wav` | *(Link hurt)* | Adult Link |
-| `ganondorf-laugh.wav` | *(Ganondorf laughing)* | Ganondorf |
-
-</details>
-
-<details>
-<summary><b>end</b> — Session ending (3 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `item-fanfare.wav` | *(item fanfare)* | SFX |
-| `secret-discovered.wav` | *(secret jingle)* | SFX |
-| `dialogue-done.wav` | *(dialogue finished)* | SFX |
-
-</details>
-
-<details>
-<summary><b>task-completed</b> — Task marked done (2 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `item-fanfare.wav` | *(item fanfare)* | SFX |
-| `secret-discovered.wav` | *(secret jingle)* | SFX |
-
-</details>
-
-<details>
-<summary><b>compact</b> — Context compaction, health running low (4 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `low-health.wav` | *(low health beep)* | SFX |
-| `pause-close.wav` | *(pause menu close)* | SFX |
-| `watch-out.wav` | *"Watch out!"* | Navi |
-| `error.wav` | *(error sound)* | SFX |
-
-</details>
-
-<details>
-<summary><b>teammate-idle</b> — Teammate went idle (4 sounds)</summary>
-
-| Sound | Description | Source |
-|---|---|---|
-| `hey.wav` | *"Hey!"* | Navi |
-| `listen.wav` | *"Listen!"* | Navi |
-| `watch-out.wav` | *"Watch out!"* | Navi |
-| `low-health.wav` | *(low health beep)* | SFX |
-
-</details>
+Each theme maps sounds across all 11 Claude Code lifecycle events. Preview installed sounds with `./preview.sh`.
 
 ## Hook Events
 
@@ -426,4 +148,4 @@ This removes all sound files, the hook script, and the hooks config from `settin
 
 ## Disclaimer
 
-Sound files are downloaded from third-party sources at install time and are not included in this repository. Warcraft audio is property of Blizzard Entertainment. Zelda audio is property of Nintendo.
+Sound files are downloaded from third-party sources at install time and are not included in this repository. All game audio is property of its respective owners: Blizzard Entertainment (Warcraft), Nintendo (Zelda, Mario, Pokemon), Lucasfilm/Disney (Star Wars), Konami (Metal Gear Solid), and Valve (Portal).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-sounds",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Sound themes for Claude Code lifecycle hooks",
   "bin": {
     "claude-code-sounds": "bin/cli.js"

package/themes/mario/download.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+#
+# Downloads sound files for the mario 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"
+MARIO_DIR="$TMP_DIR/Mario"
+
+mkdir -p "$MARIO_DIR/smb" "$MARIO_DIR/sm64" "$MARIO_DIR/smw" "$MARIO_DIR/smb3"
+
+BASE="https://themushroomkingdom.net/sounds/wav"
+
+# --- Super Mario Bros. (NES) ---
+SMB_FILES=(
+  smb_1-up.wav
+  smb_breakblock.wav
+  smb_bump.wav
+  smb_coin.wav
+  smb_fireball.wav
+  smb_flagpole.wav
+  smb_gameover.wav
+  smb_mariodie.wav
+  smb_pause.wav
+  smb_pipe.wav
+  smb_powerup.wav
+  smb_powerup_appears.wav
+  smb_stage_clear.wav
+  smb_stomp.wav
+  smb_vine.wav
+  smb_world_clear.wav
+)
+
+# --- Super Mario 64 (N64) ---
+SM64_FILES=(
+  sm64_mario_burned.wav
+  sm64_mario_doh.wav
+  sm64_mario_haha.wav
+  sm64_mario_hello.wav
+  sm64_mario_here_we_go.wav
+  sm64_mario_hurt.wav
+  sm64_mario_its_me.wav
+  sm64_mario_lets_go.wav
+  sm64_mario_mamma-mia.wav
+  sm64_mario_okey-dokey.wav
+  sm64_mario_oof.wav
+  sm64_mario_snore_part1.wav
+  sm64_mario_tired.wav
+  sm64_mario_waha.wav
+  sm64_mario_whoa.wav
+  sm64_mario_yahoo.wav
+  sm64_mario_yawn.wav
+  sm64_mario_yippee.wav
+  sm64_happy_message.wav
+  sm64_star_appears.wav
+  sm64_warp.wav
+)
+
+# --- Super Mario World (SNES) ---
+SMW_FILES=(
+  smw_1-up.wav
+  smw_message_block.wav
+  smw_pipe.wav
+  smw_power-up.wav
+)
+
+# --- Super Mario Bros. 3 (NES) ---
+SMB3_FILES=(
+  smb3_level_clear.wav
+  smb3_lost_suit.wav
+  smb3_power-up.wav
+  smb3_raccoon_transform.wav
+  smb3_whistle.wav
+)
+
+echo "  Downloading Super Mario sounds..."
+
+FAILED=0
+
+for FILE in "${SMB_FILES[@]}"; do
+  curl -sL -o "$MARIO_DIR/smb/$FILE" "$BASE/smb/$FILE"
+  if ! file "$MARIO_DIR/smb/$FILE" | grep -q "WAVE\|RIFF"; then
+    echo "    Warning: Failed to download smb/$FILE"
+    rm -f "$MARIO_DIR/smb/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+for FILE in "${SM64_FILES[@]}"; do
+  curl -sL -o "$MARIO_DIR/sm64/$FILE" "$BASE/sm64/$FILE"
+  if ! file "$MARIO_DIR/sm64/$FILE" | grep -q "WAVE\|RIFF"; then
+    echo "    Warning: Failed to download sm64/$FILE"
+    rm -f "$MARIO_DIR/sm64/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+for FILE in "${SMW_FILES[@]}"; do
+  curl -sL -o "$MARIO_DIR/smw/$FILE" "$BASE/smw/$FILE"
+  if ! file "$MARIO_DIR/smw/$FILE" | grep -q "WAVE\|RIFF"; then
+    echo "    Warning: Failed to download smw/$FILE"
+    rm -f "$MARIO_DIR/smw/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+for FILE in "${SMB3_FILES[@]}"; do
+  curl -sL -o "$MARIO_DIR/smb3/$FILE" "$BASE/smb3/$FILE"
+  if ! file "$MARIO_DIR/smb3/$FILE" | grep -q "WAVE\|RIFF"; then
+    echo "    Warning: Failed to download smb3/$FILE"
+    rm -f "$MARIO_DIR/smb3/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+if [ "$FAILED" -gt 0 ]; then
+  echo "  Warning: $FAILED file(s) failed to download."
+fi
+
+echo "  Download complete."

package/themes/mario/theme.json

@@ -0,0 +1,110 @@
+{
+  "name": "Super Mario Bros",
+  "description": "Iconic Super Mario sound effects from NES, SNES, and N64 — coins, power-ups, and Mario's voice",
+  "author": "ryparker",
+  "srcBase": "Mario",
+  "sounds": {
+    "start": {
+      "description": "Session starting — here we go!",
+      "files": [
+        { "src": "sm64/sm64_mario_lets_go.wav", "name": "lets-a-go.wav" },
+        { "src": "sm64/sm64_mario_here_we_go.wav", "name": "here-we-go.wav" },
+        { "src": "sm64/sm64_mario_its_me.wav", "name": "its-a-me-mario.wav" },
+        { "src": "sm64/sm64_mario_hello.wav", "name": "hello.wav" },
+        { "src": "smb/smb_1-up.wav", "name": "1-up.wav" }
+      ]
+    },
+    "end": {
+      "description": "Session over — course clear",
+      "files": [
+        { "src": "smb/smb_stage_clear.wav", "name": "stage-clear.wav" },
+        { "src": "smb/smb_world_clear.wav", "name": "world-clear.wav" },
+        { "src": "smb/smb_flagpole.wav", "name": "flagpole.wav" },
+        { "src": "sm64/sm64_mario_okey-dokey.wav", "name": "okey-dokey.wav" }
+      ]
+    },
+    "prompt": {
+      "description": "User submitted prompt — coin collected",
+      "files": [
+        { "src": "smb/smb_coin.wav", "name": "coin.wav" },
+        { "src": "smb/smb_bump.wav", "name": "block-bump.wav" },
+        { "src": "smb/smb_fireball.wav", "name": "fireball.wav" },
+        { "src": "sm64/sm64_mario_haha.wav", "name": "haha.wav" }
+      ]
+    },
+    "stop": {
+      "description": "Done responding — power-up complete",
+      "files": [
+        { "src": "smb/smb_powerup.wav", "name": "power-up.wav" },
+        { "src": "smw/smw_power-up.wav", "name": "smw-power-up.wav" },
+        { "src": "smb3/smb3_power-up.wav", "name": "smb3-power-up.wav" },
+        { "src": "smb/smb_stomp.wav", "name": "stomp.wav" }
+      ]
+    },
+    "permission": {
+      "description": "Permission prompt — question block",
+      "files": [
+        { "src": "smb/smb_pause.wav", "name": "pause.wav" },
+        { "src": "smb/smb_powerup_appears.wav", "name": "question-block.wav" },
+        { "src": "smw/smw_message_block.wav", "name": "message-block.wav" },
+        { "src": "smb3/smb3_whistle.wav", "name": "warp-whistle.wav" }
+      ]
+    },
+    "idle": {
+      "description": "Waiting for input — Mario is bored",
+      "files": [
+        { "src": "sm64/sm64_mario_snore_part1.wav", "name": "snore.wav" },
+        { "src": "sm64/sm64_mario_yawn.wav", "name": "yawn.wav" },
+        { "src": "sm64/sm64_mario_tired.wav", "name": "tired.wav" },
+        { "src": "sm64/sm64_mario_mamma-mia.wav", "name": "mamma-mia.wav" }
+      ]
+    },
+    "subagent": {
+      "description": "Spawning subagent — summoning helper",
+      "files": [
+        { "src": "smb/smb_powerup_appears.wav", "name": "mushroom-appears.wav" },
+        { "src": "smb/smb_vine.wav", "name": "vine-grow.wav" },
+        { "src": "smb3/smb3_raccoon_transform.wav", "name": "raccoon-transform.wav" },
+        { "src": "sm64/sm64_mario_yahoo.wav", "name": "yahoo.wav" }
+      ]
+    },
+    "error": {
+      "description": "Tool failure — took damage",
+      "files": [
+        { "src": "smb/smb_mariodie.wav", "name": "death.wav" },
+        { "src": "sm64/sm64_mario_hurt.wav", "name": "hurt.wav" },
+        { "src": "sm64/sm64_mario_burned.wav", "name": "burned.wav" },
+        { "src": "sm64/sm64_mario_doh.wav", "name": "doh.wav" },
+        { "src": "sm64/sm64_mario_oof.wav", "name": "oof.wav" },
+        { "src": "smb/smb_gameover.wav", "name": "game-over.wav" }
+      ]
+    },
+    "task-completed": {
+      "description": "Task finished — star collected",
+      "files": [
+        { "src": "sm64/sm64_star_appears.wav", "name": "star-appears.wav" },
+        { "src": "smb3/smb3_level_clear.wav", "name": "level-clear.wav" },
+        { "src": "sm64/sm64_happy_message.wav", "name": "happy-message.wav" },
+        { "src": "sm64/sm64_mario_yippee.wav", "name": "yippee.wav" }
+      ]
+    },
+    "compact": {
+      "description": "Context compaction — pipe warp",
+      "files": [
+        { "src": "smb/smb_pipe.wav", "name": "pipe-warp.wav" },
+        { "src": "smw/smw_pipe.wav", "name": "smw-pipe.wav" },
+        { "src": "sm64/sm64_warp.wav", "name": "warp.wav" },
+        { "src": "smb3/smb3_lost_suit.wav", "name": "shrink.wav" }
+      ]
+    },
+    "teammate-idle": {
+      "description": "Teammate went idle — notification",
+      "files": [
+        { "src": "smw/smw_1-up.wav", "name": "smw-1-up.wav" },
+        { "src": "smb/smb_breakblock.wav", "name": "break-block.wav" },
+        { "src": "sm64/sm64_mario_whoa.wav", "name": "whoa.wav" },
+        { "src": "sm64/sm64_mario_waha.wav", "name": "waha.wav" }
+      ]
+    }
+  }
+}

package/themes/mgs/download.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+#
+# Downloads sound files for the mgs (Metal Gear Solid) 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"
+MGS_DIR="$TMP_DIR/MGS"
+
+mkdir -p "$MGS_DIR"
+
+BASE_URL="https://www.myinstants.com/media/sounds"
+
+# All unique sound files needed by this theme
+FILES=(
+  codec.mp3
+  metalgearcodec.mp3
+  mgs2-snake-kept-you-waiting-huh.mp3
+  codec-send.mp3
+  metal_gear_solid_exit_sound_effect.mp3
+  metal_gear_solid_exit_sound_effect_EQbXTbY.mp3
+  mgs2-snake-sweet-dreams-boyscout.mp3
+  sfx_s_mission_qualify.mp3
+  mgs2-snake-roger-that-sir.mp3
+  mgs2-snake-sounds-like-a-plan.mp3
+  mgs2-snake-ill-do-my-best.mp3
+  mgs2-snake-if-you-say-so.mp3
+  mgs2-snake-good-shooting.mp3
+  tindeck_1.mp3
+  metal-gear-alert-sound-effect_XKoHReZ.mp3
+  what-was-that-noise.mp3
+  untitled_1150.mp3
+  why_are_we_still_here_just_to_suffer_2.mp3
+  cigar.mp3
+  metalgeargameov5235.mp3
+  metal-gear-solid-solid-snake-scream.mp3
+  snake-dies-game-over.mp3
+  metal_gear_solid_game_over_screen_clean_background-1.mp3
+  mgs2-snake-what-the-hell-is-going-on-here.mp3
+  youre-pretty-good_I5kzLtx.mp3
+  metal-gear-item-drop.mp3
+  metalgearsolid.swf.mp3
+  original-metal-gear-solid-game-over-screen.mp3
+  ocelot-meowing.mp3
+  mgs2-snake-friendly-fire.mp3
+)
+
+echo "  Downloading Metal Gear Solid sounds..."
+
+FAILED=0
+for FILE in "${FILES[@]}"; do
+  if ! curl -sL -o "$MGS_DIR/$FILE" "$BASE_URL/$FILE"; then
+    echo "    Warning: Failed to download $FILE"
+    rm -f "$MGS_DIR/$FILE"
+    FAILED=$((FAILED + 1))
+    continue
+  fi
+
+  # Verify we got a valid audio file (not an HTML error page)
+  if file "$MGS_DIR/$FILE" | grep -q "HTML"; then
+    echo "    Warning: $FILE returned HTML instead of audio"
+    rm -f "$MGS_DIR/$FILE"
+    FAILED=$((FAILED + 1))
+  fi
+done
+
+if [ "$FAILED" -gt 0 ]; then
+  echo "  Warning: $FAILED file(s) failed to download."
+fi
+
+echo "  Download complete."