Files
roro9stack/site/content/guide/storage.md
T
twislaandClaude Opus 5.5 7fe8b3d22a
CI / build (pull_request) Successful in 7m22s
Site / build (pull_request) Successful in 14s
Help: Fn+h lists the keys of the screen you're on, and no screen names its keys any more (#69)
Fn+h on any screen, text fields included, and ? outside Text Entry, open a
panel over the content area: the screen's own keys, then the ones that work
everywhere. Every App declares its keys for the state it is in (pages,
viewers, dialogs and text fields answer for themselves); the App manager
opens the panel and takes every key while it is open.

About 30 hint lines are gone, from every App. What stays on a screen is
state. The first-start Setup keeps its hints and teaches the key; a device
set up before gets one Toast, once. The guide and the FAQ open with it.
`key help` over the consoles.

476 host tests (8 new). Checked on the device with key help and screenshots:
the Launcher, all nine Apps and several of their states. 8.5 KB of flash and
40 bytes of static RAM. Decisions Q196 to Q203 in docs/milestones/U1.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
2026-10-07 01:29:51 +02:00

3.0 KiB

+++ title = "Storage" description = "Browse the SD card: copy, move, rename and delete with a clipboard, and open a file by its type." weight = 8 [extra] tag = "Storage" screens = ["storage.png"] +++

Storage shows what is on the SD card: each folder's entries with their size and date, folders first. Enter opens a folder, Back goes up, and s sorts by name, date or size. A folder with more than 256 entries shows the first 256 by name, and says so.

Working on one item

Key Does
c / x Copies or cuts the selected file or folder; the footer shows what is waiting to be pasted
v Pastes it into the folder shown. A copy next to its original is named name (2).txt; anything in the way is asked about first
r Renames
d Deletes, after saying what is inside: "Delete saved and its 42 files (1.2 MB)?"
n Makes a folder
i Details: type, exact size, date, and why an item is read-only if it is

A copy runs in the background of the card (about 400 KB a second), in short turns, so logs and captures keep being written. It shows its progress, Back cancels it and takes back what was copied, and each file's size is checked afterwards.

What cannot be changed

  • the top-level folders the firmware keeps its files in (what is inside them can be);
  • /gemini/cache;
  • a file being written right now: today's IRC log, a Track or a capture being recorded.

The App says why when it refuses.

Opening files

Enter on a file opens it by its type, and Tab switches the same file to a hex dump or to text:

  • Text (.txt, .log, .gmi, .csv, and anything that looks like text): only a screenful is read from the card, so a file of any size opens at once, and logs open at the end. Up and down move a line, left and right a page, t and b go to the top and the end, and e edits it (up to 16 KB, as in Notes).
  • Captures (.pcap): the packets as the LoRa Scanner lists them; Enter shows one with its Meshtastic header and bytes.
  • Tracks (.gpx): the number of points, the start, the duration and the distance.
  • Update files (.ota): the version, and whether the file would install: it is checked as an install checks it, signature and contents, without writing anything. Enter then installs it (see Updates).
  • Anything else: a hex dump.

Maintenance

At the top of the card, the last row, Maintenance (or m), shows the card's usage and holds Storage clean-up and Erase SD card. They delete for good, so they sit behind a warning. Clean-up deletes old logs and captures by category and age, showing the space it would free first. Notes and Saved Pages are never offered.

The firmware warns once per start when the card passes 80% full; past 90%, logs stop being written so that the rest is kept for captures.