This bot synchronizes events from a Google Calendar to a Discord server, creating scheduled voice channel meetings. It's designed to bridge the gap between your Google Calendar events and Discord voice channels, allowing for seamless transition from scheduled events to actual online meetings.

• Syncs events from Google Calendar to Discord as scheduled voice channel meetings.
• Creates, updates, and deletes Discord events based on Google Calendar changes.
• Automatically sets up voice channels for each synced event, ready for participants to join when the meeting time arrives.
• Ensures events accidentally deleted from Discord are recreated if they still exist in Google Calendar.
• Provides a seamless workflow from scheduling in Google Calendar to joining meetings in Discord.
• Logs all operations for easy troubleshooting and monitoring.

1. The bot regularly checks your specified Google Calendar for events.
2. For each event found, it creates or updates a corresponding scheduled event in your Discord server.
3. These Discord events are linked to voice channels, allowing participants to easily join the meeting when it's time.
4. As changes occur in Google Calendar (new events, updates, or deletions), the bot reflects these changes in Discord.
5. When the event time arrives, participants can join the associated Discord voice channel directly from the scheduled event.

This integration allows teams to manage their schedule in Google Calendar while leveraging Discord's powerful voice chat features for their actual meetings.

• Python 3.7+
• Google Calendar API credentials
• Discord bot token

git clone https://github.com/rempairamore/GCal2Discord.git
cd GCal2Discord

Install the required packages:

pip install -r requirements.txt

1. Go to the Google Cloud Console

2. Create a new project:

   • Click on the project dropdown at the top of the page.
   • Click "New Project."
   • Enter a name for your project and click "Create."

3. Enable the Google Calendar API:

   • In the project dashboard, click on "Enable APIs and Services."
   • Search for "Google Calendar API" and click on it.
   • Click "Enable."

4. Create credentials for the API:

   • Go to the "Credentials" tab on the left sidebar.
   • Click "Create Credentials" and select "Service Account."
   • Enter a name for the service account and click "Create."
   • Assign a role to the service account (e.g., "Editor") and click "Continue."
   • Click "Done."

5. Create a key for the service account:

   • In the "Credentials" tab, click on the service account you created.
   • Go to the "Keys" section and click "Add Key" > "Create new key."
   • Select "JSON" and click "Create." A JSON file will be downloaded to your computer.

6. Share your Google Calendar with the service account:

   • Open Google Calendar.
   • Go to the "Settings and sharing" of the calendar you want to sync.
   • In the "Share with specific people" section, add the service account's email address (found in the JSON file) and provide appropriate permissions (e.g., "Make changes to events").

7. Save the JSON credentials file:

   • Save the JSON file in your project directory and update the GOOGLE_CREDENTIALS_JSON path in var.py.

To configure the bot, you'll need the Discord bot token, the guild ID (server ID), and the channel ID where the bot will post the events. Here’s how you can obtain them:

1. Create a Discord Bot

   • Go to the Discord Developer Portal.
   • Click on "New Application" and give it a name.
   • Go to the "Bot" tab on the left sidebar and click "Add Bot".
   • Click "Yes, do it!" to confirm.
   • Under the "TOKEN" section, click "Copy" to copy your bot token. Save this token as you'll need it for the DISCORD_BOT_TOKEN variable in var.py.

2. Get Your Guild ID

   Enable Developer Mode in Discord: - Go to your Discord app. - Click on the gear icon (User Settings) next to your username. - Go to "Advanced" and enable "Developer Mode". Right-click on your server icon in Discord and click "Copy ID". Save this ID as you'll need it for the DISCORD_GUILD_ID variable in var.py.

3. Get Your Channel ID

   In Discord, right-click on the channel where you want the bot to post events and click "Copy ID". Save this ID as you'll need it for the DISCORD_CHANNEL_ID variable in var.py.

You can find a var.py_example file in the project. Simply modify this file with your credentials and rename it to var.py:

mv var.py_example var.py

Populate it with your credentials and configuration:

# var.py
GOOGLE_CREDENTIALS_JSON = 'path/to/your/google-credentials.json'
GOOGLE_CALENDAR_ID = 'your-google-calendar-id'
DISCORD_BOT_TOKEN = 'your-discord-bot-token'
DISCORD_GUILD_ID = 'your-discord-guild-id'
DISCORD_CHANNEL_ID = 'your-discord-channel-id'  # ID of the voice channel where the meetings will be held
SYNC_INTERVAL = 300  # Interval in seconds to sync events (5 minutes)
DAYS_IN_FUTURE = 10  # Number of days in the future to fetch events

1. Run the bot:

   python main.py

The bot logs all its operations to event.log. If the log file exceeds 200 MB, it will be compressed into a .tar.gz file and a new log file will be started.

To run the bot as a systemd service, follow these steps:

1. Create a systemd service file:

   Create a file named google-calendar-discord-bot.service in the /etc/systemd/system/ directory with the following content:

   [Unit]
   Description=Google Calendar to Discord Sync Bot
   After=network.target
   
   [Service]
   User=yourusername
   WorkingDirectory=/path/to/your/project
   ExecStart=/usr/bin/python3 /path/to/your/project/main.py
   Restart=always
   
   [Install]
   WantedBy=multi-user.target

   Replace yourusername with your system username and /path/to/your/project with the path to your project directory.

2. Reload systemd and start the service:

   sudo systemctl daemon-reload
   sudo systemctl start google-calendar-discord-bot

3. Enable the service to start on boot:

   sudo systemctl enable google-calendar-discord-bot

This project is licensed under the "GNU GENERAL PUBLIC LICENSE - Version 3 (29 June 2007)" license.