QuokkaOrg is an org-mode based calendar app.

It parses all org-mode files from a directory of your choice, extracts timestamps and presents them in a simple, mobile-optimized interface.

✨ Features

• Parses all org-mode files in your specified directory (with an optional ignore list)
• A list of all upcoming events in the next 3 weeks
• A full calendar to easily browse all your events
• Notifications the day before an event
• Special highlighting and filtering of events marked with SCHEDULED and DEADLINE
• Available for android

📸 Screenshots

🔍 View the org-mode source for these screenshots

The following org-mode file would produce the events shown in the screenshots. The first breadcrumb “index” is based on the file name containing the event, after removing the .org suffix.

* Uni
** Algorithms and Datastructures Test
DEADLINE: <2025-08-12 Wed 18:00>
** Algorithms and Datastructures Test
SCHEDULED: <2025-08-11 Wed 18:00>
** Analysis Test
<2025-08-12 Wed 16:00>
** Security Test
<2025-08-12 Wed 17:00>
** Theoretical Informatics Lecture
<2025-08-13 Wed 15:00-17:00>
* Private
** Cinema
<2025-08-15 Wed 15:00>
* Unrelated
<2025-08-14 Wed 19:00>

🛠️ Development

To install dependencies:

npm install
npm run grammar # will build the tree-sitter-org grammar from the submodule

To run the app on your mobile device, first run the following command. Afterwards you can install the app by pressing the run button in Android Studio.

npm run build && npx cap sync

For quicker development you can start a web-version of the app. It will run at http://localhost:5173

npm run dev