Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pschmitt/gcal-import-ics
CLI application to import ICS files to Google Calendar
https://github.com/pschmitt/gcal-import-ics
calendar docker google-calendar google-calendar-api ics python
Last synced: 3 months ago
JSON representation
CLI application to import ICS files to Google Calendar
- Host: GitHub
- URL: https://github.com/pschmitt/gcal-import-ics
- Owner: pschmitt
- License: gpl-3.0
- Created: 2021-03-05T14:28:34.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-09-18T08:38:12.000Z (over 1 year ago)
- Last Synced: 2024-05-17T00:11:12.869Z (8 months ago)
- Topics: calendar, docker, google-calendar, google-calendar-api, ics, python
- Language: Python
- Homepage: https://hub.docker.com/r/pschmitt/gcal-import-ics
- Size: 96.7 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📅 Import ICS files to your Google Calendar, without the web interface.
[](https://github.com/pschmitt/gcal-import-ics/actions/workflows/build.yaml)
# TL;DR
```shell
docker run -it --rm \
-e "TZ=Europe/Berlin" \
-v "$PWD/config:/config" \
pschmitt/gcal-import-ics:latest \
"My Personal Calendar" \
/data/calendar.ics
```
and the main star of the show is [🌟 gcal_import.py](./gcal_import.py)
# Installation
```shell
git clone https://github.com/pschmitt/gcal-import-ics
cd gcal-import-ics
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```
# Setup
You will need the following:
- Your calendar ID (or its name)
- a JSON credentials file. See [here](https://google-calendar-simple-api.readthedocs.io/en/latest/getting_started.html#credentials) for instructions.
# Usage
```shell
python3 gcal_import.py \
--debug \
-c ./credentials/client_secret_blablablabla.apps.googleusercontent.com.json \
-t ./credentials/gcal.token \
-p "PROXY=socks5h://corp.acme.com:8080" \
"$GOOGLE_CALENDAR_NAME_OR_ID" \
"$ICS_FILE_PATH_OR_URL"
```
# Confluence calendar sync
```shell
python3 gcal_import.py \
--debug \
-c ./credentials/client_secret_blablablabla.apps.googleusercontent.com.json \
-t ./credentials/gcal.token \
-p "PROXY=socks5h://corp.acme.com:8080" \
--confluence-url https://confluence.acme.com \
--confluence-username admin \
--confluence-password somePAssword01 \
--confluence-calendars "Team Calendar" \
--confluence-calendars "Company events" \
--confluence-calendar-prefix "Work: "
```
# But why?
1. https://groups.google.com/g/google-apps-manager/c/tgIAB35I5EE?pli=1
2. Google Calendar seems to be unable to fetch ics files behind basic auth
# TODO
- [ ] 🚧 Fix status for some imported events (they are created with status=cancelled)
- [x] Requests proxy option
- [x] Delete unknown events
- [x] With an optional date parameter (ie only delete future events)
- [x] All-day events
- [ ] Attendees
- [ ] Reminders
- [ ] Store metadata ("imported by gcal_import.py") somewhere (in source? organizer? description?)
- [x] Clear calendar before import (optional)
- [ ] Wait and retry when rate-limitted
- [x] Optionally ignore SEQUENCE and always update
- [x] Allow passing in the calendar name, instead of the ID
- [x] Support recurring event *instances*
- [x] Allow settings args with environment variables
- [x] Confluence calendar sync