Download
RU EN DE FR ES PT 中文

Calendar — User Guide | YoBench

How to use the Calendar module in YoBench: events, recurrences, 5 views, iCalendar import/subscriptions, reminders and the work calendar.

What the Calendar module does

A full-featured calendar inside YoBench: events, recurring schedules, iCalendar (.ics) import and subscriptions, reminders, and work calendars with public holidays. Integrates with the Task Tracker — tasks with deadlines are rendered on the timeline.

What you get:

  • Five views — Year, Month, Week, Day, Agenda.
  • Flexible recurrence — daily, weekdays, weekly (with a chosen subset of days), monthly, yearly, or a custom interval.
  • ICS import/export — open third-party calendars or export your own.
  • Subscriptions to external ICS URLs with auto-sync.
  • System reminders — at 0/5/15/30/60/120/1440 minutes before the event.
  • Russian work calendar — data from consultant.ru: working / weekend / holiday / shortened days.
  • Tracker tasks — rendered on the same timeline by due_date.

Event parameters

When creating or editing:

  • Title (required).
  • Description (optional).
  • Start / end date and time or the All-day flag.
  • Color — HEX (default #3b82f6).
  • Category — work / personal / meeting / birthday / no category.
  • Location/link — text or URL.
  • Status — confirmed / tentative / cancelled.
  • Busy — busy flag (for free/busy view).
  • Focus block — focus-time mark.
  • Reminders — list of minutes-before values: 0 (at event time), 5, 15, 30, 60, 120, 1440 (a day).
  • Recurrence — repetition rule (see below).

Recurring events

Not RRULE — a simple JSON format:

  • Type: daily, weekdays, weekly (pick days of the week), monthly, yearly, custom.
  • Interval/unit for custom — e.g. every two weeks (unit: weeks, interval: 2).
  • End: never / by date / after N occurrences.

Virtual occurrences are expanded on the fly when rendering a range.

iCalendar (.ics)

  • Import file — pick a .ics file; events are deduplicated by external_uid.
  • Export — dumps the current year's events to .ics (via ical-generator).
  • URL subscriptions — add a URL plus optional Basic auth. The calendar is polled automatically on an interval (default 60 minutes). Events removed at the source are also removed from YoBench.

Work calendars

Provider ru1 is wired up — the Russian work calendar via consultant.ru open data. Day types:

  • working
  • weekend
  • holiday
  • short (shortened working day)

Used to compute working hours and highlight non-working days in Year/Month views.

The architecture is extensible — providers for other countries can be added later.

Reminders

Form presets: 0, 5, 15, 30, 60, 120, 1440 minutes before the event. When time comes, an OS-level system notification is posted through YoBench's notification service. Telegram/email channels are not used for calendar reminders.

Controlled by the Calendar notifications flag (calendarNotificationsEnabled, on by default).

Tracker integration

The calendar timeline renders not only events but also tasks from the Tracker that have a due_date. Clicking a task navigates into its detail in Tracker.

Global module settings

Under Settings → Calendar:

  • Calendar notifications (calendarNotificationsEnabled) — turns reminders on or off.
  • ICS subscription sync interval (calendarIcalSyncIntervalMinutes) — default 60 minutes.
  • The last opened year and selected work-calendar provider are also stored.

Workflow

1. Create an event

  1. Open Calendar from the left sidebar.
  2. Click an empty day cell or hit + Event.
  3. Fill in title, time, description.
  4. Optionally set recurrence and reminders.
  5. Save.

2. Switch views

In the calendar header — Year / Month / Week / Day / Agenda toggle.

3. Drag and resize events

Drag an event card to a new date/time. Drag the bottom edge to resize.

4. Connect an external calendar

In the Subscriptions section, add the ICS URL and (if needed) credentials. Click Sync now or wait for auto-sync.

5. Import/export

  • ICS import — Import button, pick a file. Deduplication by UID prevents duplicates.
  • ICS export — Export button, saves the current year's events.

6. Enable the work calendar

In settings pick the ru1 provider — non-working days are highlighted, and Month/Year views show holidays.

Next steps

  • Wire up the Task Tracker — deadlines appear on the timeline automatically.
  • Use Email if you want to create events out of messages.

Help and feedback

Want a work calendar for another country or RRULE support? Contact us via the feedback form.