Awesome Open Source
Awesome Open Source


Discord-Study-Bot is an open-source solution for implementing a Study-Time-based leaderboard system in discord servers. This open-source programme features an overall leaderboard and leaderboards based on a Daily, Weekly, and Monthly basis which will help a student to concentrate more on their studies.


  • Global Study-Time Leaderboard
  • Monthly Study-Time Leaderboard
  • Weekly Study-Time Leaderboard
  • Daily Study-Time Leaderboard


  1. Clone the repo or download manually.
git clone
  1. Move to cloned/downloaded directory cd Discord-Study-Bot
  2. Use pip to install Discord-Study-Bot.
pip install -r requirements.txt
  1. Make a bot from Discord Developer Portal and grab the token and fill in
  2. Make a remote database in MongoDB and fill in with your cluster, database, and collection.

Deploy on heroku

  • Create a new app in heroku and choose your relevant region.
  • Fork this repo and make it private.
  • Add your API keys or follow 4. and 5. of Installation.
  • Add a Procfile with worker as
  • Add deployment method as Github in the website.
  • Go ahead and deploy on heroku.


  • Join your Discord bot on your server.
  • Build Study text and voice channel and add them in

    Study Channels

  • Replace Channel IDs with your channel IDs.
  • Add your studying discord role.

    Studing Role

  • Run python
  • Type +help in your server.



Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.


MIT Shubhayu Majumdar

What next?

  • Add feature to reply back with last study time when a user leaves study room.
  • Add a notification when a user overtakes another user in leaderboards.
    Please open an issue with your feature idea.


If you like this project, give it a , share it with friends!

Feel free to Sponsor this project. Buy me a coffee

Made with and Python

Powered by Heroku

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (797,356
Python3 (797,346
Database (93,032
Mongodb (29,542
Discord (19,209
Heroku (19,075
Discord Bot (8,787
Discord Py (1,450
Heroku Deployment (762
Mongodb Database (257
Leaderboard (162
Discord Server (133
Fill (55
Studying (51