davidoh

google cal on your terminal

this project combines the gcsa package, google calendar api, and openai to create an intelligent, command-line google calendar manager. it leverages natural language processing, allowing users to manage their calendar through simple voice commands or text input. say goodbye to clicking buttons - just speak or type your requests, and the system will handle the rest.

features:

• add new events to your google calendar using natural language
• delete events from your calendar with simple commands
• view existing events in a user-friendly format
• manage calendar settings effortlessly
• ai-powered event suggestions and optimizations

requirements:

• python 3.x
• google calendar api credentials.json (oauth)
• gcsa package (google calendar simple api)
• openai api key (follow the openai documentation for setup)

setting up:

1. clone the repository from github
2. install required packages: pip install -r requirements.txt
3. set up google calendar api credentials and save as credentials.json
4. setup openai client

usage:

run the main script:

python main.py

follow the on-screen prompts to interact with your google calendar using natural language commands. the ai will interpret your inputs and perform the appropriate actions.

file structure:

• main.py: entry point of the application
• add_new_event.py: handles adding new events to the calendar
• delete_an_event.py: manages event deletion
• view_events.py: displays calendar events
• settings.py: manages calendar settings

desktop shortcut (macos):

to create a desktop shortcut for easy access, follow these steps:

1. open terminal and navigate to your desktop
2. create a new file: nano run_gcal.command
3. add the following content:

   #!/bin/bash cd /path/to/your/project python3 main.py

4. save and exit (ctrl + o, then ctrl + x)
5. make the file executable: chmod +x run_gcal.command

now you can double-click the run_gcal.command file on your desktop to launch the application.

check out the github repo