Skill

Zelda Sounds Configurator

Bring the magic of Hyrule to your terminal with custom sound effects for every Claude Code event.

Use in Claude Code
/zelda-sounds:configure-zelda-sounds

The Zelda Sounds Configurator lets you personalize your Claude Code experience by assigning iconic Zelda sound effects to 9 semantic moments (like success, error, or warning). It launches a local web server that opens a GUI in your browser, where you can preview sounds, choose a configuration file path, and save your overrides. Changes take effect immediately with no reload needed, bringing a touch of Hyrule to your development workflow.

Key Insights

Browser-Based GUI

A clean, intuitive interface opens in your default browser, making it easy to preview and assign sounds without touching the command line.

9 Semantic Moments

Assign unique sounds to 9 distinct Claude Code events, from success and error to warning and info, for instant audio feedback.

Instant Live Reload

Save your configuration and hear changes immediately — no restart or reload required, keeping your flow uninterrupted.

Custom Config Path

Choose where to save your sound overrides, giving you full control over your configuration files and easy sharing between projects.

How It Works

1

Rebuild Configurator

Ensure the configurator bundle is up to date.

Run npm install and build inside the configurator directory to compile the latest version of the GUI.

2

Launch Server

Start the configurator web server on a free port.

Run the configurator.mjs script with PORT=0 to automatically pick an available port and print the URL.

3

Open Browser

Open the provided URL in your browser.

The server prints http://localhost:<port>; copy and paste it into your browser to access the GUI.

4

Assign Sounds

Preview and assign sounds to events.

Use the GUI to listen to sound previews and map each of the 9 semantic moments to your preferred Zelda sound effect.

5

Save Configuration

Save your overrides to a config file.

Choose a file path and save; changes take effect immediately with live reload, no restart needed.