This describes the usage of the app. On how to create a calendar, see the online documentation (readme) on Github.

Adding a calendar

Warning: Only use calendars from people you trust - opening links to malicious sites represents a security risk!

Click the "+" button and then "Choose..." to select a calendar file or enter the full path directly (e.g. /sdcard/Downloads/MyCalendar.txt). Alternatively, select the calendar file in a file manager and choose LinCal to open it. Optionally enter a custom title for the calendar to be shown in the list of calendars and as the title of notifications. Checking "Don't show any entries now" makes sure you don't see any entries directly after adding the calendar (but this can be changed later). Finally click "Add calendar".

Note: LinCal does not create a copy when adding a calendar but always uses the file at the location chosen. This allows calendars to be updated by simply replacing the calendar file with a new version. By synchronizing it with the cloud, automatic updates can be achieved. LinCal will use the newer version as soon it has been restarted. If you want to move a calendar file, you have to remove the calendar from LinCal first and readd it after moving the file.

Calendars can be added from a cloud storage provider that supports the Android Storage Access Framework (SAF). When clicking "Choose...", you can for example add calendars from Google Drive or Nextcloud. This way the calendar will be automatically updated from the cloud as soon as the cloud service synchronizes (and LinCal restarts). Note, however, that if you are offline and the cloud storage cache is cleared, LinCal won't get access to the calendar file and show an error.

Viewing a calendar

Select a calendar from the list to view the calendar's information, settings and a list of its entries.

Notifications

A notification is shown exactly once for each entry in each calendar. Unless otherwise specified, it is shown exactly at the time as defined by the calendar. When adding a calendar or enabling notifications, also the notifications for past entries are shown.

Calendar settings

Problems