GECA Calendar v2.0

This is a Python dockerized webapp that handles a subscription calendar for Geneva Camerata events

Features

• Fetch and sync calendar data from Notion
• Subscribe to calendar (public and private URLs)
• Save calendars locally in ICS format
• Generate customized calendars based on project selection
• Track data changes to minimize API calls
• Force update calling /update endpoint
• Support for seating arrangements and project URLs
• Responsive web interface

What's new in v2.0

• Interactive web interface for calendar customization
  • Select between full or custom calendar
  • Visual project cards with dates and details
  • Real-time selection and filtering
  • Mobile-friendly design
• Enhanced calendar management
  • Custom calendar generation with selected projects
  • ICS format support for local saving
  • Real-time updates and sync
• Improved backend architecture
  • Fully rewritten with modern Python practices
  • SQLite database for persistent storage
  • Smart sync with modification tracking
  • Object-oriented architecture with DTOs
  • Modular design for maintainability
  • Robust error handling and validation
  • Docker containerization

Getting Started

Prerequisites

• Python 3.x
• Notion API token
• SQLite3
• (For local mode) Virtual environment (venv)
• .env file (see env_template)
• Docker (optional for containerized deployment)

Create Notion integration token

• Settings and members
• Connections (left menu, second last) => Develop or manage integration (second last option, below the connection list)
  • Type: Internal
  • Associated workspace: the season workspace
  • Name: Whatever you like! Let's say <yourname_integration>
  • Click Submit
• In the integration page click on Capabilities and uncheck the Update and Insert => Save changes
• Secret => Show => Copy Share a page with the integration
• Open the page (Calendar in our case)
• Click on the '...' on the top right corner
• Click on Add connection
• In that list the Integration you created previously should show up: if it doesn't you might have connected the integration to the workspace and should repeat the first steps
• Select the integration and click Confirm Retrieve the calendar id
• The page address looks something like this: https://word-generated-code.notion.site/PAGE_TITLE-alphanumeric_code
• Open the calendar and the address will look something like this: https://word-generated-code.notion.site/**alphanumeric-id**?v=alphanumeric-code
• The alphanumeric-id is the calendar id

Installation

1. Clone the repository:

   git clone https://github.com/timotif/geca-calendar.git
   cd geca-calendar

Usage

Webapp Mode

make build
make run

The app will be available at http://localhost:8001 (can be changed in the Makefile PORT variable)

Hosting

• You can host the app on a server and expose the port 8001

Custom calendar mode

• Go to the /projects page of the web app
• You'll see a list of all the projects
• Select the projects you want to include in the calendar
• Click on the Submit button
• An address will be created for your specific calendar
• Subscribe to that address (see below)

Subscribing to a Calendar

• iCal

  1. Click on New Calendar -> Add subscribed calendar
  2. Paste the calendar link and click Subscribe

• Google and Android For detailed instructions on adding a calendar to Google Calendar, refer to this guide.

Stop the app

make stop

Clean up

make fclean

Local Calendar Save Mode

1. Create a virtual environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install --upgrade pip
   pip install -r app/requirements.txt

2. Run the update script:

   ./update_calendar.sh

The calendar file in ICS format will be saved in the calendars subfolder.

Help

Check the Makefile for more commands:

make help

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License - see the LICENSE file for details.

Contact

For any questions or support, please contact timotif@gmail.com.

---

Note: This project is intended for non-commercial use only. Please refer to the license for more details.