ATEC Discord Bot

Atec BOT Send Calendar to Discord!

This repository hosts a bot that automates the process of logging into the ATEC training server, capturing a screenshot of your personal calendar, and posting it to a specified Discord channel.

📋 Table of Contents

• ✨ Features
• ⚠️ Requirements
• 🛠️ Installation
• ⚙️ Usage
• 🧾 Logging
• 🔨 Troubleshooting
• 🗂️ Project Structure
• 🤝 Contributing
• 🛑 Issues
• 📢 Acknowledgements
• 📜 License

✨ Features

• Automated login to the ATEC training server.
• Navigation to the personal calendar page.
• Capture of the calendar as a .png screenshot.
• Automated posting of the screenshot to a specified Discord server.

⚠️ Requirements

• Python 3.6+
• selenium
• pillow
• discord.py
• aiohttp
• python-dotenv
• Google Chrome
• ChromeDriver

🛠️ Installation

1. Clone the Repository:

   git clone https://github.com/rubsxyz/ATEC-Calendar-Discord-Bot.git
   cd atec_send_calendar_discord

2. Set Up a Virtual Environment:

   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`

3. Install Dependencies:

   pip install -r requirements.txt

4. Set Up Environment Variables:

   Create a .env file in the root directory of the project with the following content:

   USERNAME=your_username
   PASSWORD=your_password
   DISCORD_TOKEN=your_discord_token
   

   Replace your_username, your_password and your_discord_token with your actual ATEC login credentials and Discord bot token.

   To create a Discord bot and get the token, follow this guide.

5. Ensure ChromeDriver is in Your PATH:

   Make sure that ChromeDriver is installed and added to your system PATH. You can download ChromeDriver from here.

⚙️ Usage

To run the script, execute:

python main.py

The script will:

1. Log into the ATEC training server using the provided credentials.
2. Navigate to the personal calendar page.
3. Capture a screenshot of the calendar.
4. Send the screenshot to the specified Discord channel.

🧾 Logging

The script logs its actions and any errors encountered in a bot.log file in the root directory. This file is overwritten each time the script runs.

🔨 Troubleshooting

• Login Issues: Ensure that your username and password are correctly entered in the .env file.
• Discord Bot Issues: Ensure that your Discord bot token and channel ID are correctly entered in the .env file and that your bot has permission to post in the specified channel.
• ChromeDriver Issues: Ensure that ChromeDriver is correctly installed and added to your system PATH.

🗂️ Project Structure

ATEC-Calendar-Discord-Bot/
│
├── src/
│ ├── init.py
│ ├── calendar_interaction.py
│ ├── config.py
│ ├── discord_bot.py
│ ├── web_interaction.py
│
├── images/ (created at first run)
│ └── (Captured images are stored here)
│
├── .env (read Installation)
├── .gitignore
├── bot.log (created at first run)
├── LICENSE.txt
├── main.py
├── README.md 
└── requirements.txt

🤝 Contributing

Feel free to fork the repository and submit pull requests. For major changes, please open an issue first to discuss what you would like to change.

🛑 Issues

If you encounter any issues, please open a new issue in the Issues section of the repository.

📢 Acknowledgements

• Selenium
• Pillow (PIL Fork)
• discord.py
• aiohttp
• python-dotenv

📜 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.