From 9112eafec044e7b8396b9eba2e228c287013aa8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=90=D0=BD=D1=82=D0=BE=D0=BD=20=D0=A2=D1=80=D0=BE=D1=88?=
 =?UTF-8?q?=D0=B8=D0=BD?= <i@atroshin.ru>
Date: Tue, 27 Oct 2026 23:37:58 +0300
Subject: [PATCH] README: subtitle, language switcher, related tools
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Give the H1 a one-line description ("a passive ISO 7816 sniffer" /
  "пассивный ISO 7816-сниффер").
- Replace the Russian file's top "English version" note with a symmetric
  language line under the title in both files (English | Русский /
  English | Русский).
- Add a "Related tools" / «Связанные инструменты» section before the
  license: SIMple, SIMtrace Analyser and this project, with a note that
  each is installed independently and links to the shared website and
  Telegram channel.

Docs only; no decoder change.
---
 README.md     | 20 ++++++++++++++++++--
 README_RUS.md | 21 ++++++++++++++++++---
 2 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 6bb3b5c..81bc2a5 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
-# sigrok_iso7816_stream
+# sigrok_iso7816_stream — a passive ISO 7816 sniffer
 
-📢 Project news and updates: [Website](https://atroshin.ru) · [Telegram channel](https://t.me/youeyeseesee)
+English | [Русский](README_RUS.md)
+
+📢 Project news and updates: [website](https://atroshin.ru) · [Telegram channel](https://t.me/youeyeseesee)
 
 Fork of [svenso/sigrok_iso7816](https://github.com/svenso/sigrok_iso7816) with
 **live GSMTAP UDP streaming**, making a cheap FX2 logic analyzer (Saleae clone)
@@ -465,6 +467,20 @@ Parity is **even** per TS 102 221 ("an even number of bits set to '1'
 including the parity bit"); frames failing the check are flagged as
 `CHKSUM ERROR` but still decoded.
 
+## Related tools
+
+SIMple, SIMtrace Analyser and sigrok_iso7816_stream are three standalone
+tools for working with SIM/UICC cards, published together on the same
+[website](https://atroshin.ru) and [news channel](https://t.me/youeyeseesee).
+Each one is fully independent — install only the tools you need:
+
+- **[SIMple](https://github.com/anttro/simple)** — a UICC workbench: APDU
+  construction, SCP80/SCP81 OTA, SIM Toolkit simulation and card profiling.
+- **[SIMtrace Analyser](https://github.com/anttro/simtrace-analyser)** — an
+  APDU trace analyser for GSMTAP-SIM captures.
+- **[sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)** —
+  a passive ISO 7816 sniffer built on a cheap FX2 logic analyser.
+
 ## License
 
 GPL-2.0+, same as upstream.
diff --git a/README_RUS.md b/README_RUS.md
index c6f6dd2..e4ff767 100644
--- a/README_RUS.md
+++ b/README_RUS.md
@@ -1,8 +1,8 @@
-> English version: [README.md](README.md)
+# sigrok_iso7816_stream — пассивный ISO 7816-сниффер
 
-# sigrok_iso7816_stream
+[English](README.md) | Русский
 
-📢 Новости и обновления проекта: [Сайт](https://atroshin.ru) · [Telegram-канал](https://t.me/youeyeseesee)
+📢 Новости и обновления проекта: [сайт](https://atroshin.ru) · [Telegram-канал](https://t.me/youeyeseesee)
 
 Форк [svenso/sigrok_iso7816](https://github.com/svenso/sigrok_iso7816) с
 **живым GSMTAP-UDP-стримингом**: дешёвый логический анализатор FX2 (клон
@@ -486,6 +486,21 @@ sigrok-cli -i <phone>.sr \
 '1', включая бит чётности»); кадры, не прошедшие проверку, помечаются
 `CHKSUM ERROR`, но всё равно декодируются.
 
+## Связанные инструменты
+
+SIMple, SIMtrace Analyser и sigrok_iso7816_stream — три автономных
+инструмента для работы с SIM/UICC-картами, представленные на одном
+[сайте](https://atroshin.ru) и в одном [Telegram-канале](https://t.me/youeyeseesee).
+Каждый полностью независим — устанавливайте только нужные вам:
+
+- **[SIMple](https://github.com/anttro/simple)** — мастерская для UICC/SIM:
+  конструкторы APDU, OTA SCP80/SCP81, симуляция SIM Toolkit и профилирование
+  карт.
+- **[SIMtrace Analyser](https://github.com/anttro/simtrace-analyser)** —
+  анализатор APDU-трассировок GSMTAP-SIM.
+- **[sigrok_iso7816_stream](https://github.com/anttro/sigrok_iso7816_stream)** —
+  пассивный ISO 7816-сниффер на дешёвом логическом анализаторе FX2.
+
 ## Лицензия
 
 GPL-2.0+, как и upstream.