A Blackboard bot for fetching and displaying Blackboard announcements to your Discord server. We currently support:

• NTNU (Using an older blackboard version from 2017).

NOTE: Does the bot work with your schools Blackboard? Let us know!

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. We also have a Discord server to chat regarding development, help setting up the bot or general discussion, see this link.

You can check out and explore the Blackboard Discord bot here.

You need Java 11 and Maven to be able to contribute to the project.

You can use and test the bot on the Discord server, but if you want to create your own Discord bot you can follow this guide. You need the Discord bot token as well as the Discord channel ID for the next section.

For the Blackboard bot to work, you need to copy the application.properties.template to application.properties. The file holds the required values for the bot to work. A snippet template of the file is shown below. This file should NEVER be pushed to the repository or shared with anyone as it holds private information. Only have this locally.

### NTNU BlackBoard credentials ###
username={BLACKBOARD_AUTH_USERNAME}
password={BLACKBOARD_AUTH_PASSWORD}

# How many minutes to wait to check for new announcements
interval=60

### Bot ###
#https://discordapp.com/channels/{server_id}/{channel_id} (from discord web app)
channel_id={CHANNEL_ID_LOCATED_IN_URL_OF_SELECTED_DISCORD_SERVER}

# Token for your bot (from Discord Developer Portal)
token={DISCORD_BOT_TOKEN}

• Java 11 - Language and version used
• Maven - Dependency Management
• JDA - Java Discord API

Contribution guide will come shortly.

• PersonligFrelser - Initial work/creator
• ANicholasson - Contributor

See also the list of contributors who participated in this project.

This project is licensed under the MIT License - see the LICENSE.md file for details.