QUICK-ICS(1)

NAME

quick-ics - generate calendar invites via URL

SYNOPSIS

/add.ics?title=EVENT&start=DATETIME[&OPTIONS...]

DESCRIPTION

Generate downloadable .ics calendar files on the fly. Build a URL, share it, and recipients can add events to their calendar with one click.

Timezone is automatically detected from your location. Override with the tz parameter.

PARAMETERS

REQUIRED
  title       Event title/summary
  start       Start datetime (ISO 8601: YYYY-MM-DDTHH:mm)

OPTIONAL
  end         End datetime (ISO 8601: YYYY-MM-DDTHH:mm)
  duration    Duration instead of end time (e.g., "1h", "30m", "1h30m")
  location    Event venue or address
  description Event description or notes
  url         Related URL (e.g., video call link)
  tz          Timezone override (IANA format, e.g., "Europe/London")
  allday      Set to "true" for all-day events (use YYYY-MM-DD for dates)
  organizer   Organizer email or "Name <email>"
  attendee    Participant email(s) - comma-separated or repeat param

EXAMPLES

Simple 1-hour meeting:

/add.ics?title=Team+Standup&start=2024-03-15T09:00&duration=30m

Meeting with location and description:

/add.ics?title=Project+Review&start=2024-03-15T14:00&end=2024-03-15T15:30
  &location=Conference+Room+A&description=Q1+review+meeting

All-day event:

/add.ics?title=Company+Holiday&start=2024-12-25&allday=true

With timezone override:

/add.ics?title=NYC+Meeting&start=2024-03-15T10:00&duration=1h
  &tz=America/New_York

Video call with link:

/add.ics?title=Weekly+Sync&start=2024-03-15T16:00&duration=1h
  &url=https://meet.google.com/abc-defg-hij

With organizer and attendees:

/add.ics?title=Planning&start=2024-03-15T10:00&duration=1h
  &organizer=Alice <alice@example.com>
  &attendee=bob@example.com,carol@example.com

TIMEZONE

By default, timestamps are interpreted in the timezone detected from your IP address (via Cloudflare). Use the tz parameter to override:

Common timezones:
  America/New_York      Eastern Time
  America/Chicago       Central Time
  America/Denver        Mountain Time
  America/Los_Angeles   Pacific Time
  Europe/London         GMT/BST
  Europe/Paris          CET/CEST
  Asia/Tokyo            JST
  Australia/Sydney      AEST/AEDT

SEE ALSO

RFC 5545 (iCalendar), ISO 8601 (date/time formats)

AUTHOR

Built by Jökull Sólberg

github.com/jokull/quick-ics