Skip to content

Releases

v1.3.3 — /usr/bin symlink + AppArmor profile actually loads

Choose a tag to compare

@cstrat cstrat released this 25 Apr 03:49

v1.3.3 — stg-sase-traffic-generator works from the terminal; AppArmor profile loads reliably

Two follow-ups to v1.3.2 from real-world install testing.

Fixed

  • /usr/bin/stg-sase-traffic-generator symlink. electron-builder's deb target doesn't auto-create the /usr/bin shortcut when the productName contains spaces ("STG - SASE Traffic Generator"), so the README claim that you could stg-sase-traffic-generator from a terminal was wrong on every prior .deb. The post-install script now creates the symlink (and the post-remove script tears it down). The apps-menu launcher already worked via the .desktop file.
  • AppArmor profile attachment uses a glob. apparmor_parser's profile-attachment header rejects paths containing spaces even when quoted, so the profile installed by 1.3.2 didn't actually load on Ubuntu 24.04 where the binary lives at /opt/STG - SASE Traffic Generator/stg-sase-traffic-generator. The profile now attaches to /opt/*/stg-sase-traffic-generator, which matches our install layout without needing to quote anything. Verify with sudo aa-status | grep stg.

Install

Format arm64 x86-64
.deb (recommended) STG-1.3.3-arm64.deb STG-1.3.3-amd64.deb
.AppImage STG-1.3.3-arm64.AppImage STG-1.3.3-x86_64.AppImage
sudo apt install /tmp/STG-1.3.3-amd64.deb     # or _arm64.deb

(Move the .deb out of ~/Downloads first to silence the benign _apt: Permission denied notice — apt's privilege-drop user can't read $HOME. Install still works either way.)

Included (from 1.3.0–1.3.2)

  • AppArmor profile install/uninstall via dpkg postinst/postrm
  • --disable-dev-shm-usage Chromium switch for hardened VMs
  • Renderer CSP (script-src 'self', object-src 'none', base-uri 'none', frame-src *)
  • HTML escaping at every dynamic innerHTML sink
  • Config sanitiser on load + import (rejects __proto__, non-http URLs, out-of-range counts)

v1.3.2 — .deb works on a fresh Ubuntu 24.04 box (AppArmor profile + /dev/shm fallback)

Choose a tag to compare

@cstrat cstrat released this 24 Apr 23:22

v1.3.2 — .deb works on a fresh Ubuntu 24.04 box

Hotfix for the .deb-only failure on Ubuntu 24.04+, where the LIVE PREVIEW tiles were blank, the log scrolled through URLs that all errored with ERR_FAILED, and the system log showed /dev/shm: No such process. The AppImage and npm start paths were unaffected.

Root cause

Ubuntu 24.04 ships kernel.apparmor_restrict_unprivileged_userns=1, which blocks unconfined binaries under /opt/ from creating user namespaces. Chromium needs user namespaces to spawn its <webview> guest renderers (even with --no-sandbox). The AppImage already has a system-shipped allowlist entry, which is why launch.sh worked while the .deb didn't.

Fixed

  • AppArmor profile installed by the .deb. A dpkg post-install script writes /etc/apparmor.d/stg-sase-traffic-generator granting userns, for the STG binary path and reloads AppArmor. The post-remove script tears it back down on uninstall. On distros without AppArmor (older Debian, Raspbian, …) the install step is a silent no-op.
  • --disable-dev-shm-usage added at startup in main.js. Belt-and-braces: on hardened VMs (and inside many container/VM images) /dev/shm is mounted with restrictive permissions or sized too small for Chromium's per-renderer shared-memory segments, so Chromium falls back to /tmp instead. Slightly slower than tmpfs, but reliable.

Install

Format arm64 x86-64
.deb (recommended) STG-1.3.2-arm64.deb STG-1.3.2-amd64.deb
.AppImage STG-1.3.2-arm64.AppImage STG-1.3.2-x86_64.AppImage
sudo apt install ./STG-1.3.2-amd64.deb     # or _arm64.deb

apt upgrades in place over 1.3.x / 1.2.x. The post-install script runs automatically on install and uninstall.

Included (from 1.3.0–1.3.1)

  • Renderer CSP (script-src 'self', object-src 'none', base-uri 'none', frame-src *)
  • HTML escaping at every dynamic innerHTML sink (logs, in-app report, exported HTML report)
  • Config sanitiser on load + import (rejects __proto__, non-http URLs, out-of-range counts)

v1.3.1 — Loosen frame-src so Live Preview tiles load

Choose a tag to compare

@cstrat cstrat released this 24 Apr 14:12

v1.3.1 — Loosen frame-src so Live Preview tiles always load

Hotfix for v1.3.0. The renderer CSP introduced in 1.3.0 set frame-src https: http:, which empirically prevented <webview> tiles from loading on some deployed environments — tiles stayed blank while the log kept scrolling through URLs whose navigations were silently refused.

Fixed

  • frame-src widened to *. The preview tiles are already isolated in the persist:stg-preview session where downloads, permission prompts, and popups are denied in the main process — the frame-src restriction was cosmetic, not load-bearing, and the rest of the CSP (script-src 'self', object-src 'none', base-uri 'none') still defuses the XSS sinks that 1.3.0 also escaped.

Install

Format arm64 x86-64
.deb (recommended) STG-1.3.1-arm64.deb STG-1.3.1-amd64.deb
.AppImage STG-1.3.1-arm64.AppImage STG-1.3.1-x86_64.AppImage
sudo apt install ./STG-1.3.1-amd64.deb     # or _arm64.deb

apt upgrades in place over 1.3.0 / 1.2.x.

Included (from 1.3.0)

  • Renderer CSP (script-src 'self', object-src 'none', base-uri 'none')
  • HTML escaping at every dynamic innerHTML sink
  • Config sanitiser on load + import (rejects __proto__, non-http URLs, out-of-range counts)

v1.3.0 — Security hardening (CSP, HTML escaping, config sanitiser)

Choose a tag to compare

@cstrat cstrat released this 24 Apr 06:20

v1.3.0 — Security hardening

Follow-up to a full security review of the renderer and main process. No user-visible behaviour change; the app runs exactly as before.

Added

  • Content Security Policy on the renderer: script-src 'self', object-src 'none', base-uri 'none'. Google Fonts CSS and http(s) preview tiles are still allowed.
  • HTML escaping at every dynamic innerHTML sink — live log rows, attack mini-log, in-app report modal, exported HTML report, stats cards, URL editor headers, block-signature tags. User-configured URLs, HTTP status text from origins, and imported-config values are now rendered as text, not HTML.
  • Config sanitiser (mergeSavedConfig) used by both persisted-config load and IMPORT JSON. Whitelisted keys with expected types only; drops __proto__ / constructor / prototype keys; rejects non-http(s) URL entries; clamps counts (≤64 block signatures, ≤256 ports, ≤300 s timeout, ≤10 crawl depth, ≤600 s stream hold); validates port-scan target against [a-zA-Z0-9.\-:_]+.

Install

Format arm64 x86-64
.deb (recommended) STG-1.3.0-arm64.deb STG-1.3.0-amd64.deb
.AppImage STG-1.3.0-arm64.AppImage STG-1.3.0-x86_64.AppImage
sudo apt install ./STG-1.3.0-amd64.deb     # or _arm64.deb

apt upgrades in place over 1.2.x.

Included (from earlier)

  • Launcher picks the right AppImage architecture — v1.2.7
  • Full-height CFG / URL SETTINGS buttons matching card heights — v1.2.6
  • Stats bar uses CSS Grid — v1.2.5
  • .deb package; arm64 + x86-64 builds — v1.2.3
  • Crawl stops on block / challenge — v1.2.2
  • Sandbox disabled for AppImage on Ubuntu 24+ — v1.2.1
  • LIVE PREVIEW tiles, unmuted video, crawl logging, HTTP-only speed, download / popup suppression — v1.2.0

v1.2.7 — Launcher picks the right architecture

Choose a tag to compare

@cstrat cstrat released this 24 Apr 05:28

v1.2.7 — Launcher picks the right architecture

Quick fix to launch.sh — the previous launcher just grabbed the first *.AppImage it found, which on a multi-arch dist/ folder could hand an x86-64 binary to an arm64 VM and get shell errors like ELFAI: not found / Unterminated quoted string.

Fixed

  • launch.sh now matches uname -m and picks -arm64.AppImage on arm64 hosts, -x86_64.AppImage on x86-64 hosts, falling back to any .AppImage if nothing matches.

Install

Format arm64 x86-64
.deb (recommended) STG-1.2.7-arm64.deb STG-1.2.7-amd64.deb
.AppImage STG-1.2.7-arm64.AppImage STG-1.2.7-x86_64.AppImage
sudo apt install ./STG-1.2.7-amd64.deb     # or _arm64.deb

apt upgrades in place over 1.2.6.

Included (from earlier)

  • Full-height CFG / URL SETTINGS buttons matching card heights — v1.2.6
  • Stats bar uses CSS Grid — v1.2.5
  • .deb package; arm64 + x86-64 builds — v1.2.3
  • Crawl stops on block / challenge — v1.2.2
  • Sandbox disabled for AppImage on Ubuntu 24+ — v1.2.1
  • LIVE PREVIEW tiles, unmuted video, crawl logging, HTTP-only speed, download / popup suppression — v1.2.0

v1.2.6 — Full-height CFG / URL SETTINGS buttons

Choose a tag to compare

@cstrat cstrat released this 24 Apr 04:36

v1.2.6 — Full-height CFG / URL SETTINGS buttons

Third and final attempt at the stats-bar layout. The last two releases chased a horizontal drift that wasn't the real problem — the buttons were short (24 px) while the category-card strip is 172 px tall, leaving a big dark void beneath them. Now the buttons fill their grid cells vertically, matching the card height, and the TOTALS card is back to its normal layout.

Fixed

  • CONFIGURATION and URL SETTINGS buttons now fill the full stats-bar height. Icon + label stack vertically and centre inside each button. No more empty space beneath them.
  • TOTALS card reverts to a normal card with its title at the top (was previously hidden + heading inside body to accommodate the short buttons — that workaround is no longer needed).

Verified before release by rendering the layout to a PNG via an off-screen Electron window and eyeballing it — this is now wired up as screenshot-layout.js for future sanity checks.

Install

Format arm64 x86-64
.deb STG-1.2.6-arm64.deb STG-1.2.6-amd64.deb
.AppImage STG-1.2.6-arm64.AppImage STG-1.2.6-x86_64.AppImage
sudo apt install ./STG-1.2.6-amd64.deb     # or _arm64.deb

apt upgrades in place over 1.2.5.

Included (from earlier)

  • Stats bar uses CSS Grid for rock-solid column widths — v1.2.5
  • .deb package as primary Linux install format — v1.2.3
  • arm64 + x86-64 Linux builds — v1.2.3
  • Crawl stops on block / challenge — v1.2.2
  • Sandbox disabled for AppImage on Ubuntu 24+ — v1.2.1
  • LIVE PREVIEW webview tiles, unmuted video autoplay, crawl click-through logging, HTTP-only speed, download / popup / permission suppression — v1.2.0

v1.2.5 — CFG / URL SETTINGS pinned to right edge (for real)

Choose a tag to compare

@cstrat cstrat released this 24 Apr 04:26

v1.2.5 — CFG / URL SETTINGS really pinned to the right now

Second attempt at the button drift (1.2.4 didn't land). The stats bar now uses CSS Grid with explicit 1fr 150px 150px column tracks so the two strip buttons are placed by the grid itself and cannot drift regardless of viewport, DPI, or flex edge cases.

Fixed

  • CONFIGURATION and URL SETTINGS buttons flush to the far right. Previously the stats bar was a display: flex row where the buttons were expected to sit at the right because the cards region had flex: 1. That broke in some layout situations, leaving a visible gap. Replaced with display: grid; grid-template-columns: minmax(0, 1fr) 150px 150px — the grid tracks are authoritative, no margin math involved.

Install

Format arm64 x86-64
.deb STG-1.2.5-arm64.deb STG-1.2.5-amd64.deb
.AppImage STG-1.2.5-arm64.AppImage STG-1.2.5-x86_64.AppImage
sudo apt install ./STG-1.2.5-amd64.deb     # or _arm64.deb

apt upgrades the installed package in place; your URL lists and stats survive.

Included (from v1.2.3)

  • .deb package — native Debian/Ubuntu install, no launcher needed.
  • arm64 and x86-64 builds.

Included (from earlier)

  • Crawl stops on block / challenge — v1.2.2
  • Sandbox disabled for AppImage on Ubuntu 24+ — v1.2.1
  • LIVE PREVIEW webview tiles, video autoplay with sound, crawl click-through logging, HTTP-only speed, download / popup / permission suppression — v1.2.0

v1.2.4 — CFG / URL SETTINGS pinned to right edge

Choose a tag to compare

@cstrat cstrat released this 24 Apr 03:59

v1.2.4 — CFG / URL SETTINGS pinned to right edge

Quick layout fix on top of 1.2.3.

Fixed

  • CONFIGURATION and URL SETTINGS buttons no longer drift inward on wide viewports. The stats bar now uses flex: 1 1 0% on its stats-cards region and margin-left: auto on the first strip button, so the two yellow buttons stay pinned to the far right of the stats bar regardless of viewport width, DPI scaling, or window-manager quirks.

Install

Pick the package for your VM architecture.

Format arm64 x86-64
.deb (Debian/Ubuntu — recommended) STG-1.2.4-arm64.deb STG-1.2.4-amd64.deb
.AppImage (other Linux) STG-1.2.4-arm64.AppImage STG-1.2.4-x86_64.AppImage

Debian / Ubuntu:

sudo apt install ./STG-1.2.4-amd64.deb     # or -arm64.deb

Other Linux:

chmod +x STG-1.2.4-x86_64.AppImage
./STG-1.2.4-x86_64.AppImage

Included (from v1.2.3)

  • .deb package shipped as the primary Linux install format — no more launch.sh needed.
  • Both arm64 and x86-64 published.

Included (from earlier)

  • Crawl stops on block / challenge (no follow-through into SASE block pages) — v1.2.2
  • Sandbox disabled for AppImage on Ubuntu 24+ — v1.2.1
  • LIVE PREVIEW webview tiles, video autoplay with sound, crawl click-through logging, parallel immediate start, HTTP-only speed toggle, download / popup / permission prompt suppression — v1.2.0

v1.2.3 — .deb package for Debian/Ubuntu (arm64 + x86-64)

Choose a tag to compare

@cstrat cstrat released this 24 Apr 03:48

v1.2.3 — .deb package (single-file install for Ubuntu/Debian VMs)

Primary distribution format is now a native .deb, no launcher script needed. The AppImage is still published for non-apt distros.

Install

Pick the package for your VM architecture.

Format arm64 x86-64
.deb (Debian/Ubuntu — recommended) STG-1.2.3-arm64.deb STG-1.2.3-amd64.deb
.AppImage (other Linux) STG-1.2.3-arm64.AppImage STG-1.2.3-x86_64.AppImage

Debian / Ubuntu:

sudo apt install ./STG-1.2.3-amd64.deb     # or -arm64.deb

Appears in the app menu under Network with the STG icon, runs as stg-sase-traffic-generator. Uninstall with sudo apt remove stg-sase-traffic-generator.

Other Linux:

chmod +x STG-1.2.3-x86_64.AppImage
./STG-1.2.3-x86_64.AppImage

No more launch.sh needed either way — Chromium sandbox is disabled inside the app, and the .deb pulls libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils libatspi2.0-0 libuuid1 libsecret-1-0 automatically.

Included (from v1.2.2)

  • Crawl stops on block / challenge — no follow-through into SASE block-page links or Cloudflare challenge anchors.

Included (from v1.2.1)

  • Launch fix for modern Linux — Chromium sandbox disabled at startup so extract-and-run on Ubuntu 24+ works out of the box.

Included (from v1.2.0)

  • LIVE PREVIEW tiles — 3×2 <webview> grid you can toggle; the tile IS the request so bytes/audio aren't duplicated.
  • Video streams actually play — per-URL STREAM flag on the Video tab holds the webview open for 15 s (YouTube / Vimeo / Twitch / Kick seeded).
  • Crawl click-throughs logged — BROWSER mode follows crawlDepth − 1 random on-page links per request; each hop is its own log row marked ↪ crawl #N.
  • Parallel immediate start — every enabled category fires its first request within 250 ms of clicking START.
  • HTTP-only speed — BROWSER/STREAM are paced by their own work.
  • Safety — downloads cancelled before save dialog, permission prompts denied, window.open blocked, crawl skips file-extension links.
  • UX polish — consistent topbar button sizing, yellow CFG / URL SETTINGS, clickable stats-card titles, one-row report.

Known

  • Linux arm64 and x86-64 both published in this release.
  • macOS builds require an Apple Silicon Mac — run npm run build:mac-arm64 on the Mac itself.

v1.2.2 — Crawl stops on block / challenge

Choose a tag to compare

@cstrat cstrat released this 24 Apr 03:08

v1.2.2 — Crawl stops on block / challenge

Patch release on top of 1.2.1.

Fixed

  • BROWSER-mode crawl now stops on block / challenge. Previously, if the initial page was served a SASE block page (or a Cloudflare challenge), the crawl loop would still collect anchor tags from that page and follow them — producing log rows for links from the block page itself rather than the target site. The crawl is now skipped entirely when the initial page isn't classified OK, and a crawl hop that lands on a block / challenge page breaks the loop immediately (after its own log event is recorded).

Included (from v1.2.1)

  • Launch fix for modern Linux. Chromium sandbox disabled at startup so the AppImage runs cleanly on Ubuntu 24+ where chrome-sandbox can't be made setuid root inside APPIMAGE_EXTRACT_AND_RUN.

Included (from v1.2.0)

  • LIVE PREVIEW tiles — 3×2 grid of <webview> tiles; the tile IS the request so bytes/audio aren't duplicated.
  • Video streaming actually plays — per-URL STREAM flag on the Video tab holds the webview open for 15 s (YouTube / Vimeo / Twitch / Kick seeded).
  • Crawl click-throughs logged — BROWSER mode follows crawlDepth − 1 random on-page links per request; each hop is its own log row marked ↪ crawl #N with its own byte delta.
  • Parallel immediate start — every enabled category fires its first request within 250 ms of clicking START.
  • Speed toggle only affects HTTP — BROWSER/STREAM naturally paced by their own work.
  • Safety — downloads cancelled before the save dialog, permission prompts denied, window.open blocked, crawl skips file-extension links.
  • UX polish — consistent topbar button sizing, yellow CFG / URL SETTINGS buttons, stats-card titles toggle the category, six-category report on one row, short AppImage name (STG-<version>-<arch>.AppImage).

Install (Linux)

chmod +x STG-1.2.2-arm64.AppImage launch.sh
./launch.sh

launch.sh handles libz.so, FUSE-2 fallback, --no-sandbox, and installs the desktop / icon integration on first run.

Known

  • Release ships Linux arm64 only. Build x64 with npm run build:linux-x64 on an x64 host, macOS with npm run build:mac-arm64 on an Apple Silicon Mac.