From 9a661f5ab23e4db4f86aae8fcd7c17ff8be1d9e4 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?= Date: Tue, 27 Oct 2026 23:38:39 +0300 Subject: [PATCH] README: expand the title, move the news line up, update Related tools The heading now names the tool and what it analyses instead of just the product name, and the news/website line sits right under the language switch so it is visible before the description. The Related section became "Related tools" with the same family block the sibling projects use (SIMple, SIMtrace Analyser, sigrok_iso7816_stream on one website and news channel), and simtrace2 is mentioned as the upstream hardware/firmware the bundled capture utility sniffs from. One wording tweak: the capture-liveness paragraph states the current behaviour ("does not pollute") instead of describing it as a change ("no longer pollutes"). Both languages; docs only, 557 Python + 80 Node tests. --- README.md | 28 +++++++++++++++++++--------- README_RUS.md | 29 +++++++++++++++++++---------- 2 files changed, 38 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 61f4114..9930d48 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,9 @@ -# SIMtrace Analyser +# SIMtrace Analyser — an APDU trace analyser for GSMTAP-SIM captures English | [Русский](README_RUS.md) +📢 Project news and updates: [website](https://atroshin.ru) · [Telegram channel](https://t.me/youeyeseesee) + APDU trace analyser for the GSMTAP-SIM format — captures SIM/UICC communication from a UDP GSMTAP stream (or imports PCAP/PCAPNG files), decodes it, and serves an installable web app for browsing. The repository @@ -9,8 +11,6 @@ also bundles **simtrace2-pysniff**, a Python replacement for `simtrace2-sniff` that captures from Osmocom SIMtrace2 hardware and can feed GSMTAP into this analyser. -📢 Project news and updates: [atroshin.ru](https://atroshin.ru) | [Telegram channel](https://t.me/youeyeseesee) - ![SIMtrace Analyser UI](frontend.png) ## Prerequisites @@ -171,7 +171,7 @@ datagram is dropped and counted (`dropped`) rather than silently killing the capture; a `tpdu` packet that is not APDU-shaped at all (shorter than the header, the invalid CLA `FF` or an ISO-reserved class) is skipped and counted (`skipped`) — a character-level or mis-sampled -stream no longer pollutes the decode. The heartbeat interval defaults to 60 s and is +stream does not pollute the decode. The heartbeat interval defaults to 60 s and is tunable via `--log-interval SECONDS`. The GSMTAP listener also accepts the **sigrok-iso7816-stream** decoder @@ -553,13 +553,23 @@ prompt). - Installable **PWA** (progressive web app: installs to the desktop or home screen and works offline), dark theme, English/Russian UI -## Related +## Related tools -- **[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2)** — the upstream - SIMtrace2 hardware/firmware project that the capture utility sniffs from. +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)** — - FX2LP-based passive ISO 7816 sniffer that emits the same GSMTAP-SIM stream - on UDP 4729 (accepted by this project's GSMTAP listener). + a passive ISO 7816 sniffer built on a cheap FX2 logic analyser. + +The bundled capture utility also sniffs from the upstream +[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2) hardware/firmware +project. ## License diff --git a/README_RUS.md b/README_RUS.md index a861494..9eb4082 100644 --- a/README_RUS.md +++ b/README_RUS.md @@ -1,7 +1,9 @@ -# SIMtrace Analyser +# SIMtrace Analyser — анализатор APDU-трассировок GSMTAP-SIM [English](README.md) | Русский +📢 Новости и обновления проекта: [сайт](https://atroshin.ru) · [Telegram-канал](https://t.me/youeyeseesee) + Анализатор APDU-трассировок в формате GSMTAP-SIM — захватывает обмен с SIM/UICC из UDP-потока GSMTAP (или импортирует файлы PCAP/PCAPNG), декодирует его и отдаёт устанавливаемое веб-приложение для просмотра. @@ -9,8 +11,6 @@ SIM/UICC из UDP-потока GSMTAP (или импортирует файлы на Python, которая захватывает трафик с оборудования Osmocom SIMtrace2 и может передавать GSMTAP этому анализатору. -📢 Новости и обновления проекта: [atroshin.ru](https://atroshin.ru) | [Telegram-канал](https://t.me/youeyeseesee) - ![Интерфейс SIMtrace Analyser](frontend.png) ## Требования @@ -174,7 +174,7 @@ heartbeat `Capture alive: session=N messages=M bytes=B dropped=D skipped=S` убивают захват; `tpdu`-пакет, вовсе не похожий на APDU (короче заголовка, недопустимый CLA `FF` или зарезервированный ISO класс `001x`), пропускается и считается (`skipped`) — посимвольный или миссемплированный -поток больше не засоряет декодирование. Интервал heartbeat по умолчанию +поток не засоряет декодирование. Интервал heartbeat по умолчанию 60 с, настраивается через `--log-interval SECONDS`. GSMTAP-листенер также принимает декодер **sigrok-iso7816-stream** @@ -568,14 +568,23 @@ Python 3 должен быть в `PATH` (проверьте `python --version` - **PWA** (progressive web app): устанавливается на рабочий стол или домашний экран и работает офлайн; тёмная тема, интерфейс на английском/русском -## Связанные проекты +## Связанные инструменты -- **[simtrace2](https://gitea.osmocom.org/sim-card/simtrace2)** — вышестоящий - проект оборудования/прошивки SIMtrace2, с которого утилита захвата - снимает трафик. +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 сниффер на базе FX2LP, выдающий такой же поток - GSMTAP-SIM на UDP 4729 (принимается GSMTAP-листенером этого проекта). + пассивный ISO 7816-сниффер на дешёвом логическом анализаторе FX2. + +Встроенная утилита захвата также снимает трафик с вышестоящего проекта +оборудования/прошивки [simtrace2](https://gitea.osmocom.org/sim-card/simtrace2). ## Лицензия