Muse is a self-hosted Discord music bot for small to medium-sized Discord servers/guilds. muse-simple is a variant with non-opinionated, generic text for a formal, utilitarian vibe.
muse-simple only changes strings. It does not change any functionality associated with the original Muse. Please support the original developers.
- 🎥 Livestreams
- ⏩ Seeking within a song/video
- 💾 Local caching for better performance
- 📋 No vote-to-skip - this is anarchy, not a democracy
↔️ Autoconverts playlists / artists / albums / songs from Spotify↗️ Users can add custom shortcuts (aliases)- 1️⃣ Muse instance supports multiple guilds
- 🔊 Normalizes volume across tracks
- ✍️ Written in TypeScript, easily extendable
Muse is written in TypeScript. You can either run Muse with Docker (recommended) or directly with Node.js. Both methods require API keys passed in as environment variables:
DISCORD_TOKEN
can be acquired here by creating a 'New Application', then going to 'Bot'.SPOTIFY_CLIENT_ID
andSPOTIFY_CLIENT_SECRET
can be acquired here with 'Create a Client ID'.YOUTUBE_API_KEY
can be acquired by creating a new project in Google's Developer Console, enabling the YouTube API, and creating an API key under credentials.
Warning
Even if you don't plan on using Spotify, you must still provide the client ID and secret; otherwise Muse will not function.
Muse will log a URL when run. Open this URL in a browser to invite Muse to your server. Muse will DM the server owner after it's added with setup instructions.
A 64-bit OS is required to run Muse.
The master
branch will update to match the upstream Muse master branch whenever the bot breaks. You can set muse/master as an "upstream" remote if you need to update yourself.
You can use a stable version of Muse diffed against muse-simple for a guaranteed stable build.
Prerequisites:
- Node.js (16.x is recommended because it's the current LTS version)
- ffmpeg (4.1 or later)
git clone https://github.com/Orangestar12/muse-simple.git && cd muse
- Copy
.env.example
to.env
and populate with values yarn install
(ornpm i
)yarn start
(ornpm run start
)
Note: if you're on Windows, you may need to manually set the ffmpeg path. See #345 for details.
By default, Muse limits the total cache size to around 2 GB. If you want to change this, set the environment variable CACHE_LIMIT
. For example, CACHE_LIMIT=512MB
or CACHE_LIMIT=10GB
.
Muse can skip non-music segments at the beginning or end of a Youtube music video (Using SponsorBlock). It is disabled by default. If you want to enable it, set the environment variable ENABLE_SPONSORBLOCK=true
or uncomment it in your .env.
Being a community project, the server may be down or overloaded. When it happen, Muse will skip requests to SponsorBlock for a few minutes. You can change the skip duration by setting the value of SPONSORBLOCK_TIMEOUT
.
In the default state, Muse has the status "Online" and the text "Listening to Music". You can change the status through environment variables:
-
BOT_STATUS
:online
(Online)idle
(Away)dnd
(Do not Disturb)
-
BOT_ACTIVITY_TYPE
:PLAYING
(Playing XYZ)LISTENING
(Listening to XYZ)WATCHING
(Watching XYZ)STREAMING
(Streaming XYZ)
-
BOT_ACTIVITY
: the text that follows the activity type -
BOT_ACTIVITY_URL
If you useSTREAMING
you MUST set this variable, otherwise it will not work! Here you write a regular YouTube or Twitch Stream URL.
Muse is watching a movie and is DND:
BOT_STATUS=dnd
BOT_ACTIVITY_TYPE=WATCHING
BOT_ACTIVITY=a movie
Muse is streaming Monstercat:
BOT_STATUS=online
BOT_ACTIVITY_TYPE=STREAMING
BOT_ACTIVITY_URL=https://www.twitch.tv/monstercat
BOT_ACTIVITY=Monstercat
If you have Muse running in a lot of guilds (10+) you may want to switch to registering commands bot-wide rather than for each guild. (The downside to this is that command updates can take up to an hour to propagate.) To do this, set the environment variable REGISTER_COMMANDS_ON_BOT
to true
.