Repository navigation
Releases
v1.3.3 — /usr/bin symlink + AppArmor profile actually loads
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-generatorsymlink. electron-builder's deb target doesn't auto-create the/usr/binshortcut when theproductNamecontains spaces ("STG - SASE Traffic Generator"), so the README claim that you couldstg-sase-traffic-generatorfrom 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.desktopfile.- 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 withsudo 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
dpkgpostinst/postrm --disable-dev-shm-usageChromium switch for hardened VMs- Renderer CSP (
script-src 'self',object-src 'none',base-uri 'none',frame-src *) - HTML escaping at every dynamic
innerHTMLsink - 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)
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
dpkgpost-install script writes/etc/apparmor.d/stg-sase-traffic-generatorgrantinguserns,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-usageadded at startup inmain.js. Belt-and-braces: on hardened VMs (and inside many container/VM images)/dev/shmis mounted with restrictive permissions or sized too small for Chromium's per-renderer shared-memory segments, so Chromium falls back to/tmpinstead. 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.debapt 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
innerHTMLsink (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
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-srcwidened to*. The preview tiles are already isolated in thepersist:stg-previewsession 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.debapt 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
innerHTMLsink - Config sanitiser on load + import (rejects
__proto__, non-http URLs, out-of-range counts)
v1.3.0 — Security hardening (CSP, HTML escaping, config sanitiser)
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
innerHTMLsink — 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/prototypekeys; 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.debapt 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
.debpackage; 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
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.shnow matchesuname -mand picks-arm64.AppImageon arm64 hosts,-x86_64.AppImageon x86-64 hosts, falling back to any.AppImageif 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.debapt 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
.debpackage; 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
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.debapt upgrades in place over 1.2.5.
Included (from earlier)
- Stats bar uses CSS Grid for rock-solid column widths — v1.2.5
.debpackage 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)
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: flexrow where the buttons were expected to sit at the right because the cards region hadflex: 1. That broke in some layout situations, leaving a visible gap. Replaced withdisplay: 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.debapt upgrades the installed package in place; your URL lists and stats survive.
Included (from v1.2.3)
.debpackage — 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
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 andmargin-left: autoon 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.debOther Linux:
chmod +x STG-1.2.4-x86_64.AppImage
./STG-1.2.4-x86_64.AppImageIncluded (from v1.2.3)
.debpackage shipped as the primary Linux install format — no morelaunch.shneeded.- 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)
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.debAppears 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.AppImageNo 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 − 1random 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.openblocked, 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-arm64on the Mac itself.
v1.2.2 — Crawl stops on block / challenge
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-sandboxcan't be made setuid root insideAPPIMAGE_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 − 1random on-page links per request; each hop is its own log row marked↪ crawl #Nwith 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.openblocked, 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.shlaunch.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-x64on an x64 host, macOS withnpm run build:mac-arm64on an Apple Silicon Mac.