https://github.com/ryghub/angybot

Music player bot for Discord supporting unusual formats and features
https://github.com/ryghub/angybot

discord discord-bot music-bot plex rust serenity songbird

Last synced: about 1 month ago
JSON representation

Music player bot for Discord supporting unusual formats and features

• Host: GitHub
• URL: https://github.com/ryghub/angybot
• Owner: RYGhub
• License: other
• Created: 2022-10-31T03:45:45.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-06T00:13:47.000Z (12 months ago)
• Last Synced: 2024-01-06T01:27:41.095Z (12 months ago)
• Topics: discord, discord-bot, music-bot, plex, rust, serenity, songbird
• Language: Rust
• Homepage:
• Size: 246 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# ![](.media/icon.png) Angy Bot

Music player bot for Discord supporting unusual formats and features, intended for use in the [RYG community](https://www.ryg.one/).

> **Warning**

>

> Very hastily developed with no regards to security or code quality, use it at your own risk!

## Links

*No links available right now.*

## Screenshots

![The bot being summoned, a Plex track being played, and playback being stopped in a Discord chat.](.media/screenshot-slash.png)

## Features

Currently supports playing from:

- local filesystem

- yt-dlp

- local Plex instance

> **Warning**

> 

> The bot currently supports only the playback of a single track at a time.

## Commands

The bot registers the following Slash Commands:

- `/summon channel:...` · Makes the bot connect to a channel

- `/play file what:...` · If you are the bot owner, plays the file at the given path.

- `/play ytdl what:...` · Tries to download and play the given string with yt-dlp, falling back to `ytsearch:` if it is not a valid URL.

- `/play plex what:...` · Queries a Plex Media Server for a track name, and plays the first result returned.

- `/stop` · Stops playback of any track.

## Installation

Use the provided Docker image:

- [`ghcr.io/ryghub/angybot`](https://github.com/RYGhub/angybot/pkgs/container/angybot)

The following environment variables must be set to configure the bot:

- `ANGY_TOKEN` · The Discord bot token to use.

- `ANGY_APPID` · The Discord application id to use.

- `ANGY_PLEX_SERVER` · The Plex server to use.

- `ANGY_PLEX_TOKEN` · The Plex token to use.

- `ANGY_PLEX_LIBRARY` · The Plex library to use.

- `ANGY_PLEX_REPLACE_FROM` · The string to remove from the media file path for Plex files.

- `ANGY_PLEX_REPLACE_TO` · The string to add in the media file path for Plex files.

- `ANGY_DEV_GUILD_ID` · The guild id to register Slash Commands in.

- `ANGY_DEV_USER_ID` · The user id allowed to use `/play file`.