Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jenderal92/free-slot-finder
Free Slot Finder helps users find free time slots in their busy schedules by analyzing their Google Calendar events.
https://github.com/jenderal92/free-slot-finder
free-slot-finder google-calendar google-calendar-tool time-management
Last synced: 9 days ago
JSON representation
Free Slot Finder helps users find free time slots in their busy schedules by analyzing their Google Calendar events.
- Host: GitHub
- URL: https://github.com/jenderal92/free-slot-finder
- Owner: Jenderal92
- Created: 2024-12-24T23:07:57.000Z (13 days ago)
- Default Branch: main
- Last Pushed: 2024-12-24T23:12:57.000Z (13 days ago)
- Last Synced: 2024-12-25T00:23:58.518Z (13 days ago)
- Topics: free-slot-finder, google-calendar, google-calendar-tool, time-management
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Free Slot Finder
**Free Slot Finder** helps users find free time slots in their busy schedules by analyzing their Google Calendar events. It is especially useful for individuals managing tight schedules, allowing them to efficiently plan meetings, tasks, or personal activities.
---
## **Features**
- **Automated Slot Detection**: Scans Google Calendar for busy time slots and calculates the free periods.
- **Customizable Date Range**: Users can specify the start and end dates for the search.
- **Work Hour Support**: Can be customized to avoid non-working hours.
- **Ease of Use**: Fully automated process with minimal setup requirements.
---
## **How to Use**
### Prerequisites
1. **Google Calendar API Setup**:
- Go to [Google Cloud Console](https://console.cloud.google.com/).
- Create a new project.
- Enable the **Google Calendar API** for the project.
- Download the `credentials.json` file and place it in the project directory.
2. **Install Dependencies**:
Install the required Python libraries:
```bash
pip install --upgrade google-api-python-client oauth2client
```
### Running the Tool
1. Clone or download the `free_slot_finder.py` file to your local directory.
2. Ensure the `credentials.json` file is in the same directory.
3. Run the tool using Python 2.7:
```bash
python free_slot_finder.py
```
4. Input the desired date range in the format `YYYY-MM-DD`.
5. The tool will analyze your calendar and display the free time slots.
---
## **Tool Functions**
1. **Authenticate Google Calendar**:
- Uses OAuth 2.0 to securely connect to your Google Calendar account.
2. **Analyze Calendar Events**:
- Reads all events in the specified date range to identify busy periods.
3. **Calculate Free Slots**:
- Compares busy slots with the specified date range to determine available time.
4. **Output Results**:
- Displays both busy and free slots in a user-friendly format.
---
## **Sample Output**
```plaintext
##############################################
# FREE SLOT FINDER - PROFESSIONAL #
# Google Calendar Tool #
##############################################
Enter start date (YYYY-MM-DD): 2024-12-23
Enter end date (YYYY-MM-DD): 2024-12-25
[INFO] Searching for free slots...
[INFO] Busy Slots Found:
- 2024-12-23T10:00:00 to 2024-12-23T11:00:00
- 2024-12-24T14:00:00 to 2024-12-24T15:00:00
[INFO] Free Slots:
- 2024-12-23T11:00:00 to 2024-12-24T14:00:00
- 2024-12-24T15:00:00 to 2024-12-25T00:00:00
```
---