VcObserver (Discord Bot plugin)

A lightweight plugin to monitor how much time members spend in voice channels.

Compatibility

Compatible with bots using discord.py.

Ensure the following intents are enabled:

• voice_states
• members

Installation

1. Copy src/vc_observer.py into your project.
2. Import the VcObserver class.
3. Ensure logging is initialized in your bot.
4. Instantiate the class with the following parameters: bot, tree, filepath, and optionally guild_ids.
5. Call tree.sync() after initializing VcObserver(); otherwise, commands will not sync.

If you're having trouble, please take a look at the example file at src/app.py.

Behavior

When a user connects, disconnects, or switches between voice channels, the bot logs their time spent in the previous channel to a JSON file.