Skip to content

A private, self-hosted and customizable discord music bot that suits your needs.

Notifications You must be signed in to change notification settings

encodeous/musii

Repository files navigation

Disclaimer

In light of Google's recent crackdowns on Discord Music Bots, Musii is likely in direct violation of YouTube's Terms Of Service. Although Google most likely will not care about you running your own instance of Musii, you are still proceeding at your own risk.

What is Musii

Musii is an alternative music bot to large public bots like Rythm or Groovy. It is a private, customizable bot that suits your needs.

Features

In Musii v5, the features were overhauled and improved drastically

Main Features:

  • Automatic Spotify to YouTube conversion / playback
  • Archive playlists in "records" to be played later, or in another guild
  • Able to lock playback sessions, and only allow moderators to interact with them
  • Playlist "pinning" which supports 24/7 playback
  • Advanced event debugging/tracing

Other Features:

  • Movement of the play-head while playing a song
  • Adjust volume from 0% to 1000% (Moderator only above 100%)
  • Apply audio filters (Bass, Piano, Metal)
  • Looped Playback (Loop on current song, loop on playlist)
  • Shuffle Playlist
  • Skip / Skip Range
  • Jump forwards/backwards in the playlist
  • Save playlist into a record
  • Pause/Resume playback

Getting Started

You can setup your own private music player with Musii in a few simple steps.

  1. Setup Lavalink on your server. I also highly recommend reading this blog post!
  2. Clone the repository and compile Musii. For more information on how to build .NET apps, visit .NET Docs
  3. Go to the Discord Developer Portal and create a bot
  4. Go to the Spotify Developer Dashboard and create an application
  5. Edit appsettings.json with relevant information. This file will be generated on the first run: (partially shown):
{
  "musii": {
    "BotName": "Musii",
    "DefaultPrefix": "!",
    "DiscordToken": "",
    "SpotifyClientId": "",
    "SpotifyClientSecret": "",
    "LavalinkHost": "",
    "LavalinkPort": "",
    "LavalinkPassword": "",
    "DefaultQueueLength": "20",
    "InteractQueueTimeoutSeconds": "60"
  }
}
  1. Execute Musii, make sure the Lavalink server is setup correctly and is reachable.

  2. Invite the bot to your guild and !help to display help.

Libraries Used

About

A private, self-hosted and customizable discord music bot that suits your needs.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages