Merge pull request 'Improve readme' (#1) from dev into main
All checks were successful
release / release-image (push) Successful in 58m12s
Rust / build (push) Successful in 5m38s
Rust / test (push) Successful in 1m10s
Rust / clippy (push) Successful in 39s
Rust / fmt (push) Successful in 1m53s
Rust / pre-commit (push) Successful in 43s

Reviewed-on: #1
This commit was merged in pull request #1.
This commit is contained in:
2024-06-07 15:32:29 +02:00
2 changed files with 28 additions and 9 deletions

View File

@@ -5,5 +5,32 @@
Ohrwurm Ohrwurm
</p> </p>
Ohrwurm is a user-friendly bot designed to play music in Discord voice chats. Once added to your server, you can request a song using the command `/play {query}`, where query can be a URL to a YouTube video or playlist, or a simple search term. The bot will fetch the song and start playing it. You can pause the music with `/pause`, resume playback with `/resume`, and stop and clear the queue with `/stop`. If the bot is alone in a voice chat, it will automatically leave, but you can also manually make it leave with the `/leave` command.
# Deployment # Deployment
Create a `.env` environment file that contains the `DISCORD_TOKEN` and `DISCORD_APP_ID` of your bot, then build the container with `docker-compose build` before running it with `docker-compose up`. To deploy Ohrwurm with Docker, you can use the [provided Docker](https://hub.docker.com/r/jheuel/ohrwurm) image:
```bash
docker run -d \
--name ohrwurm \
--restart unless-stopped \
-e DISCORD_TOKEN=YOUR_DISCORD_BOT_TOKEN \
-e DISCORD_APP_ID=YOUR_DISCORD_APP_ID \
-e ADMIN=YOUR_DISCORD_USER_ID \
jheuel/ohrwurm:latest
```
Alternatively, you can create a `docker-compose.yml` file:
```yaml
services:
ohrwurm:
container_name: ohrwurm
image: jheuel/ohrwurm:latest
restart: unless-stopped
env:
- DISCORD_TOKEN=YOUR_DISCORD_BOT_TOKEN
- DISCORD_APP_ID=YOUR_DISCORD_APP_ID
- ADMIN=YOUR_DISCORD_USER_ID
```
and then run the image with `docker compose up`.

View File

@@ -1,8 +0,0 @@
---
services:
ohrwurm:
build: .
container_name: ohrwurm
restart: unless-stopped
env_file:
- .env