sound-fx

Generate short sound effects via ElevenLabs SFX (text-to-sound). Use when you need SFX clips like applause, canned laughter, whooshes, ambience, or short stingers, and optionally convert to WhatsApp-friendly .ogg/opus.

1. Skonfiguruj klucz API ElevenLabs, ustawiając zmienną środowiskową ELEVENLABS_API_KEY lub XI_API_KEY w systemie, albo dodaj ją do pliku konfiguracyjnego ~/.clawdbot/clawdbot.json pod ścieżką skills."sound-fx".env.ELEVENLABS_API_KEY.

2. Uruchom skrypt generujący efekt dźwiękowy, podając opis tekstowy tego, co chcesz usłyszeć – na przykład scripts/generate_sfx.sh --text "short audience applause" --out "/tmp/applause.mp3" --duration 1.2. Parametr --duration jest opcjonalny i przyjmuje wartości od 0,5 do 30 sekund; jeśli go pominiesz, system automatycznie dobierze długość.

3. Czekaj na zakończenie generowania – skrypt wyśle żądanie do API ElevenLabs i zapisze plik MP3 w podanej ścieżce. Po sukcesie zobaczysz komunikat MEDIA: <ścieżka>, co oznacza, że plik jest gotowy do użycia.

4. Jeśli chcesz użyć efektu w WhatsAppie na telefonie, przekonwertuj MP3 na format .ogg/opus poleceniem ffmpeg -y -i /tmp/applause.mp3 -c:a libopus -b:a 48k /tmp/applause.ogg – ten format jest bardziej kompatybilny z aplikacją mobilną.

5. Eksperymentuj z różnymi opisami tekstowymi: "canned audience laughter" dla śmiechu, "fast whoosh" dla efektu whoosh, "soft rain ambience" dla ambientacji deszczu – każdy opis generuje unikalny dźwięk dostosowany do Twojego żądania.