Repository navigation
v1.0.0-rc.1
VioLens is a free, MIT-licensed tool for inspecting HTTP and HTTPS traffic, built as a successor to Fiddler Classic. It runs on Windows, macOS and Linux. It's an independent project, not affiliated with Progress or Telerik.
This is the 1.0 release candidate. The features planned for 1.0 are in, and the proxy engine's public API is frozen. Please report anything that goes wrong in issues or on Discord.
Downloads
| Platform | File | Notes |
|---|---|---|
| Windows x64 | VioLens-Setup-1.0.0-rc.1.exe |
Installer, signed. SmartScreen may still warn while the publisher is new: choose More info > Run anyway. |
| Windows x64 | VioLensCapture-1.0.0-rc.1-win-x64.exe |
VioLens Capture: a single .exe someone non-technical can run, without installing, to record a .saz for you. |
| macOS (Apple silicon) | VioLens-1.0.0-rc.1-macos-arm64.dmg |
Signed with a Developer ID and notarized. |
| Linux x86-64 | VioLens-1.0.0-rc.1-x86_64.AppImage |
chmod +x it and run it. Trusting the certificate needs certutil (libnss3-tools or nss-tools). |
| Linux x86-64 | VioLens-1.0.0-rc.1-linux-x64.tar.gz |
The same app as a plain archive. |
| Windows x64 | Violens.ProxyHost-1.0.0-rc.1-win-x64.zip |
Only for developers embedding the engine in a .NET Framework app. |
Check the Linux files against SHA256SUMS-linux.txt with sha256sum -c SHA256SUMS-linux.txt.
The first time you click Start, VioLens asks to trust a root certificate named DO_NOT_TRUST_ViolensRoot.... That's what lets it read HTTPS on your computer. Tools > Remove Root Certificate takes it away again. SECURITY.md explains how the certificate and the listener are protected.
What's in it
- HTTP and HTTPS capture through a local proxy, including HTTP/2, WebSockets and gRPC trailers, and forwarding through your network's proxy (PAC, WPAD, Negotiate and NTLM).
- Inspectors for headers, raw, JSON, CBOR, MessagePack, Markdown, forms, images, hex and cookies. A timing waterfall, statistics, Compare Sessions and TextWizard.
- Breakpoints, AutoResponder rules, the Composer and Replay.
- QuickExec and
violens-exec, FiddlerScript (CustomRules.js), and compiled extensions. Fiddler Classic extensions can be ported from source with few changes. - Opens and saves SAZ, saves and imports HAR, and imports HTTP from
.pcapand.pcapngfiles.
The User Guide covers all of it.
Changes since 0.5.0-preview.1
- The proxy engine's public API is frozen for 1.0 and follows semantic versioning from here on. A few types used only by VioLens itself are now internal, and machine policy moved to
Violens.AppCore. - The README, the design docs and SECURITY.md are rewritten in plain language and describe the release candidate. Stale claims about breakpoints, QuickExec suggestions and selecting several sessions are corrected.
Known limitations
- macOS hasn't had a full hands-on test yet: certificate trust and removal, the system proxy and crash recovery are tested in CI, but not end to end on a real Mac.
- On Linux the certificate goes into Chrome's and Firefox's certificate databases, not the system store curl reads. The system proxy is set on GNOME and KDE Plasma only. x86-64 only.
- HTTP/2 has had real use on Windows. There's no HTTP/3 (browsers don't send it through a proxy) and no SOCKS upstream proxies.
- Compiled Fiddler Classic
.dllextensions need rebuilding from source. - Bodies are kept in memory, capped at 64 MB each.
The full list is in the README's Known limitations.