Zeenox

A Discord music bot that focuses on speed and ease of usability, with a web dashboard, all for completely free. Allows playback from Spotify, YouTube, SoundCloud, BandCamp, Twitch

Features

• Comes with a fully functional web interface that allows you to control the bot from your browser. For more information click here
• Can be used from discord, web or both
• Automatically saves any session that hasn't been fully completed, so you can resume listening later exactly where you left off
• Keeps track of every action that is performed and allows you to view who performed it and when
• Whitelist roles, users and channels
• Exclusive mode - Limit usage to current song requester
• Autoplay - plays recommended songs after the queue is empty
• Lyrics - Shows the lyrics for the currently playing song (only available on web)
• Autocomplete search - The play command uses autocomplete to let you search for songs
• Loop modes - Current song or queue
• Ability to shuffle, clear, reverse, remove songs or duplicates from the queue

Setup

Requirements

• .NET 8
• Running instance of Lavalink with LavaSrc, LavaSearch, youtube-source LavaLyrics
• Discord OAuth application, click here to create one
• MongoDB database

Installation

Important

I highly recommend using the docker compose script available in the releases section!

1. Clone the repository

git clone https://github.com/KMen1/Zeenox.git

2. Build project

dotnet restore "Zeenox/Zeenox.csproj"
dotnet build "Zeenox/Zeenox.csproj" -c Release -o /app/build
dotnet publish "Zeenox/Zeenox.csproj" -c Release -o /app/publish /p:UseAppHost=false

3. Edit appsettings.json in publish folder

{
  "Discord": {
    "Token": "",
    "Activity": "/play"
  },
  "ConnectionStrings": {
    "postgres": ""
  },
  "Lavalink": {
    "Host": "http://localhost:2333",
    "Password": "youshallnotpass"
  },
  "AllowedHosts": "*"
}

4. Run the bot from the publish folder

dotnet Zeenox.dll

License

• See LICENSE