Beatra Documentation
Complete guide to using Beatra Discord music bot. From basic setup to advanced features.
Table of Contents
Getting Started
Quick Start
Add Beatra to your Discord server and start playing music in minutes.
Add Beatra to Your Server
Click the Add to Discord button and select your server from the dropdown menu. Authorize the required permissions.
Join a Voice Channel
Enter any voice channel on your Discord server where you want to play music.
Start Playing Music
Type /play followed by a song name or URL to start playing music immediately.
Basic Commands
Playback Controls
/play [song/url]Play a song from YouTube, Spotify or SoundCloud
/pausePause the current song
/resumeResume the paused song
/skipSkip the current song
/stopStop playback and clear the queue
/volume [0-200]Adjust the volume level (0-200)
Queue Management
/queueDisplay the current music queue
/nowplayingShow the currently playing song
/shuffleShuffle the queue
/loop [off/track/queue]Repeat the current song or queue (off/track/queue)
/remove [position]Remove a song at a specific position from the queue
/clearClear the entire queue
Advanced Features
Playlists
Organize and manage your favorite songs in custom playlists.
/playlist create [name]Create a new custom playlist
/playlist add [song]Add the current song to a playlist
/playlist load [name]Load a playlist into the queue
/playlist listDisplay all your playlists
/playlist delete [name]Delete a playlist
/playlist share [name]Share your playlist with others
Audio Effects
Apply various audio effects and filters to enhance your music experience.
/filter bassboost [level]Boost the bass of the audio (level 1-5)
/filter nightcoreApply nightcore effect (faster and higher pitched)
/filter vaporwaveApply vaporwave effect (slower and deeper)
/filter 8dApply 8D audio effect (surround sound)
/filter karaokeKaraoke mode (reduce vocals)
/filter clearRemove all audio effects
Lyrics and Information
/lyricsDisplay the lyrics of the current song
/seek [timestamp]Jump to a specific timestamp in the song
/songinfoShow detailed information about the current song
Troubleshooting
Common Issues
Bot not responding to commands
- ✓Make sure the bot is online (green status)
- ✓Check if the bot has the required permissions
- ✓Try removing the bot from the server and reinviting it
- ✓Check our status page for ongoing issues
Music not playing or skipping
- ✓Check your internet connection
- ✓Try a different music source (e.g. YouTube instead of Spotify)
- ✓Try changing the voice channel region
- ✓Check if the song has copyright restrictions
- ✓Clear the queue and try adding a new song
Poor audio quality or stuttering
- ✓Check your internet speed
- ✓Change the voice channel region
- ✓Disable audio effects
- ✓Reduce the number of users in the voice channel
- ✓Try a different music source
Bot leaves the voice channel
- ✓Make sure the bot has permission to stay in the voice channel
- ✓Check the server's AFK timeout settings
- ✓Premium users can enable 24/7 mode
- ✓Make sure the bot is not banned from the server
Best Practices
Server Setup
Dedicated Music Channel
Create a dedicated text channel for bot commands and keep it separate from other conversations.
Role Permissions
Create a 'DJ' role to manage music control and give it only to trusted members.
Voice Channel Permissions
Make sure the bot has permission to connect and speak in voice channels.
Slow Mode
Enable slow mode in the music command channel to prevent spam.
Shared Playlists
Create shared playlists for the community and allow members to contribute.
Performance Tips
Voice Region Optimization
Set your server's voice region to the closest to your location for best latency.
Queue Size Management
Keep the queue at a reasonable size (50-100 songs) for better performance.
Direct URLs
Use direct YouTube or Spotify URLs when possible for faster loading.
Limit Filter Usage
Avoid using too many audio effects at once, it can affect performance.
Ready to Get Started?
Add Beatra to your Discord server now and start enjoying high-quality music!
