Setup Guide

Complete step-by-step guide to install and configure Banketnika for your Discord server.

📦 Installation⚙️ Configuration🔧 Troubleshooting

📋 Prerequisites

Before installing Banketnika, make sure you have these requirements installed.

Python 3.8+
Required for running the bot
Download
FFmpeg
Audio processing library
Download
Discord Bot Token
From Discord Developer Portal
Download
Git
For cloning the repository
Download

📦 Installation

Follow these steps to install Banketnika on your system.

1
Clone Repository
Download the Banketnika source code
git clone https://github.com/stoychevww/banketnika.git
cd banketnika
2
Install Dependencies
Install required Python packages
pip install -r requirements.txt
3
Configure Environment
Set up your bot token and settings
cp .env.example .env
4
Run the Bot
Start your Banketnika instance
python bot.py

🎵 FFmpeg Setup

Platform-specific instructions for installing FFmpeg.

🪟
Windows
  1. 1.Download FFmpeg from https://ffmpeg.org/download.html
  2. 2.Extract the archive to a folder (e.g., C:\ffmpeg)
  3. 3.Add the bin folder to your system PATH
  4. 4.Restart your command prompt
🐧
Linux (Ubuntu/Debian)
  1. 1.Update package list: sudo apt update
  2. 2.Install FFmpeg: sudo apt install ffmpeg
  3. 3.Verify installation: ffmpeg -version
🍎
macOS
  1. 1.Install Homebrew if not already installed
  2. 2.Run: brew install ffmpeg
  3. 3.Verify installation: ffmpeg -version

🤖 Discord Bot Setup

Create and configure your Discord bot application.

Setup Steps
  1. 1

    Create Application

    Go to Discord Developer Portal and create a new application

  2. 2

    Create Bot

    Navigate to the 'Bot' section and create a bot user

  3. 3

    Copy Token

    Copy the bot token and add it to your .env file

  4. 4

    Set Permissions

    Configure bot permissions in the OAuth2 section

  5. 5

    Invite Bot

    Use the generated invite link to add the bot to your server

Required Permissions
Connect
Speak
Use Voice Activity
Send Messages
Embed Links
Read Message History
Add Reactions
Environment Configuration
Create a .env file with your bot configuration

.env file

BOT_TOKEN=your_discord_bot_token_here
BOT_PREFIX=!
MAX_QUEUE_SIZE=100
MAX_SONG_LENGTH=600
DEFAULT_VOLUME=0.5

🔧 Troubleshooting

Common issues and their solutions to get Banketnika running smoothly.

Bot doesn't respond to commands
  • Check if bot has proper permissions
  • Verify bot token is correct
  • Ensure bot is online and in your server
  • Check command prefix in configuration
Audio quality issues
  • Install/update FFmpeg
  • Check your internet connection
  • Verify Discord voice permissions
  • Try different audio sources
Bot leaves voice channel
  • This is normal when alone in channel
  • Bot auto-disconnects to save resources
  • Rejoin voice channel to continue
  • Check auto-disconnect settings
Bulgarian commands don't work
  • Ensure proper Unicode support
  • Check Discord client language settings
  • Try English alternatives
  • Verify bot configuration

Need Help?

If you're having trouble with the setup, check out our GitHub repository or add the hosted version to your server instead.