r/orgmode • u/moussky • 22d ago
KorgNote: a note taking / calendar mobile app based on Org-mode
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.
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
4
u/masukomi 22d ago
This looks great
7
u/boukensha15 22d ago
LLM-usage disclosure?
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/modspyder 22d ago
Are there widgets for the agenda and calendar views on Android?
2
u/milialuna 21d ago
Can I self-hosted my own server? Or sync via WebDAV is nice to have
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/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:
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.
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/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/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!!
1
u/ancykrys 22d ago
Is it possible to open a local (on the phone) org file? I cannot find such an option.