Files
simtrace-analyser/.github/release-notes.md
T
catarrh e00a96b918
Release / release (push) Waiting to run
Release a Windows-friendly runtime zip (v2.7.12)
The releases carried the wheel and the sdist; the only zip was GitHub's source
archive of the whole repository (tests, CI, tools).  A Windows user just wants
to extract a folder and double-click start.bat.

- scripts/build_release_zip.py builds simtrace-analyser-<version>.zip with a
  single top-level directory: the two Python packages, the PWA runtime files
  (frontend/tests and package.json stay out), the four launchers, the udev
  rule, the READMEs and the screenshot.  The .bat entries are written with
  CRLF line endings (cmd.exe mishandles bare-LF labels/goto), the .sh files
  keep their executable bit; LICENSE is included automatically once the repo
  has one.
- tests/test_release_zip.py pins the archive shape, the exclusions, the sw.js
  PRECACHE drift (every precached asset must travel), the CRLF/LF line endings
  and start.sh's mode.
- the release workflow builds the zip, checks it carries start.bat and the
  PWA, uploads it with the run and attaches it to the release.
- READMEs (EN/RU) and the release-notes template offer the zip as the
  Windows-friendly option; version 2.7.12, PWA cache v94.

Verified: the built zip (34 entries, 658 KB compressed) extracted and started
on Linux serves the same index.html; 553 Python + 80 Node tests.
2026-10-21 00:17:06 +03:00

946 B

Install the wheel below — the PWA is bundled inside it:

pip install ./simtrace_analyser-*.whl
simtrace-analyser-server --capture gsmtap

The UI is then served at http://127.0.0.1:8081/. 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).

The source archive is the same tree a clone would have: unzip it and run ./start.sh (Linux/macOS) or start.bat (Windows). Direct SIMtrace2 capture on Linux additionally needs the attached 70-simtrace2-pysniff.rules udev rule.

Runtime zip (Windows-friendly, no installer) — simtrace-analyser-*.zip is the runtime tree only (packages, PWA, launchers, docs — no tests, no git): 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.