-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
93d6ad5
commit 2d28f37
Showing
1 changed file
with
28 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
# CUNY Blackboard Bot: A Discord Bot To Manage Your Courses, Assignments & More | ||
#### Powered by [`Discord.js`](https://github.com/discordjs/discord.js) | ||
|
||
## How To Install? | ||
|
||
1. Install [[> Node.js]](https://nodejs.org/en/) v18+ (recommended) on your machine. | ||
2. Clone this **repository** to your machine. | ||
3. Run `npm install` inside of the cloned directory. | ||
4. Create a copy of `example.env`, name it `.env`, fill the variables as instructed. | ||
- **Required:** See [[> Discord Developer Portal]](https://discord.com/developers/docs/intro) for creating a Discord bot and application. | ||
5. Run the `index.js` file using `node index.js` to start your bot. | ||
- **Optional:** You may install `pm2` and run `index.js` with `pm2` for 24/7 uptime. | ||
6. Invite the Discord `Bot` to your Discord `Server` using the `invite link` logged in the terminal / console of `index.js`. | ||
7. Run the `/blackboard login` command to connect your CUNY Blackboard account with the bot. | ||
- **Note** the `/blackboard` command may be different if you have specified a different `COMMAND_PREFIX` in your `.env` file. | ||
|
||
## How To Use? | ||
The Discord Bot has various `slash commands` to manage your Blackboard courses, assigments, alerts and more. | ||
Simply type `/blackboard` in any channel to see all available commands and their respective descriptions / options. | ||
|
||
## Limitations | ||
This bot was written to be used for personal use only hence some of the limitations below. | ||
- Each connected Blackboard account's name, session cookies, preferences and other cache data is stored in a JSON on the filesystem. | ||
- While the bot can multiple Discord users in as many servers as the bot is a member of, there is no way to control permissions for individual users. | ||
- While you may host the bot and allow your peers to use the bot in a shared Discord server, all users should be mindful that their Blackboard can be accessed by the host easily due to the limitations above. | ||
|
||
## License | ||
[MIT](./LICENSE) |