Troubleshooting

Work down the section that matches what you see. Each one starts with the most common cause. If none of them fixes it, ask for help and say what you tried.

Orpheus won't join, or you can't hear it

Check these in order:

1. You're in a voice channel. /play joins the channel you're in, so join one first.
2. Orpheus has the permissions. In that voice channel it needs View Channel, Connect and Speak. A permission set on the channel itself can override the role, so open the channel's settings, then Permissions, and check Orpheus's role there too.
3. The channel isn't full. If the voice channel has a user limit and it's reached, Orpheus can't get in. Raise the limit or move to another channel.
4. It's not a stage channel, or Orpheus has been made a speaker. In a stage channel, Orpheus has to be made a speaker before anyone can hear it. Invite it to speak, then play again.
5. Orpheus isn't muted or deafened by the server. Right-click Orpheus in the voice channel and check that Server Mute is off.
6. Your own Discord isn't muting it. Right-click Orpheus in the voice channel and check its User Volume isn't turned down. Then open User Settings, then Voice & Video, and check the output device is the one you're listening on.

If Orpheus joined but the card says it's playing and you hear nothing, items 5 and 6 are almost always the cause.

Slash commands don't show up

• Orpheus was added without the commands scope. Add it again from Add to Discord and pick the same server. You don't need to remove it first.
• The server has limited the commands. Someone with Manage Server can open Server Settings, then Integrations, then Orpheus to see which roles and channels each command is allowed in.
• Your role can't use them. Discord has a "Use Application Commands" permission. If your role lacks it, or the channel turns it off for you, no slash command shows up. Ask a moderator.
• Discord hasn't refreshed. Restart Discord, or press Ctrl+R on desktop, and type / again.

A song or link won't play

• Check what /play accepts. It takes a song name or a link from a supported service, and What /play accepts lists them. Links from a service Orpheus can't read are recognised by name, and Orpheus says so.
• Try the song name and artist. If a link doesn't play, /play with the name and artist usually does. /search lets you pick the result yourself.
• Some songs fail. If a song can't play you see "Could not play" and the queue moves on. After several failures in a row Orpheus pauses and keeps your queue, so press play to carry on. See when a track won't play.
• Check the status page. If many songs fail at once, /status will say whether something is wrong on our side.

Specific cases are in the FAQ: Nothing found, a link from another service and a Spotify link.

Orpheus left the channel, or the music stopped

The FAQ already has the answers, so they're linked here instead of repeated:

• Why did Orpheus leave?
• Everyone came back but the music is still paused
• Orpheus stopped after three songs failed
• Autoplay is on but the music stopped
• Orpheus says it's under maintenance

A command didn't respond

Discord shows "The application did not respond", or the command fails.

1. Run the command again once. A single slow reply doesn't mean anything is broken.
2. Check /status. If a part of Orpheus is down, the page says so and you only need to wait.
3. If the status page says everything is working and it keeps happening, ask for help with the command you ran and the exact message you got.

How to ask for help

Post in the Orpheus Discord or email support@orpheusbot.app, and include:

• Your server ID. Finding your server ID shows how.
• What you did. The command you ran and where, such as /play query: firefly in a voice channel.
• What happened. The exact message Orpheus gave, or a screenshot.
• The time. When it happened and your timezone, so the moment can be looked at.

Each of those saves a question back to you.