> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsoundcloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice assistant

> Loli plays music by voice: how to turn it on, call it and what to say. Needs STAR

> [!NOTE]
>
> The assistant arrives in the app with the next update: [how to update](https://docs.getsoundcloud.app/en/install/update.md).

> [!NOTE]
>
> Needs [STAR](https://docs.getsoundcloud.app/en/star.md). Without it **Settings -> Voice** shows only an offer and a voice sample. The assistant is off by default.

## Turn it on

**1. Open Settings -> Voice**

The **Loli** card is at the top.

**2. Press Turn on**

Or flip the **Voice control** switch. If the models are not on the computer yet, the button reads **Turn on · size** and downloads them at once. When everything is ready you see **Models ready**.

**3. Pick the voice language**

**RU** or **EN** on the right of the card. Commands are understood in the chosen language.

**4. Say a command**

Press **Talk**, hold the key or call it by name. To try it, the card has a **Type a command** field and a **Send** button.

While the assistant is on, the player at the bottom shows a microphone button, **Talk**.

## How to call it

Everything is in **Settings -> Voice -> How to call**.

| Way | How it works |
| - | - |
| **Talk** button | In the player and in the **Loli** card. Press and speak. **Stop** ends listening, **Cancel** cancels |
| **Push to talk** | Ctrl+Shift+Space by default, Shift+Cmd+Space on macOS. **Hold**: speak while you hold. **Tap**: press, speak, pause |
| **Headset button** | **2×** or **3×** presses in a row. **Off** disables it. **Test** shows whether presses arrive: **Works** |
| **By name** | Off by default. Turn the switch on and the assistant answers to its name (see **Responds to**: **Sound**, **Loli**, for Moriarty **Mori** and **Moriarty**). Name first, then the command |

The wake word is recognized on your computer. Sound from the microphone does not leave the computer.

## What to say

Speak in your own words, for example:

* "Play Billie Eilish"
* "Volume 50"
* "Like it"

The assistant can do this:

| Group | What |
| - | - |
| Play | **Play** an artist, track, album, playlist, **My wave**, **My likes**, **Similar**; **Add to queue**; **Add to playlist** |
| Player | **Pause**, **Resume**, **Next track**, **Previous track**, **Seek**, **Volume**, **Playback speed**, **Shuffle**, **Repeat** |
| Track | **Like**, **Lyrics** |
| Queue | **Queue**, **Clear queue** |
| App | **Search**, **Open page**, **Settings**, **Change setting** |
| Mistake | **Undo** reverts what was done |

Several actions fit in one phrase. If the assistant is not sure what to play, it asks: **Which one?** Press an option, press 1 or 2, or answer by voice. Nothing found: **Not found**, and **Search** opens the search.

To stop a reply, press **Hush**. If it understood wrong, press **Undo** on the pill or in **Settings -> Voice -> History**.

When people nearby talk to someone else, the assistant usually stays silent.

## Conversation

A phrase that is not a command goes to the conversation: the assistant answers by voice and text. It is controlled by **Talk with the character**, on by default. What is sent, and how to change the voice, address and role: [Voice, address, memory](https://docs.getsoundcloud.app/en/use/voice-settings.md).

## Privacy

Audio from the microphone never leaves your computer: recording and recognition run on it.

| What | What leaves the computer |
| - | - |
| A command with a name | The text of the name, to find it in the catalog |
| Conversation | The text of your phrase, what is playing and queued, and the remembered facts: to our server and the model provider |
| Spoken reply | Nothing. With **Voice from our servers**: the text of the reply |

Details: [privacy policy](https://getsoundcloud.app/en/privacy).

## Not working

> [accordion] It does not hear me
>
> 1. **Settings -> Voice -> Microphones**. It says **No microphone access**: press **Allow** and enable the microphone for the app in the system settings.
> 2. It says **No microphone found**: plug one in and press **Rescan**.
> 3. Each microphone has a level bar: say something, it should move. It does not: pick another microphone. In **Chosen** mode switch on the one you need. **Where I speak** and **All** listen on several at once.
> 4. **Microphone is busy**: close the program holding it (a call, a recording). **Microphone disconnected**: reconnect it.
> 5. Bluetooth headphones: **Headphones switch to call quality**, sound gets worse. Use the computer microphone instead.
> 6. **Needs models**, **Model damaged**: **Settings -> Voice -> Models**, finish the download or press **Download again**.
> 7. **Didn't catch that**: say it again. Still nothing: check the language (**RU** or **EN**).

> [accordion] It wakes from music or from talk
>
> * **Settings -> Voice -> Microphones -> Echo cancellation**: set **Auto** or **On**. Without it the name fires from music: under the **By name** row there is a warning and a **Turn on** button.
> * Under the **By name** row move the slider toward **Rarer**. Next to it is the count of false wakes for the last 24 h.
> * You do not need the name: turn **By name** off and use the key.

> [accordion] It understood the wrong thing
>
> * Say it again or pick an option on the **Which one?** pill.
> * Not found: press **Search** to open the search.
> * In **History** hover the row and press the flag **Understood wrong**: the row gets crossed out. Or **Undo** if the action is already done.
> * A hard artist name: type the command in **Type a command**.

> [accordion] No voice reply
>
> * **Settings -> Voice -> Reply voice**: the **Reply by voice** switch is on.
> * **Speak on**: check it. **Device**: pick speakers or headphones from the list.
> * It says **Couldn't speak the reply**: try **Voice from our servers** or check the models in **Models**.
> * Music too loud: move **Music level** under **Music under voice**.

> [accordion] It says voice comes with STAR
>
> **Voice comes with STAR**: [what STAR gives](https://docs.getsoundcloud.app/en/star.md). You have STAR but the assistant is locked: [what to check](https://docs.getsoundcloud.app/en/star/not-active.md).

> [accordion] Catalog unreachable, Can't answer right now
>
> Commands search through our servers, and so does the conversation. Check your internet: [servers down?](https://docs.getsoundcloud.app/en/fix/servers-down.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.