Calendar Plugin for KOReader

[omerfaruq]

This plugin shows your Google Calendar (or any calendar that offers a private iCal/ICS URL) on your e-reader, both as the sleep screen and in an interactive viewer you can open from the Tools menu or a gesture. No login or OAuth needed — it uses the calendar's "Secret address in iCal format", so it works fine on e-ink devices.

Features:

• Day / Week / Month / Agenda views, with today highlighted
• Calendar as sleep screen (pick the view mode you like)
• Works offline — events are cached on disk, so the last data is shown without a connection
• Recurring events supported (DAILY/WEEKLY/MONTHLY/YEARLY rules, exceptions, rescheduled instances)
• Tap a day or event for full details; swipe left/right to navigate; Today and Sync buttons
• Multiple calendars, can be toggled on/off from the menu
• Optional: briefly turn Wi-Fi on at sleep to refresh when the data is older than a threshold (off by default)
• Dates are localized in every KOReader language; UI strings currently in English, Turkish, German, French, Spanish, Italian and Portuguese

Install: copy the folder into koreader/plugins/calendar.koplugin/ and restart KOReader. Then follow the setup steps in the README (basically: paste your calendar's secret iCal URL into a small config file).

Limitations: read-only (no event editing), timezones are shown as wall-clock values, and only common recurrence rules are expanded.

Repo: https://github.com/omer-faruq/calendar.koplugin

Feedback and bug reports are very welcome!