TempleBot

A Discord bot dedicated to Terry Davis and TempleOS.

TempleBot is a simple python Discord bot that provides useful information about Terry Davis, the creator of TempleOS, and his unique operating system, TempleOS. This bot aims to educate and inspire users about Terry Davis's remarkable journey, his accomplishments, and the fascinating world of TempleOS.

Purpose

• Display biographical information about Terry Davis
• Explain the purpose, features, and creation of TempleOS
• Share interesting facts and quotes related to Terry Davis and TempleOS
• Provide links to relevant resources and documentation

Setup

Prerequisites

• Python 3.6 or higher
• discord.py library

Installation

1. Clone the repo:

git clone https://github.com/your-username/TempleBot.git

2. Install the required dependencies:

cd TempleBot
pip install -r requirements.txt

3. Create a new Discord bot and obtain its token from the Discord Developer Portal.

4. Set the bot token as an environment variable named DISCORD_BOT_TOKEN.

5. Run the bot:

python main.py

Usage

Once the bot is running, you can interact with it using the following commands:

• !terry: Get biographical information about Terry Davis.
• !templeos: Learn about the TempleOS operating system.
• !fact: Receive an interesting fact or quote about Terry Davis or TempleOS.
• !gif: Receive a random Terry Davis or TempleOS related GIF, some GIFs are more rare to occur than others.
• !resources: Get links to relevant resources and documentation.
• !colors: Display the 16-color palette used in TempleOS with color names and hex codes.

Contributing

Note

Contributions are welcome! If you find any issues or want to add new features, feel free to open an issue or submit a pull request.

Here's how you can contribute:

1. Fork the repository

2. Create a new branch:

git checkout -b my-new-feature

3. Make your changes and then add them:

git add --all

4. Make your changes and commit them:

git commit -am 'Add some feature'

5. Push to the branch:

git push origin my-new-feature

5. Submit a pull request

JSON File Structure

The bot uses JSON files to store quotes and GIFs. Here's an explanation of the structure:

Quotes

The quotes.json file contains an array of quotes. Each quote is a string. Here's an example:

{
    "quotes": [
        "This is a quote!"
    ]
}

Important

To add a new quote, simply append it to the quotes array.

GIFs

The gifs.json file contains an array of GIF objects. Each object has two properties: url (the URL of the GIF) and probability (an integer representing the probability of displaying the GIF). Here's an example:

{
    "gifs": [
      {
        "url": "https://example.com/gif1.gif",
        "probability": 90
      },
      {
        "url": "https://example.com/gif2.gif",
        "probability": 90
      },
      {
        "url": "https://example.com/gif3.gif",
        "probability": 15
      }
    ]
}

Important

To add a new GIF, append a new object to the gifs array with the appropriate url and probability values.

License

This project is licensed under the MIT License.

Acknowledgments

• Terry Davis for his remarkable work on TempleOS.
• The Discord.py library and its contributors for providing a powerful Python API for building Discord bots.

Show Your Support

If you find this project valuable, please consider giving it a ⭐️ on GitHub!