Frequently Asked Questions

How do Moonlight's Voice Commands work?

Moonlight uses two separate AI models to operate the system. STT (Speech-to-text) and TTS (Text-to-speech). STT translates snippets of your voice into accurate text transcriptions which are parsed by the bot for commands. TTS responds to you with a generated voice confirming that your command was executed and/or what was done. Upon activating voice commands, Moonlight will listen for the keyword "moonlight" followed by a valid voice command by any user who has opted-in to Voice Command usage

Where does my voice go? Is it saved?

No user voice data is recorded or saved. User voice snippets are only stored once immediately after recording and are erased after being sent to the STT model for transcription. Not only would saving hundreds of thousands of user voice recordings take an immense amount of storage (far beyond what we have available), it is a major privacy concern which we strongly object to. If you still feel weary of letting us borrow a few words from your voice for a second or two, voice commands can be completely disabled for your account, and Moonlight will not be able to receive any audio from your account.

Why are voice commands not working for me?

You must opt-in to Moonlight's voice commands before your audio is able to be transcribed. All accounts by default will not be recorded until opting-in to enforce user safety and security. If you have previously chosen to opt-out, voice commands will be disabled for your account and we wont ask you to opt-in again. In order to opt-in/out, you must run the command /optin

Moonlight isn't recognizing my voice commands

Are your microphone levels set too low? Moonlight's AI will not be able to transcribe user audio that is muffled, choppy, or extremely glitchy. Ensure your microphone is providing relatively clear and audible signals and try again. Moonlight can only recognize English speech, and some heavy accents may have difficulty being recognized. If issues still persist, do not hesitate to send a bug report using /report.

Moonlight isn't responding to my play command

Ensure Moonlight has access to both the text channel and voice channel from which you are trying to operate within. Moonlight by default is not given full server access as a security measure, therefore some servers setup with private channels may be inaccessible. Moonlight has no way of responding to your commands if access is not given. Try giving the "Moonlight" role or user access to the channel and try again.

I ended my queue but the 15 second expiration period ended, can I still bring it back?

No. You are given 15 seconds to "change your mind" and restore your queue before it is permanentely terminated. After this, it is not saved and you must create a new queue.

I want to suggest a new feature

We'll gladly take suggestions for future updates and improvements of Moonlight. Use /report and use the report type of "Suggestion" to send us your thoughts. You can only send one report every 24 hours.

I tried to play a song from a Soundcloud/Spotify/etc link and it played a completely different song

Moonlight pulls its audio data from Youtube's servers. If the song you requested is not available on the Youtube platform, Moonlight can not retrieve it. Moonlight simply uses the respective APIs from other providers (Spotify/Soundcloud) to pull the name and artist from any links you provide, and does not actually retrieve the audio from those providers. Please ensure your playlist or song is publicly available for Moonlight to retrieve.

How do I prevent other users from controlling my music?

There are a few options for this. Of course, globally Moonlight restricts usage to those present in the active voice channel. If you still need further restriction beyond that, as an Admin you can configure the Master User system, which will prevent anyone not listed in the Master User list from operating Moonlight entirely. However, as any member, you can lock the controls to yourself as long as you are the original initiating user of the queue. Controls can be configured to lock to the initiating user by default. See Moonlight's settings list for more info.

(X) feature isn't working

Ensure you are executing commands correctly. Check Moonlight's command list for information on various commands/systems. If you are still encountering issues, send a bug report using /report

Moonlight isn't responding/is offline

Moonlight is designed as a 24/7 music bot. Planned downtime may occur for occasional updates and maintanance including bug fixes, feature additions, and more. Such maintanance periods are typically planned, last no more than a few minutes, and will be announced prior in our support server. Prolonged outages are typically server-related and will be fixed as soon as possible. Check Moonlight's support server for updates or wait a few minutes for Moonlight to come back online.

Still stuck? Head over to Moonlight's Discord server