README

Italy 2026 Calendar

Auto-publishes the trip itinerary to Apple Calendar via a subscribed .ics URL.

Subscription URLs

Gist ID: b9921ca8dc846a76ca131507cd88e922 (jacobwallstrom, secret gist)

The URL omits the commit SHA, so it always serves the latest version.

How to subscribe (one-time)

macOS Calendar

  1. File → New Calendar Subscription
  2. Paste the HTTPS URL above
  3. Click Subscribe
  4. Choose iCloud as the location (so it syncs to other devices)
  5. Auto-refresh: every 5 min / hourly / daily — recommend Every hour
  6. Untick alerts/attachments if you don't want them

iOS/iPadOS

  1. Tap the webcal:// URL on this device → Calendar opens → tap Subscribe
  2. Or: Settings → Calendar → Accounts → Add Account → Other → Add Subscribed Calendar → paste URL

iCloud sync

After subscribing on the Mac with location = iCloud, the subscription propagates to all signed-in devices automatically.

How to update the calendar

  1. Edit calendar/itinerary.py (events list)

  2. Regenerate the file:

    python3 calendar/make-ics.py
  3. Push to gist:

    gh gist edit b9921ca8dc846a76ca131507cd88e922 calendar/italy-2026.ics
  4. Subscribed calendars refresh at their poll interval (default 1h; force-refresh in macOS Calendar via right-click → Refresh).

Stable UIDs on each event mean updates replace existing events rather than duplicating them.

Privacy

Secret gist: not indexed by search engines but anyone with the URL can read. The file contains train numbers, station names, seat numbers, and brief notes. No passport/booking-reference data. If extra paranoia required, regenerate the gist ID periodically.