Skip to content

Releases

KorgNote 1.8.0

Choose a tag to compare

@jglouis jglouis released this 14 Nov 07:46

The calendar can be narrowed to the TODO keywords and tags you choose, and the agenda has a list of everything still to do, dated or not, as org-agenda's t gives. Both were asked for by people using the app. The server is the same as 1.7.0's; updating it brings these to the web client too.

Before you update

  • The first start reads your notes once, as it did after 1.6.5, since the app now keeps each note's open TODOs with its summary. Nothing is lost or changed. With a few megabytes of notes it takes a few seconds, and you can read and search your notes meanwhile.

Filter

  • Tap a keyword or a tag in the agenda to see only what has it. A second tap takes it away. A chip under the header says what the calendar is narrowed to, and its × removes it.
  • The filter applies to every view: Day, Week, Month, the agenda and the TODO list. Clocked time is left whole, being what was done. Widgets and reminders ignore the filter.
  • A filter icon in the calendar's header opens the whole choice: Show done, then every keyword and every tag in your notes. Among keywords, or among tags, one is enough; between the two, both are needed: TODO or NEXT, and work. Clear puts everything back.
  • The icon carries a dot whenever something is left out or done entries show, so a calendar that looks empty says why. It replaces the ⋮ menu, which held only Show done.
  • The filter lasts until the app is closed.

TODO list

  • Every heading still to do, with or without a date. A task with no date is on no day, so the calendar could not show it. The agenda now starts with a TODOs · 8 row, which opens them on a page of their own.
  • Grouped by keyword, in the order your notes declare them, each group most important first, then soonest due. A row says when it is due, in red once the date has passed.
  • A tap opens the heading, and a hold offers the clock and the keywords, as in the agenda. A tap on a group's keyword or on a tag filters.
  • Search takes todo:open, for headings whose keyword is any still to do, with words or other terms: todo:open tag:work.

Calendar

  • The agenda opens on today. It is the days from today on, so its tab and a start of the app now show today however far it was paged. Going back from a note opened from the agenda is the exception, and finds it where you left it. Week, Month and Day keep their place for the day, as before.
  • Fixed: the calendar could open on yesterday's week or month, when the app had stayed open overnight. It now opens on today.
  • The calendar's floating button shows a calendar with a plus, as it adds an event. The plain plus is the File tab's, which adds a heading.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.8.0

KorgNote 1.7.0

Choose a tag to compare

@jglouis jglouis released this 10 Nov 20:29

A tour to learn KorgNote by tapping: a note, Welcome to KorgNote, whose headings each show one of the app's gestures. It is offered at the end of the first start, and Settings → Tour opens it at any time, so if you are updating you can take it from there. The server is the same as 1.6.5's; updating it brings the tour to the web client too.

Tour

  • A note to learn by tapping. Most of what KorgNote does is a tap or a hold with no label to say so. The tour is an ordinary note, and each heading asks you to do one thing and says what it does: tap TODO to mark it done, tap a heading to edit it, hold one for its menu, tick checkboxes and watch the count in the heading follow, tap a date to find the heading in the calendar, open a table and recalculate its total, fold a heading, follow a link and come back. It ends with a few words on the drawer, search, the calendar, sharing to KorgNote and Settings.
  • Offered, never written unasked. The welcome screens end with Add the tour note or Skip, since the note goes in with your own notes. Delete it when you are done.
  • Settings → Tour opens it again. If the note is already there, half ticked through or added by another device, it is opened as it is rather than written over.
  • In English and in French, as the app is.
  • The date in it is today's, with no time, so it shows in the calendar but no reminder goes off.

Settings

  • The last sync reads on its own line. Last synced 5 min ago used to follow the error in one sentence, as in Cannot reach the server… Last synced 5 min ago. The time now stands alone, and why the last try failed is under it, smaller, since being offline is expected and the app works without the server.

Fixes

  • A table cell's suggestions include the note's headings, for a link, even when the cell is opened right after the note. They could be missing for as long as the cell's dialog was open.

Documentation

  • What KorgNote supports of Org mode, feature by feature, is now written down in docs/org-features.md, linked from the README: for each part of the Org manual, what works, what works partly, what is only shown as written, and what is missing.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.7.0

KorgNote 1.6.5

Choose a tag to compare

@jglouis jglouis released this 05 Nov 11:25

KorgNote no longer crashes on a large library, and the calendar is ready the moment the app opens, whatever the size of your notes. The app used to keep every note in memory, and now it keeps only a short summary of each and reads the notes as they are needed.

Before you update

  • The first start reads your notes once. Nothing is lost or changed. With a few megabytes of notes it takes a few seconds. With a few hundred megabytes it takes minutes, during which you can read and search your notes, and the calendar fills up as it goes. It can be interrupted, and carries on where it stopped. Your reminders and widgets stay as they are until it is done.
  • If you use the KorgNote server, update it too. It has two fixes of its own, below.

Large libraries

  • Fixed: the app ran out of memory on a large library, on every start, so that the notes could not be opened at all (#2). A made-up library of 240 MB and about 2,400 notes, which 1.6.4 crashes on, now works on a slow phone with the usual memory limit, from a folder, a server or WebDAV.
  • Fixed: a single very large note could get the app killed, with no error, for using gigabytes of memory while going through it. A 15 MB note now opens in a few seconds.
  • Search brings results in as it finds them, when your notes do not all fit in memory: first from the notes in memory, then from the rest, with a bar while it reads. Typing something else stops it. On a slow phone it went through 240 MB in about 16 seconds. If your notes fit, search works as it always has.
  • A note too big for your device says so. That is about 16 MB on a phone that gives an app 256 MB. It stays in the drawer and can be found by its name, but it does not open and search does not look inside it.
  • With very many notes, the app says when it can't keep track of them all. Those notes still open and can be searched, but their dates and links are left out.
  • The pickers offer a note's first thousand headings, when linking to a heading or refiling under one.

Faster, even with few notes

  • The calendar is ready as soon as the app opens. With 5 MB of notes on a slow phone, it was ready after 1.5 seconds rather than 9.
  • The note you were reading is back sooner, after 1.7 seconds rather than 9 on the same phone, in a folder. With a server or WebDAV it still waits for the check for changes.
  • The app uses less memory: 21 MB rather than 35 MB for those notes.
  • A day with nothing on it says so only when that is known. While your notes are still being read for the first time, it says Still reading your notes….

Keeping your notes safe

  • Fixed: another app's change could be overwritten. In a folder, if a note changed elsewhere and the conflict copy could not be written, or the changed file could not be read, trying again could save over that change. Both versions are now kept.
  • A note that cannot be read says so. It used to go on showing the note before it under the new name. Nothing can be edited there, or saved over it.
  • An edit from the calendar never lands on the wrong heading. If the note changed elsewhere and isn't in memory, the change is refused with a message, nothing is lost, and it works when you try again. If your notes fit, what came in is merged as before.
  • A folder out of reach at the start, such as a card taken out, no longer empties the calendar or cancels your reminders.

KorgNote server

  • Fixed: a rename on the server could make phones delete notes. A folder renamed while a phone was syncing, beside a folder of about a thousand files or more, could leave its notes out of what the server listed, and a phone takes a note left out as deleted. The server now looks again until nothing is missing.
  • Fixed: a note that went at the wrong moment had the same effect. A file disappearing while the server was checking it could leave that note out in the same way. That listing now fails, and the phone tries again.

On an iPhone

The iOS app is not part of this release. If you build it from source, all of the above applies, with the calendar ready in about a second on a simulator with 240 MB of notes. It has not been tried on a real iPhone with so many notes.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.6.5

KorgNote 1.6.4

Choose a tag to compare

@jglouis jglouis released this 04 Nov 19:12

Mostly work under the hood: a long look through the code that fixed many bugs in sync and in how notes are read. Please read the first section before you update.

Before you update

  • KorgNote now needs Android 8 or later. On Android 7 the app has stopped as soon as you chose where your notes are, since at least 1.2.0, so nobody could be using it there.
  • Notes in dot-folders no longer reach your phones. Update the server, and anything in a folder such as .git or .stversions, or behind a link leading out of your notes folder, goes from your phones at the next full sync. The files on the server are not touched. If you edited one on a phone and that edit was never sent, it stays on the phone, but the sync of it fails each time, without saying so.
  • The server no longer ships sample notes. Started with no notes folder, it serves an empty library and says so.

Sync

  • Fixed: the agenda crashed on anything repeating by the hour, such as +4h. Each time it falls on a day now also gets its own reminder.
  • Two devices saving the same note at once: only one wins, and the other merges, where both could be accepted and one edit lost.
  • A conflict copy reaches the server in the sync that made it, so settling a conflict on this device never deletes the only copy.
  • Saving next to a heading that just arrived now works, rather than being refused.
  • Edits made while a sync is running stay yours: an edit saved during a pull, or while the notes reload, is kept. A save after a delete no longer deletes the note on the server, and a note deleted during its first push stays deleted.
  • A change made elsewhere shows up sooner: the app reads only the notes named in the change, in about half a second.
  • A device that stops reading can't hold up the server. It catches up with a full sync once it is back.
  • Another device's save no longer fails your sync with a server error at the moment it writes.

Notes

  • What is open stays on its heading. An open drawer, menu or dialog no longer lands on the neighbouring heading when a sync adds one above it.
  • A sync closes a dialog rather than act on the wrong thing. A reschedule picker or delete confirmation closes when a sync moves what it was about. Nothing is changed, but nothing says why yet either.
  • Delete says what really happens. Only the KorgNote server keeps a copy of a deleted note. With a folder or WebDAV, the dialog now says that no copy is kept.
  • Org files read more like Emacs reads them: a heading needs a space after its stars everywhere, an indented keyword counts as one, and an indented * list item stays a list item.
  • The link editor: example.com:8080 now gets https://, rather than being taken for a link to a note.

Faster

  • Typing redraws only the element you are editing.
  • Large libraries sync and open with much less work, and building links and the agenda has moved off the main thread.

On an iPhone

The iOS app is not part of this release, but if you build it from source:

  • Notes with an accent in their name or folder no longer vanish, and a new note with an accented title no longer opens empty.
  • On a server on Linux, 1.6.3 could store each such note twice, under two spellings of its name. Those second copies stay until you delete them, and the phone lists both until then. A server over a Mac folder was not affected.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.6.4

KorgNote 1.6.3

Choose a tag to compare

@jglouis jglouis released this 03 Nov 18:18

The calendar can now move what is in it: hold an entry to reschedule it or change its deadline. Also: tap the period at the top to go straight to any date, and folds open and close the same way everywhere. Only the app changes; the server is the same as 1.6.2's.

Calendar

  • Reschedule from the calendar. Holding an entry offers Reschedule…, Change deadline… or Change date…, depending on what the date is, and opens the same date and time picker as the editor. A repeater or a warning period stays as written, and an event over several days keeps its length. If the note changed since the calendar showed it, its date is left alone and the app says so.
  • Go to any date. A tap on the period at the top of the calendar opens a date picker, with a year list, so a day months or years away is one pick rather than many swipes. The calendar stays in the same view.
  • Showing done entries is a switch in the new ⋮ menu at the end of the calendar's header, where the eye icon used to be. The eye didn't say what it hid, or whether it was hiding it.
  • "Capture an event" is now the calendar's + button, rather than a button in the drawer of notes.

Notes

  • Folds open and close the same way everywhere. A chevron points right while closed and turns down while open, for the drawer's folders, a note's headings and the drawers in a note alike. In the drawer, folders used to point down while closed and up while open. A heading's contents, and a drawer's lines, now slide open and shut rather than appearing at once.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.6.3

KorgNote 1.6.2

Choose a tag to compare

@jglouis jglouis released this 02 Nov 18:23

A fix for the server, which stopped seeing edits made on the computer after a folder in the notes was deleted or renamed. Also: the app opens where you left it, and the table editor completes links and dates. Update the server: the fix is in it.

Sync

  • Edits made on the computer reach the phones again after a folder is deleted or renamed. Deleting or renaming any folder in the notes directory silently stopped the server from noticing edits made outside it, until it restarted. Every phone still reported a good sync, and brought nothing new. The server now keeps watching through any change of folders, notices notes in a folder made or moved in, and checks the whole folder every minute for anything it was not told about.
  • The Devices page says whether the notes folder is watched. Under Notes folder it shows the notes and folders watched and when they were last checked, and warns when watching fails or an edit was found that no file event reported. The details are in the server's log: docker logs korgnote. The log is also quieter: it no longer prints a stack trace each time a phone disconnects.

Notes

  • The app opens where you left it: on the same tab, the note you were reading, at the place you had read to. A note opened again from the drawer or a pin goes back to where you left it, rather than its top; a link, search or the agenda still go where they point. The calendar opens on the view you left it in.
  • The table editor's cells are highlighted and completed as a line is in the element editor: links after [[, dates after < or [, and Link and Date buttons when there is nothing to suggest.
  • Holding a TODO keyword opens the heading's menu, as holding the rest of the heading does, rather than changing the keyword when you lift your finger.

Capture

  • A place shared from Google Maps gets its address. Maps shares only a place's name and a short link; KorgNote now follows the link to find the address and pin, and writes :LOCATION: as the name, then the address. Offline, the place is its name and link, as before.

Fixes

  • On Android, the table editor's Row, Column and Formulas buttons stay above the keyboard while a cell is typed in, rather than hidden under it.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.6.2

KorgNote 1.6.1

Choose a tag to compare

@jglouis jglouis released this 01 Nov 18:33

A fix for capturing an event from the phone's calendar. Only the Android and iPhone apps change: the server needs no update.

Capture

  • An event just added in Google Calendar now shows in Pick an event. The list reads the phone's own copy of your calendars, which Google brings up to date only now and then: on one phone, an event added on the web was missing for hours. The picker now asks for that copy to be brought up to date when it opens, and adds the new events to the list as they arrive, while it stays open.
  • On Android, the first time, it asks you to pick your Google account in Android's Choose an account screen. Android ignores a request to update the calendars of an account the app may not see, and picking it once lets KorgNote see it for good. If you cancel, Fetch new events in the picker asks again.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.6.1

KorgNote 1.6.0

Choose a tag to compare

@jglouis jglouis released this 01 Nov 15:44

Clocking: track the time you spend on a heading, as Emacs does, and see where it went in the calendar. Also priorities, state changes logged with their notes, refiling, and conflicts settled change by change. Update the server too: the web client and the pairing page come with it.

Clocking

  • Clock in on a heading from its long-press menu, and out again, or cancel. KorgNote writes CLOCK: lines into the heading's :LOGBOOK: exactly as Emacs does, so either side sums what the other clocked. Clocking in stops any other clock running, in this note or another.
  • A bar on every tab shows the running clock: the heading, how long it has run, and a stop button. Its switch button takes you back to a task you clocked recently, the way back after an interruption. For an hour after you stop, it offers Clock back in.
  • On Android, an ongoing notification shows the clock with a timer, and its Clock out works with the app closed.
  • A clock started in Emacs, or on another device, shows on the phone once it has synced, and the other way round.
  • Each heading shows the time spent on it and under it, as 1 h 15, against its effort when it has one: 1 h 15 / 2 h, with a warning sign once it is past. Set effort… in the long-press menu sets it.
  • The calendar shows what the hours went on. The day and week draw clocked time beside what was planned, with the total above them; the agenda ends with a report of the time clocked in its days, by note and heading.
  • A long-press on a calendar entry clocks its heading in or out, and changes its TODO keyword.
  • A clock left running for eight hours turns the bar to a warning, with Clock out at… for the time you really stopped.
  • A clock edited by hand has its => 1:15 summed again when you save.

Tasks

  • Priorities: tap a heading's [#A], or Priority… in its long-press menu, to pick another from the note's range (#+PRIORITIES:, numbers up to 64 too). The agenda and the calendar put the most important first within a time.
  • State changes are logged as each keyword asks: DONE(d!) stamps the time, WAIT(w@) asks for a note, written under the state line as Org writes it, and into the :LOGBOOK: with #+STARTUP: logdrawer.
  • Refile a heading under another heading or note, with its body and sub-headings, from Refile… in its long-press menu: Emacs's C-c C-w.
  • Every date opens its day in the calendar, inactive ones included, and the long-press menu makes a date active or inactive.

Sync

  • Settle a conflict change by change. Compare now shows each change between the note and its conflict copy, under its heading: keep the note's lines, the copy's, both, or write them yourself, then apply. The two versions are told apart in red and green.

Org

  • Worth knowing: a note without a #+TODO: line now reads only TODO and DONE, as Org does. Before, it borrowed every keyword declared in any note. A note that relied on that needs a #+TODO: line of its own.
  • Habits (.+2d/4d) repeat again; lists run on over one blank line and keep their numbering; an item keeps its paragraphs, blocks and tables; checkbox items in a numbered list keep their number.
  • The agenda leaves out COMMENT headings and what is tagged :ARCHIVE:, as Org's does.
  • #+LINK: abbreviations and doi: links open; search's todo:NEXT and priority:A, and group tags from #+TAGS:, find what they name; entities such as \alpha, H_{2}O and <<targets>> read as they print.

Pairing

  • A failed pairing says why, and what to do, in a dialog: not a pairing code, a code without an address, a used or expired code, or nothing listening on the computer.
  • The server no longer makes a pairing code without an address a phone can reach: its Devices page says to type the computer's address, or to start the container with KORGNOTE_ADVERTISED_ADDRESSES.

Fixes

  • A heading's priority shows in the note again; it was saved but never drawn.
  • Opening another note while an element is being edited no longer carries the edit across: an untouched one, such as a new note's empty heading, is dropped, and one with changes asks to be saved or discarded first.
  • A new note opens at once, without waiting for the server.
  • Picking a keyword or a priority no longer holds the screen while the agenda is rebuilt.
  • Reminders show the KorgNote unicorn in the status bar instead of a calendar.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.6.0

KorgNote 1.5.1

Choose a tag to compare

@jglouis jglouis released this 31 Oct 16:17

A fix for the web client. Update the server: the web client comes with it.

Web

  • The web client opens notes again. In 1.5.0 it stopped on a blank page as soon as it showed a note with a #+DATE: line, and the calendar did the same. The apps on Android, iPhone and the desktop were not affected.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.5.1

KorgNote 1.5.0

Choose a tag to compare

@jglouis jglouis released this 31 Oct 15:42

Capture: put a link, a place, some text or a calendar event into your notes from wherever it is, in one step. And a few fixes to how TODO keywords are read.

Capture

  • Share to KorgNote from any app. A page from the browser, a place from Google Maps, text you selected: choose KorgNote in the share sheet, or Capture in KorgNote in the text selection menu on Android.
  • Capture an event from your calendar, Google Calendar's included, which can't share its events: Capture an event in the drawer, or the Event shortcut on the app's icon on Android. It is written as a SCHEDULED: entry, so it shows in your agenda.
  • Choose where it goes: the inbox, another note, a new note, or a heading — to add to it, or to put a new entry under it. A place becomes the heading's :LOCATION:, an event its SCHEDULED:.
  • See the entry as it will be written, shown and edited like any note, and mark it with one of the note's TODO keywords if you like. A place gives its location, its link, or both.
  • Captures are filed even with the app closed on Android. On iPhone they are filed the next time you open KorgNote.
  • Long-press the app's icon on Android for a quick note.
  • korgnote://capture?url=…&title=…&body=… links capture too, the same as Emacs's org-protocol, for bookmarklets and Shortcuts.

Notes

  • A heading starting with a word in capitals keeps it. * NASA plans was read as the keyword NASA: search titled it "plans", and setting a TODO on it replaced "NASA". Only the note's own TODO keywords count as keywords now.
  • #+SEQ_TODO: and #+TYP_TODO: lines are read like #+TODO: everywhere, and a line without | makes only its last word done, as in Org.
  • The drawer's actions are labelled buttons: New note, Today's daily, Capture an event.

Settings

  • Settings shows when the notes last synced, under the server.

Signer #1 certificate SHA-256 digest: 2bb8626e0a758e5fc3284f833bfa7b81995ecb3315612489c21805ea243d0720

Server image, for amd64 and arm64: docker pull ghcr.io/jglouis/korgnote-server:1.5.0