# Emoji sound effects

## Introduction

{% hint style="danger" %}
Broken: Unfortunately this feature is currently broken - we're looking into it
{% endhint %}

{% hint style="info" %}
Only a user with server admin permissions or server management permissions can perform this command.
{% endhint %}

To personalise your server you may want to associate sounds with specific words or emojis. For example you may want to associate :clap: with <https://sfx.nullabork.dev/applause-2.wav>. These sound effects will then be played when that specific emoji or word is used when speaking whilst the bot is in voice.

To configure this capability use the **!sfx** command.

To get started list all the existing sound effects using **!sfx list .**&#x20;

If you'd like to clear all the existing effects use **!sfx clearall.**

Sound effects can be found online at many free sound effects sites. Please be polite when using a site's audio and make sure you're allowed to use it for this purpose.

## **Examples**

### **Add a clapping sound to the clap emoji**

```
!sfx add :clap: https://sfx.nullabork.dev/applause-2.wav
```

**Note:** URLs need to be **https** insecure URLs will not work.

Then to test, **!follow** the bot and type :clap: and then the applause-2 sound effect should be played.

Example:

```
!follow
:clap:
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nullabork.gitbook.io/talkbot/use-cases/emoji-sound-effects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
