📚 Study Bot – Discord Productivity Assistant

---

🚀 Overview

Study Bot is a Discord bot designed to help you and your community stay productive. It provides Pomodoro study sessions, session tracking, and scheduled tasks — making it ideal for study servers, accountability groups, and productivity enthusiasts.

---

✨ Features

• ⏳ Pomodoro Timers – Start, pause, and resume study sessions
• 💾 Session Persistence – Restores active sessions on restart
• 📅 Scheduled Jobs – Weekly summary/notification using node-cron
• 📊 SQLite Database – Stores session history & active sessions
• 🔐 Role-based Permissions – Admin-only commands for bot management
• ⚡ Slash Commands with Discord’s latest API

---

🛠️ Tech Stack

• Node.js
• discord.js
• SQLite3
• node-cron
• dotenv

---

⚙️ Installation

1. Clone the repository

   git clone https://github.com/your-username/study-bot.git
   cd study-bot

2. Install dependencies

   npm install

3. Set up environment variables Create a .env file in the root folder:

   DISCORD_TOKEN=your_discord_bot_token
   CLIENT_ID=your_discord_app_client_id
   GUILD_ID=your_discord_server_id   # optional (for development)
   OWNER_ID=your_discord_user_id
   ADMIN_ROLE_ID=your_admin_role_id

4. Run the bot

   node index.js

---

📂 Project Structure

index.js              # Main bot logic
.env.example          # Example environment variables
package.json          # Dependencies and scripts
schema_reset.sql      # Reset script for database
data/                 # SQLite database files (auto-created)

---

📸 Screenshots / Demo

(Add screenshots of your bot running, Pomodoro timers, and sample commands)

---

🤝 Contributing

Contributions are welcome!

1. Fork the project
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit changes (git commit -m "Add feature")
4. Push to branch (git push origin feature/your-feature)
5. Open a Pull Request

---

📜 License

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

---

💡 Future Improvements

• ✅ Add leaderboards for study sessions
• ✅ Implement reminders/alerts for break times
• ✅ Add web dashboard for session statistics
• ✅ Multi-guild support with custom settings