3 Commits

Author SHA1 Message Date
4177cd073a 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
2024-06-07 15:32:29 +02:00
367b3adf09 add intro text
All checks were successful
Rust / build (push) Successful in 56s
Rust / test (push) Successful in 51s
Rust / clippy (push) Successful in 39s
Rust / fmt (push) Successful in 42s
Rust / pre-commit (push) Successful in 44s
Rust / build (pull_request) Successful in 46s
Rust / test (pull_request) Successful in 47s
Rust / clippy (pull_request) Successful in 44s
Rust / fmt (pull_request) Successful in 38s
Rust / pre-commit (pull_request) Successful in 42s
2024-06-07 14:50:11 +02:00
2c42c6769b add deployment instructions to readme
All checks were successful
Rust / build (push) Successful in 50s
Rust / test (push) Successful in 54s
Rust / clippy (push) Successful in 38s
Rust / fmt (push) Successful in 1m34s
Rust / pre-commit (push) Successful in 41s
2024-06-07 14:35:53 +02:00
2 changed files with 28 additions and 9 deletions

View File

@@ -5,5 +5,32 @@
Ohrwurm
</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
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