|
| 1 | +> [!NOTE] |
| 2 | +> Please note that this bot is not actively maintained. Some services, especially those related to embed fixes, may occasionally go down. |
| 3 | +
|
| 4 | +# Discord-SM |
| 5 | + |
| 6 | +This is a Node.js-based Discord bot that plays music from various sources including Spotify, YouTube, and SoundCloud. It also includes features for managing the music queue, supports multiple commands, and handles social media link embeds. |
| 7 | + |
| 8 | +## Features |
| 9 | + |
| 10 | +- **Music Playback**: Add, skip, stop, and manage songs in the queue from various sources. |
| 11 | +- **Social Media Link Embeds**: Automatically replaces original embeds for social media links with custom embed fixes. |
| 12 | +- **Multilanguage Support**: The bot can operate in multiple languages. Currently available languages are English and German. |
| 13 | + |
| 14 | +## Docker Setup |
| 15 | + |
| 16 | +This bot runs in a Docker container. To set up and run the bot using Docker, follow these steps: |
| 17 | + |
| 18 | +### Prerequisites |
| 19 | + |
| 20 | +Ensure you have Docker installed on your system. |
| 21 | + |
| 22 | +### Installation |
| 23 | + |
| 24 | +1. **Clone this repository**. |
| 25 | + |
| 26 | +2. **Navigate to the project directory** where the Dockerfile and `compose.yml` are located. |
| 27 | + |
| 28 | +3. **Build and start the Docker container** using Docker Compose: |
| 29 | + ```sh |
| 30 | + docker compose up --build |
| 31 | + ``` |
| 32 | + |
| 33 | + This command will: |
| 34 | + - Build the Docker image as defined in the `Dockerfile`. |
| 35 | + - Start the container with the configuration specified in `compose.yml`. |
| 36 | + |
| 37 | +### Configuration |
| 38 | + |
| 39 | +Before running the Docker container, make sure you set up the necessary environment variables. Create a `.env` file in the `data` directory with the following content: |
| 40 | + |
| 41 | +```sh |
| 42 | +DISCORD_TOKEN=<discord-token> |
| 43 | +CLIENT_ID=<bot-client-id> |
| 44 | +``` |
| 45 | + |
| 46 | +Replace `<discord-token>` and `<bot-client-id>` with your actual Discord bot token and client ID. |
| 47 | + |
| 48 | +## Commands |
| 49 | + |
| 50 | +Here's an overview of the available commands: |
| 51 | + |
| 52 | +### Slash Commands |
| 53 | + |
| 54 | +| Command | Description | Options | |
| 55 | +|--------------|-----------------------------------------------------------------------------|---------------------------------------| |
| 56 | +| `/play` | Add a song from Spotify, YouTube, SoundCloud, or similar to the queue. | `song`: Song title or link (required) | |
| 57 | +| `/stop` | Clear the queue and kick the bot from the channel. | | |
| 58 | +| `/skip` | Skip the current song in the queue. | | |
| 59 | +| `/listqueue` | Display a list of the current queue. | | |
| 60 | +| `/wrongsong` | Remove the last song requested by you from the queue. | | |
| 61 | +| `/song` | Display the current song. | | |
| 62 | +| `/language` | Set the bot's language for the entire server. | `lang`: Language choice (required) | |
| 63 | + |
| 64 | +### Text Commands |
| 65 | + |
| 66 | +| Command | Description | |
| 67 | +|----------------|--------------------------------------------------| |
| 68 | +| `!forcedelete` | Deletes all guild-specific commands for the bot. | |
| 69 | +| `!forceupdate` | Updates all guild-specific commands for the bot. | |
| 70 | + |
| 71 | +## Localization |
| 72 | + |
| 73 | +The bot supports multiple languages. Currently available languages are English and German. You can change the bot's language using the `/language` command. |
| 74 | + |
| 75 | +## License |
| 76 | + |
| 77 | +This project is licensed under the MIT License. |
0 commit comments