ical-filter
HTTP daemon that can parse any ical feed and represent it in a normalized fashion. Allows filtering based on iCalendar event summaries. Ideal if you have a iCalendar feed that you want tailor made to include in your favorite calendar application. I use it to create a personalized duty-call calendar, since I do not have access to the software that serves the original feed.
Note: currently any other alarms, todos, journals and freebusies are not propagated. If you need this please file an issue.
Note: all datetimes are normalized to UTC.
Setup
Build the binary and run with the following optional ENV variables:
RUST_LOG=info \
ICAL_FILTER_SOCKETADDR=127.0.0.1:8080 \
cargo run
Endpoints
All endpoints accept the following query parameters:
url
: source url for an ical feed.filter
(optional): whitelist filter for summary field of events. Can only set one (for now).
JSON
Retrieve the url
and render as JSON with Content-Type: application/json
.
http://localhost:8080/v1/json
Will retrieve similar to:
iCal
Retrieve the url
and render as an iCalender v2.0 file with Content-Type: text/calendar
.
http://localhost:8080/v1/ical
Will retrieve similar to:
BEGIN:VCALENDAR
VERSION:2.0
PRODID:ical-filter
CALSCALE:GREGORIAN
METHOD:PUBLISH
BEGIN:VTIMEZONE
TZID:UTC
BEGIN:STANDARD
DTSTART:19700329T020000
TZOFFSETFROM:+0000
TZOFFSETTO:+0000
END:STANDARD
END:VTIMEZONE
BEGIN:VEVENT
UID:TU586226199
DTSTAMP:20200703T085514Z
SUMMARY:Duty call
DTSTART:20200125T080000Z
DTEND:20200125T080000Z
CREATED:20200120T161734Z
END:VEVENT
BEGIN:VEVENT
UID:TU597147530
DTSTAMP:20200703T085514Z
SUMMARY:Duty call
DTSTART:20200202T080000Z
DTEND:20200202T080000Z
CREATED:20200128T074528Z
END:VEVENT
END:VCALENDAR