diff --git a/README.md b/README.md
index 7c68ca9..f95c8da 100644
--- a/README.md
+++ b/README.md
@@ -13,73 +13,6 @@ GSMTAP into this analyser.
 
 ![SIMtrace Analyser PWA](frontend.png)
 
-## Components
-
-- **Analysis server + PWA** (`simtrace-analyser-server`) — stores captured
-  traffic in SQLite, decodes it, and serves the PWA ([`frontend/`](frontend/))
-  plus the HTTP API on a single origin.  Three capture modes: a GSMTAP
-  listener, direct SIMtrace2 hardware capture, or disabled (browse existing
-  captures only).
-- **Capture utility** (`simtrace2-pysniff`) — captures SIMtrace2 hardware
-  traffic and writes it to stdout, GSMTAP (Wireshark), or PCAP files.  It is
-  one GSMTAP source of several that the analyser accepts (see also
-  [sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)).
-- **PWA** ([`frontend/`](frontend/)) — trace browser with decoded APDU,
-  SIM Toolkit, SMS and SCP80 OTA detail; sessions, PCAP and COMPRION trace
-  import, EN/RU UI.
-
-## Features
-
-**APDU decoder** (server-side, rendered by the PWA):
-
-- Full APDU decode — CLA per ISO 7816-4 / ETSI coding with the **logical
-  channel 0-19** (standard channels from b2-b1, the extended channels 4-19
-  from b4-b1 per TS 102 221 §10.3), secure messaging and command chaining,
-  INS names from a spec table, SFI-aware P1/P2 for READ/UPDATE BINARY and
-  record commands; MANAGE CHANNEL replies show the channel the card
-  assigned
-- Status words — full ISO 7816-4 set plus UICC-specific values:
-  `91XX` (proactive command pending), `62F1/F2/F3`, `63F1/F2` (more data),
-  `9300` (SAT busy), `9850`, `9862–64`
-- SIM Toolkit — SAT (GSM 11.14), CAT (TS 102 223) and USAT (TS 31.111)
-  proactive commands with decoded qualifiers, TERMINAL RESPONSE, ENVELOPE
-  (Menu Selection, Call Control, SMS-PP download…); tolerates known
-  non-compliant legacy-card quirks and preserves unrecognized TLVs
-- TERMINAL CAPABILITY (TS 102 221 §11.1.19) — terminal power supply
-  (voltage class, maximum current, clock), extended logical channels,
-  additional interfaces (UICC-CLF) and eUICC device capabilities
-  (SGP.22/SGP.32)
-- SMS TPDU — SMS-DELIVER/SUBMIT, SCTS timestamps, UDH information elements
-- SCP80 OTA secured packets — SPI bits (ciphering, PoR requirement/mode,
-  RC/CC/DS, counter), KIc/KID algorithm + key set, TAR, CNTR/PCNTR;
-  Response Packet (PoR) decode on GET RESPONSE; **optional client-side
-  decryption** of ciphered packets — paste the card's 3DES/AES key in the
-  detail view to reveal the real CNTR and secured application data (the
-  key stays in the browser, in-memory only; ciphered on-wire CNTR/PCNTR/RC
-  are ciphertext and labeled as such); the secured application message is
-  decoded as a stream of **C-APDUs** (SELECT, UPDATE BINARY, …) with
-  full CLA/INS/P1/P2/Lc/Le breakdown — plaintext immediately, or after
-  decryption for ciphered packets
-- ATR parse (clock-rate conversion, Fi/Di, T-bitmask, truncated-ATR safe)
-  and FCP/FCI TLV; the historical bytes are decoded as the UICC's
-  COMPACT-TLV objects (TS 102 221 §6.3.1) — card service data, the **card
-  capabilities** (ISO 7816-4 §8.1.1.2.7 Table 88: the assignment methods
-  and the announced maximum number of logical channels, `8 or more` for the
-  extended-capable cards) and the trailing status indicator (LCS/SW)
-
-**SIMtrace Analyser PWA** ([`frontend/`](frontend/)):
-
-- Trace view with Map/List modes — proactive, TERMINAL RESPONSE, ENVELOPE
-  and AUTH commands get distinctive styling in map view
-- Sessions with deep links (`#session=N`), PCAP import (`.pcap/.pcapng/.cap`),
-  COMPRION trace import (the Device Manager *ISO Protocol Layer* text export),
-  search and a **multi-select command filter** — pick any number of commands
-  and/or the conversation presets (*Proactive sessions*: FETCH, TERMINAL
-  PROFILE and every command answered with SW 91xx; *File operations*: SELECT,
-  READ/UPDATE BINARY and READ/UPDATE RECORD, with the GET RESPONSE carrying a
-  selected command's data)
-- Installable PWA, dark theme, English/Russian UI
-
 ## Prerequisites
 
 - **Python 3.9+**
@@ -94,22 +27,17 @@ GSMTAP into this analyser.
 
 No other dependencies. PCAP, GSMTAP, and hex dump output use only Python stdlib.
 
-## Install
+## Quick start
 
-There are two ways to get the analyser: install a release artifact (no git
-history), or clone the repository for development.  Both bundle the same PWA.
+Three ways to get it running; all of them serve the same PWA at
+http://127.0.0.1:8081/.
 
-### From a release (no git history)
+### 1. Wheel (pip)
 
-Everything is on the
-[latest release](https://github.com/anttro/simtrace-analyser/releases/latest).
-
-**Wheel** (the PWA is inside the package):
+The wheel bundles the PWA, so the server serves the UI by itself:
 
 ```sh
 pip install ./simtrace_analyser-2.7.13-py3-none-any.whl
-
-# then run (the UI is served at http://127.0.0.1:8081/):
 simtrace-analyser-server --capture gsmtap
 ```
 
@@ -117,31 +45,43 @@ If your system Python is externally managed (PEP 668 — common on Arch and
 Fedora), install into a virtual environment first:
 `python3 -m venv .venv && . .venv/bin/activate`.
 
-`pip` can also fetch the wheel straight from the release page (use the version
-shown there):
+Every artifact is on the
+[latest release](https://github.com/anttro/simtrace-analyser/releases/latest).
+`pip` can fetch the wheel directly (use the version shown there), or the GitHub
+CLI can pick the latest one:
 
 ```sh
 pip install https://github.com/anttro/simtrace-analyser/releases/download/v2.7.13/simtrace_analyser-2.7.13-py3-none-any.whl
-```
-
-With the GitHub CLI, download the latest wheel without knowing the version:
-
-```sh
+# or:
 gh release download --pattern '*.whl'
 pip install ./simtrace_analyser-*.whl
 ```
 
-**Source archive** — the *Source code (zip / tar.gz)* assets are the full tree
-without the git history: unzip, `cd` into it and use the launchers below
-(`./start.sh` on Linux/macOS, `start.bat` on Windows).
+### 2. Zip (Windows-friendly, no installer)
 
-**Zip (Windows-friendly, no installer)** — `simtrace-analyser-2.7.13.zip` is
-the runtime tree only (packages, PWA, launchers, docs; no tests, no git):
-download it, extract it anywhere and run `start.bat` (Windows) or
-`./start.sh` (Linux/macOS).  Python 3 has to be on `PATH`; `pip install pyusb`
-is only needed for direct SIMtrace2 capture.
+Download `simtrace-analyser-2.7.13.zip` from the release page and extract it
+anywhere: it is the runtime tree (the Python packages, the PWA, the launchers
+and the docs — no tests, no git).  Then run:
 
-### From a git clone (development)
+Windows:
+
+```bat
+start.bat
+```
+
+Linux/macOS:
+
+```sh
+./start.sh
+```
+
+Python 3 has to be on `PATH`; `pip install pyusb` is only needed for direct
+SIMtrace2 capture.  The launchers accept the server's options
+(`start.bat --capture direct`, `./start.sh --capture direct --port 8080`).
+(The release's *Source code* archive is the full tree including tests; it
+works like a clone below.)
+
+### 3. Git clone (development)
 
 ```sh
 git clone https://github.com/anttro/simtrace-analyser.git
@@ -149,30 +89,42 @@ cd simtrace-analyser
 ./start.sh                  # Linux/macOS; on Windows: start.bat
 ```
 
-The launchers add the checkout to `PYTHONPATH` and run
-`python -m simtrace_analyser`, so no install step is needed for browsing and
-GSMTAP capture; they accept the server's options (`./start.sh --capture direct
---port 8080`).  Direct hardware capture needs **PyUSB** (`pip install pyusb`).
-
-To get the console scripts (`simtrace-analyser-server`, `simtrace2-pysniff`)
-install the package instead:
+The launchers put the checkout on `PYTHONPATH` and run
+`python -m simtrace_analyser`, so nothing has to be installed for browsing and
+GSMTAP capture; their options are the server's
+(`./start.sh --capture direct --port 8080`).  Direct hardware capture needs
+**PyUSB** (`pip install pyusb`).  To get the console scripts
+(`simtrace-analyser-server`, `simtrace2-pysniff`) install the package:
 
 ```sh
 pip install -e .
 simtrace-analyser-server --capture gsmtap
 ```
 
-On Windows the `.bat` launchers run the `python` command, so Python 3 has to be
-on `PATH` (check with `python --version`); direct USB capture additionally
-needs the driver swap described in [USB Device Access](#usb-device-access).
+### First run
 
-## Running
+Open **http://127.0.0.1:8081/** — the PWA is served by the server, so the UI
+and the API share an origin (no CORS/Private-Network-Access setup).  `Ctrl+C`
+stops the server.
+
+- `--capture gsmtap` (default) — listen for GSMTAP-SIM on UDP 4729, e.g. from
+  `simtrace2-pysniff` or `sigrok_iso7816_stream`;
+- `--capture direct` — read SIMtrace2 hardware directly (needs PyUSB; Windows
+  also needs the driver swap, see [USB Device Access](#usb-device-access));
+- `--capture disabled` — only browse stored captures.
+
+The full runtime guide (server options, the UI views, the capture utility) is
+in [Usage](#usage) below.
+
+## Usage
 
 ### Analysis server + PWA (`simtrace-analyser-server`)
 
 Stores captured APDU traffic in SQLite and serves it over HTTP, together with
 the bundled **SIMtrace Analyser** PWA (`frontend/` in a source checkout,
-bundled into the package on install) on the same origin.  Three
+bundled into the package on install) on the same origin.  The commands below
+use the console script; from a source checkout the launchers take the same
+options (`./start.sh --capture gsmtap`, `start.bat --capture gsmtap`).  Three
 capture modes:
 
 ```sh
@@ -405,6 +357,71 @@ If installed via `pip install -e .`, use the console script directly:
 simtrace2-pysniff --format atr-time
 ```
 
+### Utility CLI Options
+
+```
+python -m simtrace2_pysniff [OPTIONS]
+
+  --format, -f FORMAT       Output format (default: hex)
+                            hex       — plain hex dump
+                            timestamp — TPDU lines prefixed with [HH:MM:SS.mmm]
+                            atr-time  — TPDU lines prefixed with [SSSS.mmm] from last ATR
+  --gsmtap HOST[:PORT]      Send ATR/TPDU as GSMTAP over UDP (default port 4729)
+  --pcap FILE               Write sniffed data to PCAP file for Wireshark
+  --output, -o FILE         Write hex dump to file
+  --no-stdout               Suppress hex dump to stdout
+  --vendor HEX              USB vendor ID (default: 0x1d50)
+  --product HEX             USB product ID (default: auto-detect)
+
+Recovery options:
+  --no-reconnect            Exit on USB disconnect instead of reconnecting
+  --reconnect-delay-min SEC Minimum reconnect delay (default: 1.0)
+  --reconnect-delay-max SEC Maximum reconnect delay cap (default: 30.0)
+  --backoff-factor N        Exponential backoff multiplier (default: 1.5)
+  --inactivity-timeout SEC  Reconnect after N seconds of silence (default: disabled)
+```
+
+### Output Formats
+
+- **`hex`** (default): plain hex dump — `ATR: 3b 9e ...`, `TPDU: a0 a4 00 00 02 3f 00`
+- **`timestamp`**: TPDU lines prefixed with local time — `[14:32:05.123] TPDU: a0 a4 00 00 02 3f 00`
+- **`atr-time`**: TPDU lines prefixed with seconds since last ATR — `[0001.234] TPDU: a0 a4 00 00 02 3f 00`
+
+Non-TPDU messages (ATR, PPS, card state changes, Fi/Di) print identically in all formats.
+
+- **GSMTAP**: ATR and APDU messages over UDP (port 4729) to Wireshark
+- **PCAP**: ATR/TPDU messages as Ethernet/IP/UDP/GSMTAP packets, openable in Wireshark
+
+### Background / Daemon
+
+SIGHUP is automatically ignored when stdin is not a terminal (i.e. run in
+background or via a pipe). Foreground terminal sessions still respond to
+SIGHUP normally.
+
+To run persistently in the background with output to files:
+
+```sh
+nohup ./sniff-start.sh --output /tmp/sniff.log &> /tmp/sniff-err.log &
+# or
+FORMAT=timestamp nohup python -m simtrace2_pysniff --output /tmp/sniff.log &> /tmp/sniff-err.log &
+```
+
+### Library Usage
+
+```python
+from simtrace2_pysniff import SniffSession
+
+session = SniffSession(inactivity_timeout=30.0)
+for msg in session.iter_messages():
+    print(f"{msg.type}: {msg.data.hex()}")
+```
+
+### Recovery
+
+The utility survives hardware resets, cable disconnects, and firmware hangs
+by default — it reconnects with exponential backoff (1s → 30s cap).
+Use `--inactivity-timeout` to also trigger reconnect on silent firmware hangs.
+
 ## USB Device Access
 
 Required for capture from SIMtrace2 hardware (the utility and the server's
@@ -442,70 +459,72 @@ through: `start.bat --capture direct` starts the analyser server and
 Python 3 must be on `PATH` (verify with `python --version` in a new command
 prompt).
 
-## Utility CLI Options
+## Components
 
-```
-python -m simtrace2_pysniff [OPTIONS]
+- **Analysis server + PWA** (`simtrace-analyser-server`) — stores captured
+  traffic in SQLite, decodes it, and serves the PWA ([`frontend/`](frontend/))
+  plus the HTTP API on a single origin.  Three capture modes: a GSMTAP
+  listener, direct SIMtrace2 hardware capture, or disabled (browse existing
+  captures only).
+- **Capture utility** (`simtrace2-pysniff`) — captures SIMtrace2 hardware
+  traffic and writes it to stdout, GSMTAP (Wireshark), or PCAP files.  It is
+  one GSMTAP source of several that the analyser accepts (see also
+  [sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)).
+- **PWA** ([`frontend/`](frontend/)) — trace browser with decoded APDU,
+  SIM Toolkit, SMS and SCP80 OTA detail; sessions, PCAP and COMPRION trace
+  import, EN/RU UI.
 
-  --format, -f FORMAT       Output format (default: hex)
-                            hex       — plain hex dump
-                            timestamp — TPDU lines prefixed with [HH:MM:SS.mmm]
-                            atr-time  — TPDU lines prefixed with [SSSS.mmm] from last ATR
-  --gsmtap HOST[:PORT]      Send ATR/TPDU as GSMTAP over UDP (default port 4729)
-  --pcap FILE               Write sniffed data to PCAP file for Wireshark
-  --output, -o FILE         Write hex dump to file
-  --no-stdout               Suppress hex dump to stdout
-  --vendor HEX              USB vendor ID (default: 0x1d50)
-  --product HEX             USB product ID (default: auto-detect)
+## Features
 
-Recovery options:
-  --no-reconnect            Exit on USB disconnect instead of reconnecting
-  --reconnect-delay-min SEC Minimum reconnect delay (default: 1.0)
-  --reconnect-delay-max SEC Maximum reconnect delay cap (default: 30.0)
-  --backoff-factor N        Exponential backoff multiplier (default: 1.5)
-  --inactivity-timeout SEC  Reconnect after N seconds of silence (default: disabled)
-```
+**APDU decoder** (server-side, rendered by the PWA):
 
-## Output Formats
+- Full APDU decode — CLA per ISO 7816-4 / ETSI coding with the **logical
+  channel 0-19** (standard channels from b2-b1, the extended channels 4-19
+  from b4-b1 per TS 102 221 §10.3), secure messaging and command chaining,
+  INS names from a spec table, SFI-aware P1/P2 for READ/UPDATE BINARY and
+  record commands; MANAGE CHANNEL replies show the channel the card
+  assigned
+- Status words — full ISO 7816-4 set plus UICC-specific values:
+  `91XX` (proactive command pending), `62F1/F2/F3`, `63F1/F2` (more data),
+  `9300` (SAT busy), `9850`, `9862–64`
+- SIM Toolkit — SAT (GSM 11.14), CAT (TS 102 223) and USAT (TS 31.111)
+  proactive commands with decoded qualifiers, TERMINAL RESPONSE, ENVELOPE
+  (Menu Selection, Call Control, SMS-PP download…); tolerates known
+  non-compliant legacy-card quirks and preserves unrecognized TLVs
+- TERMINAL CAPABILITY (TS 102 221 §11.1.19) — terminal power supply
+  (voltage class, maximum current, clock), extended logical channels,
+  additional interfaces (UICC-CLF) and eUICC device capabilities
+  (SGP.22/SGP.32)
+- SMS TPDU — SMS-DELIVER/SUBMIT, SCTS timestamps, UDH information elements
+- SCP80 OTA secured packets — SPI bits (ciphering, PoR requirement/mode,
+  RC/CC/DS, counter), KIc/KID algorithm + key set, TAR, CNTR/PCNTR;
+  Response Packet (PoR) decode on GET RESPONSE; **optional client-side
+  decryption** of ciphered packets — paste the card's 3DES/AES key in the
+  detail view to reveal the real CNTR and secured application data (the
+  key stays in the browser, in-memory only; ciphered on-wire CNTR/PCNTR/RC
+  are ciphertext and labeled as such); the secured application message is
+  decoded as a stream of **C-APDUs** (SELECT, UPDATE BINARY, …) with
+  full CLA/INS/P1/P2/Lc/Le breakdown — plaintext immediately, or after
+  decryption for ciphered packets
+- ATR parse (clock-rate conversion, Fi/Di, T-bitmask, truncated-ATR safe)
+  and FCP/FCI TLV; the historical bytes are decoded as the UICC's
+  COMPACT-TLV objects (TS 102 221 §6.3.1) — card service data, the **card
+  capabilities** (ISO 7816-4 §8.1.1.2.7 Table 88: the assignment methods
+  and the announced maximum number of logical channels, `8 or more` for the
+  extended-capable cards) and the trailing status indicator (LCS/SW)
 
-- **`hex`** (default): plain hex dump — `ATR: 3b 9e ...`, `TPDU: a0 a4 00 00 02 3f 00`
-- **`timestamp`**: TPDU lines prefixed with local time — `[14:32:05.123] TPDU: a0 a4 00 00 02 3f 00`
-- **`atr-time`**: TPDU lines prefixed with seconds since last ATR — `[0001.234] TPDU: a0 a4 00 00 02 3f 00`
+**SIMtrace Analyser PWA** ([`frontend/`](frontend/)):
 
-Non-TPDU messages (ATR, PPS, card state changes, Fi/Di) print identically in all formats.
-
-- **GSMTAP**: ATR and APDU messages over UDP (port 4729) to Wireshark
-- **PCAP**: ATR/TPDU messages as Ethernet/IP/UDP/GSMTAP packets, openable in Wireshark
-
-## Background / Daemon
-
-SIGHUP is automatically ignored when stdin is not a terminal (i.e. run in
-background or via a pipe). Foreground terminal sessions still respond to
-SIGHUP normally.
-
-To run persistently in the background with output to files:
-
-```sh
-nohup ./sniff-start.sh --output /tmp/sniff.log &> /tmp/sniff-err.log &
-# or
-FORMAT=timestamp nohup python -m simtrace2_pysniff --output /tmp/sniff.log &> /tmp/sniff-err.log &
-```
-
-## Library Usage
-
-```python
-from simtrace2_pysniff import SniffSession
-
-session = SniffSession(inactivity_timeout=30.0)
-for msg in session.iter_messages():
-    print(f"{msg.type}: {msg.data.hex()}")
-```
-
-## Recovery
-
-The utility survives hardware resets, cable disconnects, and firmware hangs
-by default — it reconnects with exponential backoff (1s → 30s cap).
-Use `--inactivity-timeout` to also trigger reconnect on silent firmware hangs.
+- Trace view with Map/List modes — proactive, TERMINAL RESPONSE, ENVELOPE
+  and AUTH commands get distinctive styling in map view
+- Sessions with deep links (`#session=N`), PCAP import (`.pcap/.pcapng/.cap`),
+  COMPRION trace import (the Device Manager *ISO Protocol Layer* text export),
+  search and a **multi-select command filter** — pick any number of commands
+  and/or the conversation presets (*Proactive sessions*: FETCH, TERMINAL
+  PROFILE and every command answered with SW 91xx; *File operations*: SELECT,
+  READ/UPDATE BINARY and READ/UPDATE RECORD, with the GET RESPONSE carrying a
+  selected command's data)
+- Installable PWA, dark theme, English/Russian UI
 
 ## Related
 
diff --git a/README_RUS.md b/README_RUS.md
index ef9f74e..cb9216a 100644
--- a/README_RUS.md
+++ b/README_RUS.md
@@ -13,76 +13,6 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы
 
 ![PWA SIMtrace Analyser](frontend.png)
 
-## Компоненты
-
-- **Анализирующий сервер + PWA** (`simtrace-analyser-server`) — сохраняет
-  захваченный трафик в SQLite, декодирует его и отдаёт PWA
-  ([`frontend/`](frontend/)) вместе с HTTP API на одном origin. Три режима
-  захвата: GSMTAP-листенер, захват напрямую с оборудования SIMtrace2 или
-  отключённый захват (только просмотр существующих записей).
-- **Утилита захвата** (`simtrace2-pysniff`) — захватывает трафик
-  оборудования SIMtrace2 и выводит его в stdout, GSMTAP (Wireshark) или
-  PCAP-файлы. Это один из нескольких источников GSMTAP, которые принимает
-  анализатор (см. также
-  [sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)).
-- **PWA** ([`frontend/`](frontend/)) — окно трассировки с декодированными
-  APDU, SIM Toolkit, SMS и SCP80 OTA; сессии, импорт PCAP и трасс COMPRION,
-  интерфейс EN/RU.
-
-## Возможности
-
-**Декодер APDU** (на стороне сервера, отображается в PWA):
-
-- Полное декодирование APDU — CLA по ISO 7816-4 / ETSI с **логическим
-  каналом 0-19** (стандартные каналы из b2-b1, расширенные 4-19 из b4-b1
-  по TS 102 221 §10.3), secure messaging и chaining команд, имена INS из
-  таблицы спецификаций, учёт SFI в P1/P2 для READ/UPDATE BINARY и команд
-  с записями; ответ MANAGE CHANNEL показывает назначенный картой канал
-- Статусные слова — полный набор ISO 7816-4 плюс специфичные для UICC
-  значения: `91XX` (ожидается proactive-команда), `62F1/F2/F3`,
-  `63F1/F2` (больше данных), `9300` (SAT busy), `9850`, `9862–64`
-- SIM Toolkit — SAT (GSM 11.14), CAT (TS 102 223) и USAT (TS 31.111):
-  proactive-команды с декодированными квалификаторами, TERMINAL RESPONSE,
-  ENVELOPE (Menu Selection, Call Control, SMS-PP download…); учитываются
-  известные несоответствия старых карт, нераспознанные TLV сохраняются
-- TERMINAL CAPABILITY (TS 102 221 §11.1.19) — питание терминала (класс
-  напряжения, максимальный ток, тактовая частота), расширенные логические
-  каналы, дополнительные интерфейсы (UICC-CLF) и возможности eUICC
-  (SGP.22/SGP.32)
-- SMS TPDU — SMS-DELIVER/SUBMIT, метки времени SCTS, информационные
-  элементы UDH
-- SCP80 OTA secured packets — биты SPI (шифрование, требование/режим PoR,
-  RC/CC/DS, счётчик), алгоритм KIc/KID + набор ключей, TAR, CNTR/PCNTR;
-  декодирование Response Packet (PoR) по GET RESPONSE; **опциональная
-  расшифровка на клиенте** зашифрованных пакетов — вставьте 3DES/AES-ключ
-  карты в панели деталей, чтобы увидеть настоящие CNTR и защищённые данные
-  приложения (ключ остаётся в браузере, только в памяти; зашифрованные
-  в эфире CNTR/PCNTR/RC — это шифротекст, и они так и помечены); защищённое
-  сообщение приложения декодируется как поток **C-APDU** (SELECT,
-  UPDATE BINARY, …) с полной разбивкой CLA/INS/P1/P2/Lc/Le — сразу для
-  открытого текста или после расшифровки для зашифрованных пакетов
-- Разбор ATR (пересчёт тактовой частоты, Fi/Di, битовая маска T,
-  безопасен для усечённых ATR) и FCP/FCI TLV; исторические байты
-  разбираются как COMPACT-TLV объекты UICC (TS 102 221 §6.3.1) — card
-  service data, **card capabilities** (ISO 7816-4 §8.1.1.2.7 таблица 88:
-  способы назначения и заявленное максимальное число логических каналов,
-  `8 or more` у карт с расширенными каналами) и завершающий индикатор
-  состояния (LCS/SW)
-
-**PWA SIMtrace Analyser** ([`frontend/`](frontend/)):
-
-- Окно трассировки с режимами «Карта»/«Список» — proactive,
-  TERMINAL RESPONSE, ENVELOPE и AUTH-команды выделяются в режиме карты
-- Сессии с прямыми ссылками (`#session=N`), импорт PCAP
-  (`.pcap/.pcapng/.cap`), импорт трасс COMPRION (текстовый экспорт
-  «ISO Protocol Layer» из Device Manager), поиск и **фильтр команд с
-  множественным выбором** — любые команды и/или готовые пресеты («Проактивные
-  сессии»: FETCH, TERMINAL PROFILE и все команды с ответом SW 91xx;
-  «Файловые операции»: SELECT,
-  READ/UPDATE BINARY и READ/UPDATE RECORD, вместе с GET RESPONSE, несущим
-  данные выбранной команды)
-- Устанавливаемая PWA, тёмная тема, интерфейс на английском/русском
-
 ## Требования
 
 - **Python 3.9+**
@@ -99,23 +29,17 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы
 Других зависимостей нет. Вывод PCAP, GSMTAP и hex dump использует только
 стандартную библиотеку Python.
 
-## Установка
+## Быстрый старт
 
-Есть два способа получить анализатор: установить артефакт релиза (без истории
-git) или склонировать репозиторий для разработки. В обоих случаях в комплекте
-одна и та же PWA.
+Три способа запустить анализатор; все они отдают одну и ту же PWA на
+http://127.0.0.1:8081/.
 
-### Из релиза (без истории git)
+### 1. Wheel (pip)
 
-Всё находится на странице
-[последнего релиза](https://github.com/anttro/simtrace-analyser/releases/latest).
-
-**Wheel** (PWA внутри пакета):
+Wheel содержит PWA внутри пакета, поэтому сервер отдаёт интерфейс сам:
 
 ```sh
 pip install ./simtrace_analyser-2.7.13-py3-none-any.whl
-
-# затем запуск (интерфейс отдаётся на http://127.0.0.1:8081/):
 simtrace-analyser-server --capture gsmtap
 ```
 
@@ -123,31 +47,43 @@ simtrace-analyser-server --capture gsmtap
 Fedora), сначала создайте виртуальное окружение:
 `python3 -m venv .venv && . .venv/bin/activate`.
 
-`pip` также может скачать wheel прямо со страницы релиза (подставьте версию,
-указанную там):
+Все артефакты лежат на странице
+[последнего релиза](https://github.com/anttro/simtrace-analyser/releases/latest).
+`pip` может скачать wheel напрямую (подставьте версию со страницы), а GitHub
+CLI — выбрать последнюю:
 
 ```sh
 pip install https://github.com/anttro/simtrace-analyser/releases/download/v2.7.13/simtrace_analyser-2.7.13-py3-none-any.whl
-```
-
-С GitHub CLI можно скачать wheel последнего релиза, не зная версии:
-
-```sh
+# или:
 gh release download --pattern '*.whl'
 pip install ./simtrace_analyser-*.whl
 ```
 
-**Архив исходников** — ассеты *Source code (zip / tar.gz)* содержат полное
-дерево без истории git: распакуйте, перейдите в каталог и используйте скрипты
-запуска ниже (`./start.sh` в Linux/macOS, `start.bat` в Windows).
+### 2. Zip (для Windows, без установки)
 
-**Zip (для Windows, без установки)** — `simtrace-analyser-2.7.13.zip`
-содержит только рабочее дерево (пакеты, PWA, скрипты запуска, документацию;
-без тестов и git): скачайте, распакуйте в любое место и запустите `start.bat`
-(Windows) или `./start.sh` (Linux/macOS). Python 3 должен быть в `PATH`;
-`pip install pyusb` нужен только для прямого захвата с SIMtrace2.
+Скачайте `simtrace-analyser-2.7.13.zip` со страницы релиза и распакуйте в любое
+место: это рабочее дерево (пакеты Python, PWA, скрипты запуска и документация —
+без тестов и git). Затем запустите.
 
-### Из клона репозитория (для разработки)
+Windows:
+
+```bat
+start.bat
+```
+
+Linux/macOS:
+
+```sh
+./start.sh
+```
+
+Python 3 должен быть в `PATH`; `pip install pyusb` нужен только для прямого
+захвата с SIMtrace2.  Скрипты принимают параметры сервера
+(`start.bat --capture direct`, `./start.sh --capture direct --port 8080`).
+(Архив *Source code* из релиза — это полное дерево вместе с тестами; он
+работает так же, как клон ниже.)
+
+### 3. Клон репозитория (для разработки)
 
 ```sh
 git clone https://github.com/anttro/simtrace-analyser.git
@@ -156,31 +92,42 @@ cd simtrace-analyser
 ```
 
 Скрипты запуска добавляют каталог в `PYTHONPATH` и запускают
-`python -m simtrace_analyser`, поэтому для просмотра и захвата GSMTAP
-установка не нужна; они принимают параметры сервера
-(`./start.sh --capture direct --port 8080`). Для прямого захвата с
-оборудования нужен **PyUSB** (`pip install pyusb`).
-
-Чтобы получить консольные команды (`simtrace-analyser-server`,
-`simtrace2-pysniff`), установите пакет:
+`python -m simtrace_analyser`, поэтому для просмотра и захвата GSMTAP ничего
+устанавливать не нужно; их параметры — это параметры сервера
+(`./start.sh --capture direct --port 8080`).  Для прямого захвата с
+оборудования нужен **PyUSB** (`pip install pyusb`).  Чтобы получить консольные
+команды (`simtrace-analyser-server`, `simtrace2-pysniff`), установите пакет:
 
 ```sh
 pip install -e .
 simtrace-analyser-server --capture gsmtap
 ```
 
-В Windows скрипты `.bat` вызывают команду `python`, поэтому Python 3 должен
-быть в `PATH` (проверьте `python --version`); для прямого захвата по USB
-дополнительно нужна замена драйвера, описанная в разделе
-[Доступ к USB-устройству](#доступ-к-usb-устройству).
+### Первый запуск
 
-## Запуск
+Откройте **http://127.0.0.1:8081/** — PWA отдаёт сервер, поэтому интерфейс и
+API находятся на одном origin (настройка CORS/Private-Network-Access не нужна).
+`Ctrl+C` останавливает сервер.
+
+- `--capture gsmtap` (по умолчанию) — слушать GSMTAP-SIM на UDP 4729,
+  например от `simtrace2-pysniff` или `sigrok_iso7816_stream`;
+- `--capture direct` — читать оборудование SIMtrace2 напрямую (нужен PyUSB; в
+  Windows также нужна замена драйвера, см.
+  [Доступ к USB-устройству](#доступ-к-usb-устройству));
+- `--capture disabled` — только просмотр сохранённых захватов.
+
+Полное руководство по работе (параметры сервера, экраны PWA, утилита захвата)
+находится в разделе [Использование](#использование).
+
+## Использование
 
 ### Анализирующий сервер + PWA (`simtrace-analyser-server`)
 
 Сохраняет захваченный APDU-трафик в SQLite и отдаёт его по HTTP вместе
 со встроенной PWA **SIMtrace Analyser** (`frontend/` в исходном клоне, при
 установке — внутри пакета) на том же origin.
+Команды ниже — консольная команда; при запуске из клона скрипты принимают те
+же параметры (`./start.sh --capture gsmtap`, `start.bat --capture gsmtap`).
 Три режима захвата:
 
 ```sh
@@ -417,6 +364,77 @@ python -m simtrace2_pysniff --pcap trace.pcap
 simtrace2-pysniff --format atr-time
 ```
 
+### Параметры CLI утилиты
+
+```
+python -m simtrace2_pysniff [OPTIONS]
+
+  --format, -f FORMAT       Формат вывода (по умолчанию: hex)
+                            hex       — обычный hex-дамп
+                            timestamp — строки TPDU с префиксом [ЧЧ:ММ:СС.мс]
+                            atr-time  — строки TPDU с префиксом [СССС.мс] от последнего ATR
+  --gsmtap HOST[:PORT]      Отправлять ATR/TPDU как GSMTAP по UDP (порт по умолчанию 4729)
+  --pcap FILE               Записывать перехваченные данные в PCAP для Wireshark
+  --output, -o FILE         Записывать hex-дамп в файл
+  --no-stdout               Не выводить hex-дамп в stdout
+  --vendor HEX              USB vendor ID (по умолчанию: 0x1d50)
+  --product HEX             USB product ID (по умолчанию: автоопределение)
+
+Параметры восстановления:
+  --no-reconnect            Выходить при отключении USB вместо переподключения
+  --reconnect-delay-min SEC Минимальная задержка переподключения (по умолчанию: 1.0)
+  --reconnect-delay-max SEC Максимальная задержка переподключения (по умолчанию: 30.0)
+  --backoff-factor N        Множитель экспоненциальной задержки (по умолчанию: 1.5)
+  --inactivity-timeout SEC  Переподключаться после N секунд тишины (по умолчанию: выключено)
+```
+
+### Форматы вывода
+
+- **`hex`** (по умолчанию): обычный hex-дамп — `ATR: 3b 9e ...`,
+  `TPDU: a0 a4 00 00 02 3f 00`
+- **`timestamp`**: строки TPDU с локальным временем —
+  `[14:32:05.123] TPDU: a0 a4 00 00 02 3f 00`
+- **`atr-time`**: строки TPDU с секундами от последнего ATR —
+  `[0001.234] TPDU: a0 a4 00 00 02 3f 00`
+
+Сообщения, не являющиеся TPDU (ATR, PPS, изменения состояния карты, Fi/Di),
+выводятся одинаково во всех форматах.
+
+- **GSMTAP**: сообщения ATR и APDU по UDP (порт 4729) в Wireshark
+- **PCAP**: сообщения ATR/TPDU как пакеты Ethernet/IP/UDP/GSMTAP,
+  открываются в Wireshark
+
+### Фоновый режим / демон
+
+SIGHUP автоматически игнорируется, когда stdin не является терминалом
+(т.е. при запуске в фоне или через канал). Сессии в терминале на переднем
+плане по-прежнему обрабатывают SIGHUP обычным образом.
+
+Для постоянной работы в фоне с выводом в файлы:
+
+```sh
+nohup ./sniff-start.sh --output /tmp/sniff.log &> /tmp/sniff-err.log &
+# или
+FORMAT=timestamp nohup python -m simtrace2_pysniff --output /tmp/sniff.log &> /tmp/sniff-err.log &
+```
+
+### Использование как библиотеки
+
+```python
+from simtrace2_pysniff import SniffSession
+
+session = SniffSession(inactivity_timeout=30.0)
+for msg in session.iter_messages():
+    print(f"{msg.type}: {msg.data.hex()}")
+```
+
+### Восстановление
+
+Утилита по умолчанию переживает сбросы оборудования, отключения кабеля
+и зависания прошивки — она переподключается с экспоненциальной задержкой
+(1с → 30с). Используйте `--inactivity-timeout`, чтобы также переподключаться
+при «тихих» зависаниях прошивки.
+
 ## Доступ к USB-устройству
 
 Нужен для захвата с оборудования SIMtrace2 (утилита и режим
@@ -455,76 +473,75 @@ sudo udevadm trigger
 Python 3 должен быть в `PATH` (проверьте `python --version` в новом окне
 команды).
 
-## Параметры CLI утилиты
+## Компоненты
 
-```
-python -m simtrace2_pysniff [OPTIONS]
+- **Анализирующий сервер + PWA** (`simtrace-analyser-server`) — сохраняет
+  захваченный трафик в SQLite, декодирует его и отдаёт PWA
+  ([`frontend/`](frontend/)) вместе с HTTP API на одном origin. Три режима
+  захвата: GSMTAP-листенер, захват напрямую с оборудования SIMtrace2 или
+  отключённый захват (только просмотр существующих записей).
+- **Утилита захвата** (`simtrace2-pysniff`) — захватывает трафик
+  оборудования SIMtrace2 и выводит его в stdout, GSMTAP (Wireshark) или
+  PCAP-файлы. Это один из нескольких источников GSMTAP, которые принимает
+  анализатор (см. также
+  [sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)).
+- **PWA** ([`frontend/`](frontend/)) — окно трассировки с декодированными
+  APDU, SIM Toolkit, SMS и SCP80 OTA; сессии, импорт PCAP и трасс COMPRION,
+  интерфейс EN/RU.
 
-  --format, -f FORMAT       Формат вывода (по умолчанию: hex)
-                            hex       — обычный hex-дамп
-                            timestamp — строки TPDU с префиксом [ЧЧ:ММ:СС.мс]
-                            atr-time  — строки TPDU с префиксом [СССС.мс] от последнего ATR
-  --gsmtap HOST[:PORT]      Отправлять ATR/TPDU как GSMTAP по UDP (порт по умолчанию 4729)
-  --pcap FILE               Записывать перехваченные данные в PCAP для Wireshark
-  --output, -o FILE         Записывать hex-дамп в файл
-  --no-stdout               Не выводить hex-дамп в stdout
-  --vendor HEX              USB vendor ID (по умолчанию: 0x1d50)
-  --product HEX             USB product ID (по умолчанию: автоопределение)
+## Возможности
 
-Параметры восстановления:
-  --no-reconnect            Выходить при отключении USB вместо переподключения
-  --reconnect-delay-min SEC Минимальная задержка переподключения (по умолчанию: 1.0)
-  --reconnect-delay-max SEC Максимальная задержка переподключения (по умолчанию: 30.0)
-  --backoff-factor N        Множитель экспоненциальной задержки (по умолчанию: 1.5)
-  --inactivity-timeout SEC  Переподключаться после N секунд тишины (по умолчанию: выключено)
-```
+**Декодер APDU** (на стороне сервера, отображается в PWA):
 
-## Форматы вывода
+- Полное декодирование APDU — CLA по ISO 7816-4 / ETSI с **логическим
+  каналом 0-19** (стандартные каналы из b2-b1, расширенные 4-19 из b4-b1
+  по TS 102 221 §10.3), secure messaging и chaining команд, имена INS из
+  таблицы спецификаций, учёт SFI в P1/P2 для READ/UPDATE BINARY и команд
+  с записями; ответ MANAGE CHANNEL показывает назначенный картой канал
+- Статусные слова — полный набор ISO 7816-4 плюс специфичные для UICC
+  значения: `91XX` (ожидается proactive-команда), `62F1/F2/F3`,
+  `63F1/F2` (больше данных), `9300` (SAT busy), `9850`, `9862–64`
+- SIM Toolkit — SAT (GSM 11.14), CAT (TS 102 223) и USAT (TS 31.111):
+  proactive-команды с декодированными квалификаторами, TERMINAL RESPONSE,
+  ENVELOPE (Menu Selection, Call Control, SMS-PP download…); учитываются
+  известные несоответствия старых карт, нераспознанные TLV сохраняются
+- TERMINAL CAPABILITY (TS 102 221 §11.1.19) — питание терминала (класс
+  напряжения, максимальный ток, тактовая частота), расширенные логические
+  каналы, дополнительные интерфейсы (UICC-CLF) и возможности eUICC
+  (SGP.22/SGP.32)
+- SMS TPDU — SMS-DELIVER/SUBMIT, метки времени SCTS, информационные
+  элементы UDH
+- SCP80 OTA secured packets — биты SPI (шифрование, требование/режим PoR,
+  RC/CC/DS, счётчик), алгоритм KIc/KID + набор ключей, TAR, CNTR/PCNTR;
+  декодирование Response Packet (PoR) по GET RESPONSE; **опциональная
+  расшифровка на клиенте** зашифрованных пакетов — вставьте 3DES/AES-ключ
+  карты в панели деталей, чтобы увидеть настоящие CNTR и защищённые данные
+  приложения (ключ остаётся в браузере, только в памяти; зашифрованные
+  в эфире CNTR/PCNTR/RC — это шифротекст, и они так и помечены); защищённое
+  сообщение приложения декодируется как поток **C-APDU** (SELECT,
+  UPDATE BINARY, …) с полной разбивкой CLA/INS/P1/P2/Lc/Le — сразу для
+  открытого текста или после расшифровки для зашифрованных пакетов
+- Разбор ATR (пересчёт тактовой частоты, Fi/Di, битовая маска T,
+  безопасен для усечённых ATR) и FCP/FCI TLV; исторические байты
+  разбираются как COMPACT-TLV объекты UICC (TS 102 221 §6.3.1) — card
+  service data, **card capabilities** (ISO 7816-4 §8.1.1.2.7 таблица 88:
+  способы назначения и заявленное максимальное число логических каналов,
+  `8 or more` у карт с расширенными каналами) и завершающий индикатор
+  состояния (LCS/SW)
 
-- **`hex`** (по умолчанию): обычный hex-дамп — `ATR: 3b 9e ...`,
-  `TPDU: a0 a4 00 00 02 3f 00`
-- **`timestamp`**: строки TPDU с локальным временем —
-  `[14:32:05.123] TPDU: a0 a4 00 00 02 3f 00`
-- **`atr-time`**: строки TPDU с секундами от последнего ATR —
-  `[0001.234] TPDU: a0 a4 00 00 02 3f 00`
+**PWA SIMtrace Analyser** ([`frontend/`](frontend/)):
 
-Сообщения, не являющиеся TPDU (ATR, PPS, изменения состояния карты, Fi/Di),
-выводятся одинаково во всех форматах.
-
-- **GSMTAP**: сообщения ATR и APDU по UDP (порт 4729) в Wireshark
-- **PCAP**: сообщения ATR/TPDU как пакеты Ethernet/IP/UDP/GSMTAP,
-  открываются в Wireshark
-
-## Фоновый режим / демон
-
-SIGHUP автоматически игнорируется, когда stdin не является терминалом
-(т.е. при запуске в фоне или через канал). Сессии в терминале на переднем
-плане по-прежнему обрабатывают SIGHUP обычным образом.
-
-Для постоянной работы в фоне с выводом в файлы:
-
-```sh
-nohup ./sniff-start.sh --output /tmp/sniff.log &> /tmp/sniff-err.log &
-# или
-FORMAT=timestamp nohup python -m simtrace2_pysniff --output /tmp/sniff.log &> /tmp/sniff-err.log &
-```
-
-## Использование как библиотеки
-
-```python
-from simtrace2_pysniff import SniffSession
-
-session = SniffSession(inactivity_timeout=30.0)
-for msg in session.iter_messages():
-    print(f"{msg.type}: {msg.data.hex()}")
-```
-
-## Восстановление
-
-Утилита по умолчанию переживает сбросы оборудования, отключения кабеля
-и зависания прошивки — она переподключается с экспоненциальной задержкой
-(1с → 30с). Используйте `--inactivity-timeout`, чтобы также переподключаться
-при «тихих» зависаниях прошивки.
+- Окно трассировки с режимами «Карта»/«Список» — proactive,
+  TERMINAL RESPONSE, ENVELOPE и AUTH-команды выделяются в режиме карты
+- Сессии с прямыми ссылками (`#session=N`), импорт PCAP
+  (`.pcap/.pcapng/.cap`), импорт трасс COMPRION (текстовый экспорт
+  «ISO Protocol Layer» из Device Manager), поиск и **фильтр команд с
+  множественным выбором** — любые команды и/или готовые пресеты («Проактивные
+  сессии»: FETCH, TERMINAL PROFILE и все команды с ответом SW 91xx;
+  «Файловые операции»: SELECT,
+  READ/UPDATE BINARY и READ/UPDATE RECORD, вместе с GET RESPONSE, несущим
+  данные выбранной команды)
+- Устанавливаемая PWA, тёмная тема, интерфейс на английском/русском
 
 ## Связанные проекты