User guide · Notes

Notes

Plain text notes on the SD card, with no save key: the editor saves for you, and a power cut never costs the note.

The Notes editor on before-the-trip.txt, 113 bytes, saved: Before the trip, charge the Cardputer, the Heltec and its antenna, and a spare SD card, with the maps copied to it, a line that wraps on the screen
Notes
The Notes App listing the 3 notes in /notes, each under its first line, with its date: Before the trip, test the new theme and new card
Notes, the list

Notes are plain text files in /notes on the SD card. They are ordinary .txt files: you can read them on a computer too.

The list

Each note shows its first line and its date, newest first. s switches to sorting by file name.

KeyDoes
nStarts a new note
EnterOpens the note
rRenames its file
dDeletes it, after asking

The editor

Type. Enter starts a line and Del deletes backwards. Fn with the arrow keys moves the cursor through the wrapped text, Ctrl+A and Ctrl+E go to the start and the end of the line, Ctrl with Fn and up or down to the start and the end of the note, Tab types two spaces, and the compose key gives accents as everywhere.

There is no save key. The note is written five seconds after your last key, when you press Back, when you leave the App, when the screen turns off and before the device powers off. The top line says typing or saved.

Each save writes a temporary file and then puts it in the note's place, so a power cut costs a few seconds of typing and never the note. If a save was cut short, opening the note offers its copy back.

Names

A new note has no file until you type something. The file is then named after its first line (shopping-list.txt), or note-<date>-<time>.txt if that line gives no usable name.

Long notes

A note can be any size. The editor keeps the part around the cursor in memory and the rest on the card, so a file of a megabyte opens as fast as a short one and uses no more memory.

What changes with size is how it is saved:

  • Up to 64 KB, every save rewrites the file, as above.
  • Above, the five-second save writes only what you changed, to a file next to the note (<note>.edit). The note itself is rewritten when you leave it, with a progress bar: about a second for each 450 KB.
  • After a power cut, or if the device was switched off with the note open, opening the note again brings your saved changes back, and says so. Until then the file itself still has the old text, if you look at it from a computer.

Saving a long note needs room on the card for a second copy of it. If the file was replaced by something else while its changes were waiting, they can't be applied: they are kept as <note>.edit.lost and the editor tells you.

Limits

In Storage, e on a text file opens it in the same editor, anywhere on the card, unless the file is read-only. Notes are never offered for deletion by the clean-up.

The keys, as the device lists them

What Fn + h shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.

Notes, the list

; .up, down
Enteropen the note
, /a page up, down
na new note
rrename its file
d Deldelete it
ssort: newest, or by name

Notes, the editor

Entera new line
Deldelete backwards
Tabtwo spaces
Fn ; . , /move the cursor
Alt Fn ; .a page up, down
Ctrl Fn ; .start, end of the note
Ctrl a estart, end of the line
opt ' ean accent: é
`done: it saves by itself

Notes, a file name

Enterrename the file
`cancel
Deldelete backwards
Fn , /move the cursor