.github | ||
src | ||
.dockerignore | ||
.env.example | ||
.gitignore | ||
CHANGELOG.md | ||
Dockerfile | ||
LICENSE | ||
nodemon.json | ||
package.json | ||
README.md | ||
tsconfig.json | ||
yarn.lock |
Muse is a highly-opinionated midwestern self-hosted Discord music bot that doesn't suck. It's made for small to medium-sized Discord servers/guilds (think about a group the size of you, your friends, and your friend's friends).
Features
- 🎥 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
- ✍️ Written in TypeScript, easily extendable
- ❤️ Loyal Packers fan
Design Philosophy
I believe it makes much more sense to let Discord handle user permissions (whenever possible) rather than building them into a bot and adding additional complexity. Instead of only allowing users with a certain role to control Muse, Muse allows anyone who has access to its bound channel to control it. Instead of specifying the owner as a user ID in the config, Muse simply looks at the guild owner.
Running
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.
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.
Versioning
The master
branch acts as the developing / bleeding edge branch and is not guaranteed to be stable.
When running a production instance, I recommend that you use the latest release.
Docker
There are a variety of image tags available:
:2
: versions >= 2.0.0:2.1
: versions >= 2.1.0 and < 2.2.0:2.1.1
: an exact version specifier:latest
: whatever the latest version is
(Replace empty config strings with correct values.)
docker run -it -v "$(pwd)/data":/data -e DISCORD_TOKEN='' -e SPOTIFY_CLIENT_ID='' -e SPOTIFY_CLIENT_SECRET='' -e YOUTUBE_API_KEY='' codetheweb/muse:latest
This starts Muse and creates a data directory in your current directory.
Docker Compose:
version: '3.4'
services:
muse:
image: codetheweb/muse:latest
restart: always
volumes:
- ./muse:/data
environment:
- DISCORD_TOKEN=
- YOUTUBE_API_KEY=
- SPOTIFY_CLIENT_ID=
- SPOTIFY_CLIENT_SECRET=
Node.js
Prerequisites: Node.js, ffmpeg
git clone https://github.com/codetheweb/muse.git && cd muse
- Copy
.env.example
to.env
and populate with values - I recommend checking out a tagged release with
git checkout v[latest release]
yarn install
(ornpm i
)yarn build
(ornpm run build
)yarn start
(ornpm run start
)
Note: if you're on Windows, you may need to manually set the ffmpeg path. See #345 for details.
Advanced
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
.