This repository contains a Python script that reads calendar events from a CSV file and generates an ICS file for importing into your favorite calendar application.

• Converts calendar events from CSV to ICS format
• Supports all-day events
• Logs the conversion process

• Docker & docker compose OR
• Anaconda/Conda/Miniconda OR
• Python 3.x with package python-dateutil

The app/source.csv file has the following columns:

• DTSTART: Start date and time of the event (for an all-day event, do not include a time)
• DTEND: End date and time of the event (leave blank for an all-day event)
• DESCRIPTION: Description of the event. If the description includes commas, the description field should be in quotations.
• SUMMARY: Summary or heading of the event

A spreadsheet application can be used to generate the app/sources.csv file.

1. Clone the repository:

   git clone https://github.com/devincorey/ical-generator.git
   cd ical-generator
   

2. Build and run the Docker container:

docker compose up --build

3. After the script completes, the generated calendar.ics file and log.txt file will be in the output folder.

1. Clone the repository:

   git clone https://github.com/devincorey/ical-generator.git
   cd ical-generator
   

2. Create a conda environment from the .yml file

   conda env create --file conda/environment.yml
   

3. Activate the conda environment:

   conda activate py310_icsgenerator
   

4. Run the Python script:

   cd app
   python script.py
   

5. After the script completes, the generated calendar.ics file and log.txt file will be in the output folder.

To delete the Docker image and container, run: docker-compose down docker rmi ics-generator-python

To remove the conda environment after running the project: conda remove --name py310_icsgenerator --all

• python-dateutil

Please feel free reach out with any comments, questions or issues. I've tested this on MacOS with Apple Calendar.