OCULUS

A voice activity tracking Discord bot that logs member participation and generates time-based reports

"WE RECENTLY SWITCHED TO PY-CORD!!"

Features:

🔊 Voice Tracking:

• Records time spent by members in voice channels
• Tracks bot connection status and member join/leave events

💻 Command documentation:

• every command is a slash command (Discord's prefered way).

• the commands have role-based access; only those with specefic roles can use them.

• /join: makes the bot enter the voice channel you re in.

• /leave: the bot leaves the voice channel, you need to be in the vc for it to work, it calculates the time spent by each member and logs it as a Discord pagination.

• /list: logs real-time voice data in the bot specefic channel.

• /help: lists all available commands and what they do.

• /reset_data: deletes all past voice data and restarts tracking.

📔 Persistent Logging:

• Automatic voice_data.json storage
• Recreates deleted logging channel (#project-oculus)

Access Control:

• Role restrictions: Moderator/Admin roles only
• Channel protection: Critical logging channel can't be deleted

Installation:

1. Clone Repository:

git clone https://github.com/raoufblz/discord-attendance-bot.git
cd discord-attendance-bot

2. Set Up Environment: create a .env file for your bot token:

TOKEN=insert_your_discord_bot_token_here

3. Install dependencies:

pip install -r requirements.txt

4. start the bot:

python .\main.py

Usage:

• the bot creates a text channel to log the pagination to, even if deleted it recreates it.
• provided that you re in a voice channel use /join to invite the bot to that channel, the bot will start tracking from that time.
• you could use /list to see real-time voice data without losing track of it.
• once you want the bot to stop tracking the time, use /leave, the bot will leave the voice channel and log the pagination of the members who were present during its presence, sorted by their total duration.
• in case you need to delete the voice data or restart tracking, use /reset_data to delete all past data and start anew.
• in case you forget any of these commands or what they do, use the /help command.

Acknowledgment:

• Big thanks to @djely2005 for the original idea and his continuous feedback