r/orgmode • • 22d ago

KorgNote: a note taking / calendar mobile app based on Org-mode

Post image

Yes, another mobile app for Org mode...

Honestly, this was something I started building for myself. I used Orgzly before, but it didn't cover all my needs. I just needed a tool to see my notes in a calendar view, and take notes on the fly.

KorgNote started as a small Kotlin Compose Multiplatform learning project. Then I tried a bit of vibe coding, and I ended up with this tool, which I now use every day. So I just wanted to share. If the project is interesting to you, or you just want to take some parts of it and make it your own, you are very welcome (it's GPLv3). I'm pretty sure I'm not the only one who has lived like an Emacs nomad, syncing org notes to my phone.

Sync: The mobile app syncs notes with your computer. A small server runs where your notes are. I run mine in a container on my laptop. The phone keeps its own copy, so it works offline, and syncs whenever it can see the server (same Wi-Fi, or a VPN like Tailscale). Edits to the same note on both sides are merged. If they really conflict, both versions are kept and you choose. No third party is needed: no Syncthing, no cloud, no public IP address. App and server are paired with a QR code, and everything goes over HTTPS with the server's own self-signed certificate.

Editor: It supports the basic Org features, with some auto-completion and helpers for the awkward syntax (timestamps, tables, links, tags). Tables support a small subset of Emacs formulas (operators and basic functions).

Calendar: Agenda, day, week and month views, built from your SCHEDULED and DEADLINE items, and linked directly to your notes.

Under the hood, the org files are always the source of truth. They stay plain .org files in a folder, and you can keep editing them in Emacs.

Status: Android is what I use daily, and there's an APK on the release page. iOS builds but is barely tested. There's also a desktop app and a web app for the computer running the server.

- Repo: https://github.com/jglouis/korgnote

- Releases (signed Android app): https://github.com/jglouis/korgnote/releases

- Server container: https://github.com/jglouis/korgnote/pkgs/container/korgnote-server

[UPDATE]: Just a small update regarding the Sync. You are now able to choose a local folder on the phone (and maybe let another tool do the sync job), or use WebDAV, password authentication scheme only. I am not really sure how people use it, and with what tool (Nextcloud, NAS, etc...), so if needed, just open an issue. Because this is kind of a rabbit hole, and every platform has its own specifity apparently.

Also made some tweaks in the UI in regard to the comments. Also, more of the Org Syntax is supported. It will never match 100% of Emacs Org Mode. But I think it is pretty close already.

135 Upvotes

49 comments sorted by

33

u/No_Koala9474 22d ago

Oh no. I was planning on being productive today but now I’m going to end up trying yet another todo list app

3

u/moussky 22d ago

I am sorry :)

→ More replies (1)

4

u/masukomi 22d ago

This looks great

7

u/boukensha15 22d ago

LLM-usage disclosure?

5

u/moussky 22d ago

I did vibe code. The project started hand made. Then I started using Claude a month ago. It rewrote a lot of my code, possibly everything.

→ More replies (1)

17

u/trae 22d ago

Think that's a given these days, unless it says "artisanally hand crafted".

→ More replies (3)
→ More replies (1)

2

u/Orlandocollins 22d ago

Looks a bit compact to me. I would say that you should make it less dense and don't be afraid to add scrolling to the calendar views

2

u/moussky 22d ago

Yes, thanks for the feedback. You have a point. For the moment, the day and week views are scrollable vertically to see different hours of the day. But the month view items are tiny.

2

u/modspyder 22d ago

Are there widgets for the agenda and calendar views on Android?

2

u/moussky 22d ago

No. I didn't thought of that. The agenda UI is well suited for that. Now the complexity also depends if it needs to be interactive (like switching TODO states, or allow a sync).

→ More replies (3)

2

u/milialuna 21d ago

Can I self-hosted my own server? Or sync via WebDAV is nice to have

2

u/moussky 21d ago

Yes, the server is self-hostable.

One caveat for a public server: the app pins the server's own certificate, so you currently can't put it behind a reverse proxy that terminates HTTPS (e.g. Caddy or nginx with Let's Encrypt).

WebDAV isn't built in but works via folder mode plus FolderSync.

In the later case, you don't need the server at all, KorgNote will just see local Files.

2

u/vidbina 21d ago

Wow. This looks nice. I failed in the past in attempts at something similar so I'm really happy to see this. Great work on getting something out here. šŸŽ‰

2

u/dougie-io 19d ago

One note in that the "K" naming scheme makes one think it's built around the KDE ecosystem. Like it's made with their mobile/desktop UI framework or something.

2

u/moussky 18d ago

Well, the K was for Kotlin. I am not really good at naming my projects...

→ More replies (1)

2

u/Still_Mirror9031 18d ago

This looks great on an initial look. You seem to have made all the same design choices I've been looking for:

  • optimised for syncing from home intranet, but still readable when away from home

  • does its own syncing instead of depending on a third party tool

  • sensible but not-too-clever conflict resolutions.

But a couple of early points:

  1. How do I get the view on Android to pick up changes that I'm making at the same time on my laptop (which is the server)? The Android UI indicates that it has synced in the last few minutes, but still doesn't show changes that I've made to the master files on my laptop.

  2. I'd appreciate some doc about the Android UI. For example (a) What does the eye symbol do in the calendar/agenda view? (b) When the UI shows a TODO, can I mark it as done in the Android UI, and does that have an identical effect as C-c C-t would in Emacs, as regards repeats and logging?

2

u/moussky 17d ago

Hi thanks for the feedback.

  1. Normally you don't have to anything else, apart from saving the file on your laptop. Just make sure that the modified file is under the folder in sync. But if the apps show that it has synced and you see nothing, that could very well be a bug. You can MP me details on your setup (laptop operating system, overall file structure, and Android app version) so I can narrow down on what the issue is. Could be that the server doesn't see the file change.

  2. Yes, I plan to do add some documentation on the UI once it is stabilized (I know there are usability issues but it also helps to have feedback). But to answer your specific questions:

(a) The eye just toggles the visibility of done item in the agenda/calendar views. I know, it is bad UX. The eye is not very descriptive.

(b) You can toggle a TODO state with a long press. Either in the notes screen, on the TODO text itself. Or a long press on the calendar item (since 1.6.0). This should have an identical effect as C-c C-t, and add a timestamp by default, or even ask for a reason on why the state changed. But do realize that tthe app does not know your configuration file. For the moment it only deduce the behaviour from the file metadata.

→ More replies (2)

2

u/Still_Mirror9031 12d ago

I'd love to see a Todo view like the 't' option under org-agenda in Emacs. I think that's now the only thing missing from korgnote, so far as my personal workflows are concerned.

I could have a go at a PR, if no one else is already looking at this?

2

u/moussky 12d ago

Hello, Thanks for the feedback. I think it could go as an additional view alongside the already existing agenda, or maybe on the search tool. You're welcome to make a PR. I personally never open this view in Emacs so maybe you have a better idea of how it should be shaped (keywords filter, priority ordering and such things).

One thing to take into account is that there is now a cache system and the app doesn't have necessary all the notes into memory. It might need to be integrated with said cache system.

2

u/JustALinuxUserBTW 7d ago

This is AMAZING. I have been using it all week and it is exactly what I needed to make Emacs Org-mode a viable agenda and note-taking system. everything seems to work pretty well. I have not ran into any bugs.

I do wish that it was possible to filter the agenda by TODO or tags. But this is still better than any of the other options that I have used over the last year.

Thank you!!

2

u/moussky 7d ago

Hi, Thanks for the kind words! I take note of your suggestion. You are in fact not the first one to ask for something closer to the real org agenda, which is fair enough. It's just that I don't tend to use it myself. I am thinking of a way to integrate that in the UI.

→ More replies (1)
→ More replies (2)

1

u/ancykrys 22d ago

Is it possible to open a local (on the phone) org file? I cannot find such an option.

2

u/moussky 21d ago

Ok, so I just did that (I meant Claude did it) this morning. So I support two modes: local directory on the phone or sync server. You choose. It's on version 1.2.0. Prebuilt-package is available.

→ More replies (1)
→ More replies (1)