aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorParker <contact@pkrm.dev>2024-12-03 22:39:41 -0600
committerParker <contact@pkrm.dev>2024-12-03 22:39:41 -0600
commit752f4ffde611926437c11fc89d993cc6ffe6ac89 (patch)
treee933b58d1f10dac1f495844e623adf6989406142
parent6ea84f6233588935f43f00581cc6af94b5851f41 (diff)
Update references/documentation
-rw-r--r--README.md54
-rw-r--r--config.yaml.example26
2 files changed, 64 insertions, 16 deletions
diff --git a/README.md b/README.md
index 090d54e..d712776 100644
--- a/README.md
+++ b/README.md
@@ -59,34 +59,56 @@ To run Guava on bare metal, follow the steps below.
5. Input information into the newly created config.yaml file.
6. Re-run the `code/bot.py` file.
+# Lavalink
+
+For instructions on setting up a Lavalink node on bare metal, look [here](https://lavalink.dev/getting-started/). Refer to the plugin repositories for support on configuring them.
+
+*P.S. Only the Deezer/SoundCloud sources/search providers are needed in the LavaSrc plugin.*
+
+After setting up your Lavalink node, it is highly recommended to configure IPv6 rotation with at least a /64 or /48 block. IPv6 rotation helps to relieve issues from getting rate limited/blocked from YouTube and other sources. There are helpful guides for setting this up which are available on GitHub, however, [this](https://github.com/Nansess/tunnelbroker-guide) is the one that I have used .
+
+An example of my personal `application.yml` configuration file can be found [here](application.yml).
+
# Configuration
+## BOT_INFO | REQUIRED
Field | Description | Requirement
--- | --- | ---
TOKEN | The token for your bot. Create a bot at [discord.com/developers](https://discord.com/developers) | **REQUIRED**
-BOT_COLOR | `HEX CODE`: Color that will be used for the color of message embeds | **REQUIRED**
-BOT_INVITE_LINK | `URL`: Discord Invite link for your bot (shown on the `help` command) | **OPTIONAL** - *Adds an "Invite Me" button to the /help message*
-FEEDBACK_CHANNEL_ID | `CHANNEL ID`: Discord channel for feedback messages to be sent to | **OPTIONAL** - *Used for feedback messages*
-BUG_CHANNEL_ID | `CHANNEL ID`: Discord channel for bug messages to be sent to | **OPTIONAL** - *Used for bug reporting*
-YOUTUBE_SUPPORT | `BOOLEAN`: Whether or not YouTube links are supported | **OPTIONAL**
-SPOTIFY_CLIENT_ID | `CLIENT ID`: ID from Spotify Developer account | **OPTIONAL** - *Used for Spotify support*
-SPOTIFY_CLIENT_SECRET | `CLIENT SECRET`: Secret string from Spotify Developer account | **OPTIONAL** - *Used for Sporify support*
-GENIUS_CLIENT_ID | `CLIENT ID`: ID from Genius API Dashboard | **OPTIONAL** - *Used for the /lyrics command*
-GENIUS_CLIENT_SECRET | `CLIENT SECRET`: Secret string from Genius API Dashboard | **OPTIONAL** - *Used for the /lyrics command*
-OPENAI_API_KEY | API Key from OpenAI for autoplay recommendations | **OPTIONAL** - *Used to support the /autoplay feature*
+BOT_COLOR | `HEX CODE`: Color that will be used for message embeds | **REQUIRED**
+BOT_INVITE_LINK | `URL`: Discord Invite link for your bot | **OPTIONAL** - *Adds an "Invite Me" button to the /help message*
+FEEDBACK_CHANNEL_ID | `CHANNEL ID`: Discord channel for feedback messages to be sent to | **OPTIONAL** - *Used for feedback messages (/feedback)*
+BUG_CHANNEL_ID | `CHANNEL ID`: Discord channel for bug messages to be sent to | **OPTIONAL** - *Used for bug reporting (/bug)*
+LOG_SONGS | `BOOLEAN`: Whether or not to log song events in `track_events.log` | **OPTIONAL** - *default false*
+
+## LAVALINK - REQUIRED
+Field | Description | Requirement
+--- | --- | ---
HOST | Host address for your Lavalink node | **REQUIRED**
PORT | Port for your Lavalink node | **REQUIRED**
PASSWORD | Password to authenticate into the Lavalink node | **REQUIRED**
-# Lavalink
-
-For instructions on setting up a Lavalink node on bare metal, look [here](https://lavalink.dev/getting-started/). Refer to the plugin repositories for support on configuring them.
+## YOUTUBE - OPTIONAL
+Field | Description | Requirement
+--- | --- | ---
+ENABLED | `BOOLEAN`: Whether or not playing from YouTube is allowed/supported | **OPTIONAL**
-*P.S. Only the Deezer/SoundCloud sources/search providers are needed in the LavaSrc plugin.*
+## SPOTIFY - OPTIONAL
+Field | Description | Requirement
+--- | --- | ---
+SPOTIFY_CLIENT_ID | `CLIENT ID`: ID from Spotify Developer account | **OPTIONAL** - *Used for Spotify support*
+SPOTIFY_CLIENT_SECRET | `CLIENT SECRET`: Secret string from Spotify Developer account | **OPTIONAL** - *Used for Sporify support*
-After setting up your Lavalink node, it is highly recommended to configure IPv6 rotation with at least a /64 or /48 block. IPv6 rotation helps to relieve issues from getting rate limited/blocked from YouTube and other sources. There are helpful guides for setting this up which are available on GitHub, however, [this](https://github.com/Nansess/tunnelbroker-guide) is the one that I have used .
+## GENIUS - OPTIONAL
+Field | Description | Requirement
+--- | --- | ---
+GENIUS_CLIENT_ID | `CLIENT ID`: ID from Genius API Dashboard | **OPTIONAL** - *Used for the /lyrics command*
+GENIUS_CLIENT_SECRET | `CLIENT SECRET`: Secret string from Genius API Dashboard | **OPTIONAL** - *Used for the /lyrics command*
-An example of my personal `application.yml` configuration file can be found [here](application.yml).
+## OPENAI - OPTIONAL
+Field | Description | Requirement
+--- | --- | ---
+OPENAI_API_KEY | API Key from OpenAI for autoplay recommendations | **OPTIONAL** - *Used to support the /autoplay feature*
<br>
diff --git a/config.yaml.example b/config.yaml.example
index e69de29..701e23c 100644
--- a/config.yaml.example
+++ b/config.yaml.example
@@ -0,0 +1,26 @@
+bot_info:
+ token:
+ bot_color:
+ bot_invite_link:
+ feedback_channel_id:
+ bug_channel_id:
+ log_songs: true
+
+lavalink:
+ host:
+ port:
+ password:
+
+youtube:
+ enabled: false
+
+spotify:
+ spotify_client_id:
+ spotify_client_secret:
+
+genius:
+ genius_client_id:
+ genius_client_secret:
+
+openai:
+ openai_api_key: \ No newline at end of file