Repository navigation
Releases
v1.0.0-rc.3
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 third 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, and security problems privately (see SECURITY.md).
Downloads
| Platform | File | Notes |
|---|---|---|
| Windows x64 | VioLens-Setup-1.0.0-rc.3.exe |
Installer, signed. SmartScreen may still warn while the publisher is new: choose More info > Run anyway. |
| Windows x64 | VioLensCapture-1.0.0-rc.3-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.3-macos-arm64.dmg |
Signed with a Developer ID and notarized. |
| Linux x86-64 | VioLens-1.0.0-rc.3-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.3-linux-x64.tar.gz |
The same app as a plain archive. |
| Windows x64 | Violens.ProxyHost-1.0.0-rc.3-win-x64.zip |
Only for developers embedding the engine in a .NET Framework app. |
The engine is on NuGet as Violens.ProxyCore and, for .NET Framework apps, Violens.ProxyHost.Client.
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.
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 1.0.0-rc.2
Mostly security fixes, from two reviews before 1.0. SECURITY.md describes how VioLens protects you now.
- Your identity stays yours. VioLens signs in to your network's proxy as you, or sends your client certificate, only for programs running under your own account (on Windows and Linux), and never for other computers using it as their proxy.
- Asks before sending a proxy password in plain text, to a proxy that only offers Basic sign-in. Tools > Connections also warns while a client certificate would go to every server that asks.
- Other computers can reach less. With Allow remote computers to connect on, they can't reach this computer's localhost services or cloud metadata addresses, including through DNS rebinding.
- Safer with hostile input. Limits on headers, bodies, decompression, WebSocket messages, PAC scripts, SAZ imports and images, and HTTP/2 Rapid Reset protection. The browser preview removes redirects more thoroughly.
- The legacy extension host (optional, Windows) talks to VioLens over a pipe only your account can open.
- Firefox on macOS now trusts VioLens's root, so HTTPS sites in Firefox don't show a warning.
Known limitations
- macOS hasn't had a full hands-on test yet. CI checks the build's signature and that it launches, but certificate trust and removal, the system proxy and crash recovery haven't been tested 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, and only GNOME (on Ubuntu) has been tested by hand. 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.
The full list is in the README's Known limitations.
v1.0.0-rc.2
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 second 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.2.exe |
Installer, signed. SmartScreen may still warn while the publisher is new: choose More info > Run anyway. |
| Windows x64 | VioLensCapture-1.0.0-rc.2-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.2-macos-arm64.dmg |
Signed with a Developer ID and notarized. |
| Linux x86-64 | VioLens-1.0.0-rc.2-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.2-linux-x64.tar.gz |
The same app as a plain archive. |
| Windows x64 | Violens.ProxyHost-1.0.0-rc.2-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 1.0.0-rc.1
- The proxy engine is on NuGet for the first time:
Violens.ProxyCoreand, for .NET Framework apps,Violens.ProxyHost.Client. rc.1's packages didn't publish because of a bug in the release workflow. - Linux has had a hands-on test on Ubuntu (GNOME), and the docs say so. KDE Plasma is still to be tested.
Changes in 1.0.0-rc.1, 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. CI checks the build's signature and that it launches, but certificate trust and removal, the system proxy and crash recovery haven't been tested 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, and only GNOME (on Ubuntu) has been tested by hand. 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.
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.
v0.5.0-preview.1
Linux, VioLens Capture, new inspectors and machine policy - Linux: certificate trust in browsers' NSS databases, GNOME and KDE system proxy, an AppImage and a .tar.gz, and Linux in CI. - VioLens Capture: a one-window app, like FiddlerCap, for recording a .saz for a support team (Windows .exe). - New inspectors: Tree (JSON, CBOR, MessagePack), Markdown, and WebView with a script-free browser preview. - Machine-wide policy settings: lock settings or set defaults for everyone (Group Policy registry key, or policy.json). - Packet capture import (PCAP, PCAPNG), ported from Clearinet. - violens-exec: drive the running app from scripts. - SAZ: _index.htm, HTTP/2 pseudo-headers and session flags. - Smaller touches: column search and repeated-value highlighting, Customize Columns, an image viewer with zoom, cookie sizes, QuickExec suggestions, and imports off the UI thread.
v0.4.0-preview.1
Road to 1.0: HTTP/2 on by default, client certificates, skip decrypti…
v0.3.0-preview.1
HTTP/2 between browsers, VioLens and servers (preview, off by default)
v0.2.0-preview.4
VioLens 0.2.0-preview.4: macOS app is Developer ID signed and notariz…
v0.2.0-preview.3
VioLens 0.2.0-preview.3: fixes hung 1xx responses, leaked certificate…
v0.2.0-preview.2
VioLens 0.2.0-preview.2
Fixes
macOS: VioLens no longer freezes on the first click of Start. The “install the root certificate?” prompt now appears and works, and while the certificate is being installed (macOS may ask for your password) the window stays responsive.
Also
A short demo at the top of the README and on violens.dev.
New security policy: report security problems privately to security@violens.dev or through GitHub’s private reporting. Code of conduct reports go to conduct@violens.dev.
v0.2.0-preview.1
VioLens 0.2.0-preview.1: renamed from CLeARINET; ProxyCore and the pr…