mqtt2caldav

This project reads MQTT events and creates predefined CALDAV events.

Licence

mqtt2caldav is licensed under the GNU GENERAL PUBLIC LICENSE Version 3.

Requirements

• MQTT Server Connection
• CALDAV Server Connection
• paho-mqtt
• caldav

Configuration

The configuration file is located under config/config.json and holds some sample data.

MQTT :: Connection
Specifies the MQTT server connection.

"MQTT_SERVER_ADDRESS": "localhost",
"MQTT_SERVER_PORT": "1883",
"MQTT_USERNAME": "username",
"MQTT_PASSWORD": "password"

CALDAV :: Connection
Specifies the CALDAV server connection.

"CALDAV_SERVER_ADDRESS": "https://server.com/remote.php/dav/calendars/user",
"CALDAV_USERNAME": "username",
"CALDAV_PASSWORD": "password"

MQTT :: Trigger
Specifies the MQTT topic and MQTT event string to trigger a calendar event creation.

"MQTT_TOPIC": "mqtt/Main_Switch",
"MQTT_EVENT": {"action":"on"},

EVENT :: Calendar
Specifies the calendar name in which a calendar event is created.

"EVENT_CALENDAR"

• "localhost/dav/calendar/work"
• "http://server.com/remote.php/dav/calendars/user/home"
• ...

EVENT :: Summary
Specifies the event title.

"EVENT_SUMMARY"

• "Meeting"
• "Buy More Milk"
• "Procrastination"
• ...

EVENT :: Location
Specifies the event location. Use a double backslash to escape a comma.

"EVENT_LOCATION"

• "Home"
• "Annwn Regio"
• "1 Street\\, 23456 City\\, Country"
• ...

EVENT :: Geo
Specifies the event location in latitude and longitude coordinates.

"EVENT_GEO"

• "41.726931;-49.948253"
• "1.2489458;103.8343056"
• "-73.0499998;-13.416665"
• ...

EVENT :: Categories
Specifies the category/categories for a calendar event. This field is commonly used for 'Tags' in various calendar apps.

"EVENT_CATEGORIES"

• "Visit"
• "Meeting"
• "Beachy Beach\\, Sandy Sand\\, Sunny Sun"
• ...

EVENT :: URL
Specifies a link associated with a calendar event.

"EVENT_URL"

• "http://something.com"
• "http://buymoremilk.com"
• "http://eatmorechicken.com"
• ...

EVENT :: Description
Specifies the description for a calendar event.

"EVENT_DESCRIPTION"

• "Meeting with Homer"
• "Take over the world!"
• "Dont forget to buy fresh milk!"
• ...

EVENT :: Transparency
Specifies if a calendar event is listed as busy or free.

"EVENT_TRANSP"

• "OPAQUE" → Busy
• "TRANSPARENT" → Free

EVENT :: Time Zone
Specifies the timezone the calendar event is created. List of timezones→ https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

"EVENT_TIMEZONE"

• "Etc/GMT+12"
• "Europe/London"
• "Asia/Singapore"
• ...

EVENT :: Trigger
Specifies a calendar event alarm.

"EVENT_TRIGGER"

• "" → No alert will be set or configured
• "0" → Alert will trigger at event start time
• "15" → Alert will trigger 15 minutes before event start time
• ...

EVENT :: Seconds
Specifies if a calendar event start time and end time will have seconds set.

"EVENT_SECONDS"

• "True" → 12:34:56
• "False" → 12:34:00

EVENT :: Rounding
Specifies if a calendar event start time has minutes rounded up or down to the closest defined value.

"EVENT_ROUNDING"

• "1" → 12:42:29 rounds down to 12:42:00 and 12:42:30 rounds up to 12:43:00
• "5" → 12:42:29 rounds down to 12:40:00 and 12:42:30 rounds up to 12:45:00
• "30" → 12:42:29 rounds down to 12:30:00 and 12:42:30 rounds up to 13:00:00
• ...

EVENT :: Duration
Specifies a calendar event duration in minutes.

"EVENT_DURATION"

• "1" → If event start time is 12:34:00, event end time will be set to 12:35:00 (+1 minute)
• "10" → If event start time is 12:34:00, event end time will be set to 12:44:00 (+10 minutes)
• "120" → If event start time is 12:34:00, event end time will be set to 14:34:00 (+120 minutes)
• ...

Log File

The log file is located under logs/mqtt2caldav.log.