From e80092522ce1e52dec7512236dc2088a00580855 Mon Sep 17 00:00:00 2001 From: MarekZegare4 Date: Fri, 26 Jun 2026 11:51:06 +0200 Subject: [PATCH] docs(solo): document on-device room login with saved passwords MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a "Rooms — logging in" section and a room context-menu entry to the Messages screen docs: auto password prompt, passwords remembered across reboots, self-healing on failure, re-login via Login…, app-entered passwords also saved, and the ASCII-only keyboard caveat. Co-Authored-By: Claude Opus 4.8 --- .../message_screen/message_screen.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/solo_features/message_screen/message_screen.md b/docs/solo_features/message_screen/message_screen.md index 31362f2f..c025ca5b 100644 --- a/docs/solo_features/message_screen/message_screen.md +++ b/docs/solo_features/message_screen/message_screen.md @@ -40,6 +40,19 @@ Sensor placeholders appear automatically in the placeholder picker when the corr --- +### Rooms — logging in + +Posting to a **room server** requires a login handshake first, so the device can log in on its own — no phone app needed. The first time you press **Enter** on a room, a password prompt opens automatically; type the room's password and press the **✓** key (leave it empty and submit for open / no-password rooms). + +- **Passwords are remembered across reboots.** After a successful login the password is saved on the device, so picking that room again — even after a power cycle — logs back in silently without re-prompting. +- **A wrong or changed password self-heals.** If a saved password stops working (e.g. the server's password was changed), the failed login forgets it, so the next **Enter** prompts you to type a new one. +- **Re-login any time** with **Hold Enter** on the room → **Login…** (see the room context menu below) — useful to switch to a new password without waiting for a failure. +- Passwords set from the **phone app** are saved on the device too, so it can post to that room standalone after a reboot. + +> The on-screen keyboard is limited to ASCII (letters, digits and common symbols); accented characters such as `ą`/`ę` can't be typed on the device. A password containing them can still be set from the phone app — the device stores and replays it byte-for-byte. + +--- + ### Message history | OLED | E-Ink | @@ -92,6 +105,12 @@ A location is any `lat,lon` pair in the text — exactly what the `{loc}` placeh When **Pin to dial** is selected, a slot picker opens (Slot 1–6 showing current occupant name or "empty"). Choosing a slot that already holds another contact moves the new contact there. +In the **Rooms** list the context menu instead offers a single item: + +| Item | Action | +| ------- | ---------------------------------------------------------------------------- | +| Login… | Opens the password prompt to (re-)log in to this room (see Rooms — logging in) | + --- ### Context menu — channel list