Skip to content →

Version History

Version 4.6.6

25 March 2024

Backported proxying fixes from 5.0, including:

  • HTTP 2 bug fix for hung streams when a stream is reset
  • Don’t reuse a remote SSL connection if the hostname has changed even if the IP address remains the same (not yet released in 5.0)

Version 5.0b13

24 January 2024

  • Windows UI improvements including dark mode support by adopting FlatLaf
  • Various UI improvements
  • Bug fixes
    • Recover from "Timer already cancelled" error

Version 5.0b12

16 November 2023

  • SSL: automatically regenerate an expired Charles root certificate
  • Support for trusting SSL certificates on iOS 17 Simulator
  • Improvements to new .chlz session format
  • Support image viewer on request bodies
  • Tool settings can now be edited when the tool is disabled
  • Many improvements under the hood, including a new configuration serialization approach
  • Support Undo and Redo in text fields
  • macOS: fix file chooser list view layout

Version 4.6.5

18 October 2023

  • Support for trusting SSL certificates on iOS 17 Simulator

Version 5.0b11

7 July 2023

  • New saved session format .chlz
  • Improved performance pretty-printing HTML, CSS and JavaScript
  • Improved performance for text rendering
  • Split out encrypted hosts in the structure tree
  • Sequence table improvements, including improved sort indicators
  • Bug fixes

Version 5.0b10

12 June 2023

  • Fix checkbox cells in tables

Version 5.0b9

11 June 2023

  • UI improvements to tables including improved auto-sizing of columns

Bug fixes:

  • HTTP 2 bug fix for hung streams when a stream is reset
  • DNS Spoofing no longer requires valid source names (regression from 5.0b7)

Version 5.0b8

11 April 2023

  • Early dark mode support for Windows and Linux
  • UI improvements to tabs and Windows layouts

Version 5.0b7

9 April 2023

First public beta of Charles 5

  • Overhauled UI and look & feel with a focus on moden platform conventions and usability
    • Filtering in lists in dialogs
    • Updated iconography , improved dark mode, and more to come.
  • Support for Apple Silicon and Windows on ARM
  • Java 17 under the hood
  • More to be added and announced

Version 4.6.4

4 April 2023

Bug fixes

  • Crash on macOS in file dialogs

Windows code-signing certificate updated.

Version 4.6.3

26 September 2022

Bug fixes

  • Java 11.0.17 update
  • Fix repeat/compose failure in tall sequence views
  • Fix error when filtering by custom columns
  • Fix internal Charles services when using external proxies
  • GitHub OAuth token improvements
  • HAR: support response._error field

Version 4.6.2

6 July 2021

Bug fixes

  • Java 11.0.11
  • CLI improvements
  • Bearer authentication display improved
  • Copy cURL Request: quotes fixed for Windows
  • Fix NTLM authentication over H2
  • Fix DNS Spoofing for SSL to domain names that don't actually exist
  • Fix bug where some requests were incorrectly marked as mapped
  • macOS disabled text colours fixed
  • macOS: Improve "Install Charles Root Certificate in Java VMs" for new locations
  • macOS: Update "Install Charles Root Certificate in iOS Simulators" for new locations and database format

Version 4.6.1

15 November 2020

Fixes Dark Mode support on macOS.

Version 4.6

7 November 2020

New features and stability improvements

  • External DNS Resolver option (for overriding the system DNS with your own external DNS resolver)
  • Fix new SSL CA certificates to be compatible with iOS and macOS changes
  • Stability improvements on macOS, particularly around multi-monitor setups
  • Fix Install Charles Root Certificate in Java VMs option for Java 11
  • Improve display of hosts using TLS when a connection is made via IP rather than name

Version 4.5.6

15 January 2020

Bug fixes and fixed security vulnerability.

  • Custom SSL server certificate imports fixed
  • macOS: Security vulnerability fixed in Charles's system proxy settings helper tool (ProxyHelper)
    • An unauthorised application or user could communicate with Charles's ProxyHelper application to change your system proxy settings.
    • Thanks to Noah Tran and Csaba Fitzl for reporting this vulnerabilty, and to Christian at Obective Development for his great writeup of the general vulnerability.

Version 4.5.5

5 December 2019

Bug fixes and minor improvements.

  • Custom SSL server, client and root certificate imports fixed
  • View As and Viewer Mappings now support URL Encoded and Multipart options

Version 4.5.4

4 November 2019

Fixes an error on launch on macOS.

Version 4.5.2

3 November 2019

Bug fixes and minor improvements.

  • Linux
    • Improve font rendering on Linux Hi DPI
  • Windows
    • Code-signing certificate updated
  • macOS
    • Resolve hangs on first launch
  • Add an option to reset the Charles SSL CA in the SSL Proxying Help menu
  • Fix memory leak

Version 4.5.1

10 October 2019

Bug fixes

Version 4.5

8 October 2019

  • Update to JDK 11 on all platforms
  • Highlight Rules; configure rules to automatically highlight matching requests
  • Add filter to Sequence view
  • Customise the fields shown in the Sequence view (including show the value of specific headers)
  • Improvements to reporting of TLS errors
  • No Caching headers fixed for HTTP 2.0
  • SSL Proxying
    • Add an Exclude list, so you can now exclude hosts that may be matched by wildcards
    • Activate / deactivate SSL Proxying using menu option or toolbar button
    • Import your own server certificates in SSL Proxying settings (this lets you import real certificates from servers you control instead of using a Charles-generated certificate)
  • Compose
    • Add images to multipart POSTs
  • macOS
    • Catalina support (new proxy management approach uses Helper Tool)
    • Dark mode

Version 4.2.8

28 February 2019

Bug fixes

  • Fix mangling of requests with schemes starting with M

Version 4.2.7

14 September 2018

Bug fixes and minor improvements

  • Remove support for anonymous Gist creation
  • HAR import will import HARs with missing values
  • Charles will now passthrough response bodies if the server sends them, even if they aren't valid (such as in 204 responses).
  • Improvements and fixes to behaviour with external proxies, including:
    • Fixes to port forwarding
    • Fixes to IPv6 address handling
    • Fixes when acting as a SOCKS proxy
    • Fixes to tunnelled HTTPS requests
  • Raw request editor removed as it could often result in invalid requests (and there are other editors that don't)
  • macOS: Find dialog no longer uses 100% CPU
  • Fixes to saving CONNECT requests
  • Headers editor can now create an empty set of headers
  • Fix error in PCAP import with missing protocol version
  • Map Local now supports local file paths starting with ~/
  • Fix Chrome 66 certificate trust issues with Map Remote

Version 4.2.6

22 June 2018

Bug fixes and minor improvements

  • HTTP 2 handling faults corrected
  • Date parsing fixed from Charles on iOS when used in London
  • Memory usage with SOCKS proxying improved
  • Save Transactions progress dialog fixed
  • Fix UI deadlock

Version 4.2.5

7 April 2018

Security fixes, major bug fixes and minor improvements.


  • Fixes a local privilege escalation vulnerability on macOS.


  • Hostname filter added to Structure view
  • Websockets: added right-click to export all messages as individual files
  • SSL Proxying support extended to Port Forwarding and non-HTTP SOCKS traffic
  • Charles no longer prevents sleep on macOS
  • SOCKS TLS connections now get a host name instead of just an IP address
  • Many internal improvements to the minutiae of proxying, including reduced usage of chunked responses when they weren't warranted, and improved Expect/Continue behaviour.

Bug fixes:

  • Map Remote and Map Local bugs fixed that prevents correct https -> http and http -> https mappings
  • Authentication viewers fixes to display of bearer tokens and similar
  • HTTP 2 over Reverse Proxy improved
  • cURL-compatible URL creation fixed for HTTP 2
  • Windows: some native code loading issues fixed, which prevented Charles from automatically controlling the Windows Proxy

Version 3.12.3

11 March 2018

Security fixes and minor bug fixes.


  • Fixes a local privilege escalation vulnerability on macOS.

Version 4.2.1

22 November 2017

Important bug fixes

  • Fix Map Remote's preserving of host headers for HTTP 2
  • Fix CONNECT tunnelling of unsupported protocols
  • Fix importing of unexpectedly formed HAR content from Chrome
  • macOS: Fix native code crashes

Version 3.12.2

22 November 2017

Important bug fixes

Version 3.12.1

1 October 2017


  • Updated to the latest Java 1.8 release


  • Updated to the latest Java 1.8 release
  • macOS High Sierra support
  • Fixed missing menu bar on macOS High Sierra on non-English locales
  • Menu bar icon now reverses correctly on dark menu bars

Version 4.2

30 September 2017

Major new features:

  • TLS information in the Overview tab now includes detailed information about the TLS connection, including:
    • Session resumption
    • Ciphers
    • Certificates
    • Extensions
  • TLS handshake sizes are now correctly accounted for when SSL Proxying

Minor improvements:

  • Charles system tray / menu bar icon now indicates throttling state
  • Local address now shows local port on Overview tab
  • SOCKS proxy HTTP ports now support ranges
  • Icons tweaked to improve recognition for colour blind users
  • Recognise all +json mime-types as JSON
  • TLS exceptions now convey more information (to help debug connection failures)
  • Active Connections view improved to actually show active connections rather than active requests/responses
  • Websocket info on Overview tab
  • Fix connections to hosts that resolve to multiple IPs where one IP doesn't work
  • Remote connection handling now uses a connection pool to better match regular browser performance
  • Response headers now shown for CONNECT requests
  • Charles is now more likely to resume TLS sessions with clients
  • JavaScript rendering performance improvements

Bug fixes:

  • Fixed occassional failures of JSON, JavaScript and XML text rendering
  • HTTP 2 bug fixes
  • Fixed failure of Raw editor when there aren't headers
  • Fixed occassional table rendering faults


  • System tray icons improved


  • macOS High Sierra compatibility fixes
  • Fixed missing menu bar on macOS High Sierra on non-English locales
  • Fixed crash when saving on macOS El Capitan
  • Fixed focus issue with dialogs when in fullscreen mode
  • Fixed menu accelerators not working when there wasn't an active session
  • Added option to Help menu to install Charles SSL Root Certificate in Java VMs


  • Improve behaviour of Charles launcher so a new icon doesn't appear in the dock
  • Fix support for bundle JRE on 32bit hosts

Version 4.1.4

10 July 2017

Minor improvements:

  • Mirror tool now supprts partial responses (so you can mirror some streaming video)
  • JSON export option added to Web Interface
  • Recognise WebSocket upgrades on an existing connection

Bug fixes:

  • Support IPv6 literal addresses in Location host fields
  • Fix hung requests that occurred in some rare, but consistent circumstances
  • Fix fault in multipart form viewer when expanding file details
  • Improve SSL connection establishment when the first protocol offered is rejected aggressively
  • Fix right-click issue on macOS on computers with a trackpad, where popup menus would appear then disappear

Version 3.12

10 July 2017

New features

  • Support for Brotli compression

Version 4.1.3

20 June 2017

New features:

  • Support for Brotli compression

Bug fixes:

  • Fix rare chunked response bug
  • Rewrite tool can now rewrite the Host to include a port

Minor improvements:

  • Add -v command-line argument to display the current version

Windows specific improvements:

  • Fixes to split pane behaviour, including making it easier to resize, and showing the correct cursor

Linux specific improvements:

  • Use update-alternatives so Charles 3 can be installed alongside Charles 4

Version 4.1.2

13 May 2017

Bug fixes and minor improvements

  • HTTP 2 improvements addressing faults with Map Remote, Map Local and general stability improvements.
  • User font preference is now applied more uniformly to transaction viewers
  • Fiddler import NumberFomatException fixed

Windows specific improvements:

  • Type rendering fixed when antialiasing is disabled 
  • Fix error output when using command-line tools
  • Fix clipping of alert icons
  • Fix crash when presenting file dialogs if GodMode is enabled

macOS specific improvements:

  • DNS Spoofing menu accelerator key changed to no longer conflict with Show/Hide Dock
  • Menu accelerators now work when you've closed the last session window

Version 3.11.7

10 May 2017

Bug fixes and minor improvements

  • Make it clear that throttling does not work on paths
  • APT / YUM: Rename the package to charles-proxy3 and enable it to be installed alongside Charles 4.

Version 4.1.1

21 April 2017

Bug fixes

  • Fix failure to render JSON Text and XML Text views on Windows and Linux
  • Fix failure to render Text view (when displaying line numbers) on Windows and Linux
  • Fix failure to launch on Windows and Linux with some anti-aliasing system configurations

Version 4.1

10 April 2017

Major new features

  • Protobuf 3 support (and Protobuf descriptor registry, for parsing your Protobuf messages)
  • HiDPI support on Windows and Linux
  • Flow chart (to explore the profile of a connection over time)
  • Linux versions now include a custom JRE, and no longer require Java to be installed separately

Minor new features

  • More info for unproxied SSL traffic, including protocol and ciphers
  • More closely match the SSL protocol and cipher negotiated between client and server when SSL Proxying
  • Client Process tool performance optimisation
  • Added Copy Image and Export Image options to the Chart viewer
  • ACL now supports IPv6 addresses
  • Expanded support for extended JSON mime types

Bug fixes

  • Hangs on macOS after sleep or GPU change have been resolved (thank you to the many users who participated in testing this!)
  • HTTP 2 stability improved when using Chrome
  • SOCKS proxy now respects incoming IP address, rather than doing a DNS lookup for the requested Host

Version 4.0.2

19 November 2016

Bug fixes and minor improvements

  • Local IP addresses are now sorted, and the window is bigger
  • Fix display of local IP address in SSL Proxying remote browser help
  • macOS: Improve occassional hanging issue when using a retina display
  • macOS: The window can now be dragged by the title label, and not when fullscreen
  • Windows: larger toolbar icons
  • JSON import/export: include exception details
  • Focussed setting now remembered in Sequence view
  • Antialias text on Chart view

Version 4.0.1

20 September 2016

Bug fixes

  • Fix display of local IP address in Help menu
  • Fix negotation with external proxies for authenticated SSL connections
  • Fix occassional hang on macOS with retina displays
  • Fix NPE in DNS Spoofing for repeated events
  • Fix HTML validation
  • Refresh current viewer when viewer mappings change
  • Ensure throttle settings are applied to repeated HTTP 2 requests
  • Rename Mac OS X to macOS
  • Improve PCAP file import

Version 4.0

1 August 2016

Charles 4 is a major upgrade to Charles. Read the Charles 4 release announcement.

Major features:

  • HTTP 2 support
  • IPv6 support
  • Updated look and feel
  • Improved performance

The updated look and feel includes:

  • Enhanced app icon!
  • Beautiful new custom designed icons for the toolbar and in the session navigator tree
  • Improved tab visual design on Mac OS X
  • Improved compatibility with Windows 10
  • Reduced border chrome

Minor features:

  • Command-line tool to export SSL certificates
  • Notes field added to Sequence view
  • XML summary export now includes headers
  • JSON export format
  • Kept-Alive count visible on Host and Path summaries
  • Uncompressed sizes added to Summary tab

Version 3.11.6

16 September 2016

Minor bug fixes and enhancements.

  • Support for macOS Sierra
  • Fixed breakpoint behaviour with 304 responses
  • Fix potential to create corrupted saved sessions when saving an actively recording session

Version 3.11.5

29 May 2016

Bug fixes:

  • Fix SSL Root certificate installation bug on Android when using http://ssl.charles/
  • SOAP viewer fixes
  • HAR importer fixes
  • Fix Malformed HTTP URL when proxying to unusual ports

Minor improvements:

  • Map Remote cookie path rewriting
  • SSL Root certificate export command-line tool
  • Mac OS X: add support for global preferences in /Library/Preferences

Version 3.11.4

29 February 2016


  • SSL now works with ATS on iOS 9

Bug fixes:

  • Fix a crash on launch on Mac OS X 10.8 - 10.10

Version 3.11.3

15 February 2016


  • SSL certificate export is a .pem file rather than a .crt, which is more correct and improves compatibility with Blackberry
  • Increased SSL cipher strength support
  • Convert command-line tool
  • XML export: added more timing and SSL information
  • Durations are now calculated live for in-progress requests and responses
  • SSL: Improved support for servers that send inappropriate alert responses during SNI negotiation
  • 1Password 6 support for Mac OS X

Bug fixes:

  • Command-line arguments support fixed on Mac OS X
  • Map Remote query string replacement behaviour restored (and improved)
  • SSL: Fix SNI support for hostnames ending in a dot
  • Client Process Tool fixed on Mac OS X
  • Fix menu accellerator overlap on Recording Settings and Repeat
  • Websocket viewer bug fixes

Version 3.11.2

9 November 2015

Minor improvements:

  • SSL improvements to support legacy protocols (SSLv3) and ciphers (RC4 etc) when using SSL proxying with old (and dangerous) hosts
  • The negotiated SSL protocol and cipher is now displayed on the Summary tab for SSL proxied requests
  • Websockets: support for deflate extensions
  • Map Local: add application/json mime-type for .json files

Version 3.11.1

27 October 2015

Bug fixes and improvements:

  • Fix Websocket support
  • Mozilla Firefox add-on now installed from
  • JSON editor is now smarter about quoting around strings
  • Warnings are smarter, and you can say "Don't show this again" (including access control warnings)
  • Gist publishing bug fixed for requests with no response
  • Look & feel improved on Mac OS X El Capitan
  • Fix ignored hosts showing up if they're non-proxied SSL hosts
  • Other minor bug fixes

Version 3.11

4 October 2015

Major new features:

  • Websocket support
  • Compose – create requests from scratch in Charles
  • Chaos – additions and improvements to the Throttling tool to simulate bad network conditions
  • Profiles – create profiles of different settings and switch between them
  • Export – select and export selected requests/responses, rather than having to export entire sessions

Other new features:

  • Copy and paste requests/responses between sessions
  • Map tool: add option to preserve the host header
  • SSL root certificate import/export – share your generated SSL root certificate between team members (export from the Help menu)


  • Map tool: improvement to handling of Set-Cookie domain rewriting
  • Throttling presets updated
  • JSON editor now supports many more editing features

Mac OS X:

  • Support for Mac OS X El Capitan – this isn't perfect yet, so it will be improved in bug fix releases

Version 3.10.2

7 July 2015

Bug fixes and improvements.

  • SSL improvements to workaround servers that don't support TLS 1.2 (this became a problem in 3.10 under Java 8)
  • Improve initial focus in dialogs (so you don't need to click into the first text field so much)
  • Copy cURL Request improvements: includes more headers, use --data instead of --data-binary when appropriate, and other minor improvements that should make your cURLing better.
  • HAR: support HAR files produced by Chrome

Version 3.10.1

31 March 2015

Minor bug fixes.

  • UI fixes for Mac OS X 10.7 & 10.8
  • Fix deadlock after 30 minute trial period timeout
  • Improvement to SSL certificate installation on mobile devices and remote browsers
  • Other minor bug fixes

Version 3.10

21 March 2015

Major new features, improvements and bug fixes.

SSL changes

  • SSL certificate root certificate change to generate a unique certificate for each installation of Charles (see SSL Proxying in the Help menu)
  • SSL Proxying now has its own settings menu item in the Proxy menu

Please note that these changes will affect the way you currently use Charles for SSL Proxying. You will need to install and trust a new certificate, which will be automatically generated for you. You can install that certificate on your computer using the options in the Help menu, under SSL Proxying. You can also export the certificate, to send to other systems, or browse to download the certificate to install on mobile devices such as iPhones.

Java changes

Charles now uses Java 8 on all platforms by default. Java 8 supports all of the latest SSL ciphers and should have the best performance on all platforms.

Mac OS X

Charles now prefers Java 8 on Mac OS X. Finally! Until now I've called the Apple Java 6 version the main version for Mac OS X, because I found Java 7 sluggish, and especially unbearable on retina displays. Java 6 is really old, and it doesn't support any of the latest SSL ciphers, which are increasingly essential these days. Not to mention other SSL features. So I'm thrilled that Java 8 is working well on Mac OS X now, including on retina displays.

Yosemite support has also improved. The typeface has changed. It looked really strange to me for a few days, but now I can't remember anything different. I hope the experience is similar for you!

New Features

  • 'Find' rewritten and dramatically improved (it's actually usable now)
  • Terminate long-running transactions manually from the context menu
  • Advanced Repeat now supports delays between requests and repeats
  • Customisable columns in the Sequence view (with a large selection of options) including sorting
  • Cookie editor
  • Whitelist tool (to complement existing Blacklist tool).  Enhanced both black and white list tools with options to either gracefully block or terminate the blacklisted requests.
  • 'Copy cURL Request' added to the context menu
  • Protobuf extensions support


  • Automatically terminate established SSL connections to a host when activating SSL proxying for that host (so you don't have to quit your browser or Charles to start SSL Proxying properly on new hosts)
  • SSL requests that are not proxied now have a padlock icon, to indicate that they are encrypted (vs SSL Proxied requests which can be viewed unencrypted)
  • Improved sorting in the Structure tree view
  • Reduction in the amount of memory Charles uses, especially when dealing with large numbers of small transactions
  • 'View Request As...' and 'View Response As...' commands added to the View menu.
  • Re-organised the Proxy menu into more logical groups.
  • Added tooltip for timestamp information in the Sequence table view that displays the full date/time
  • When you cancel editing a request the original request is re-displayed
  • Suppress the highlighting of requests when only peripheral data has changed
  • Automatic fallback from TLS v1.2 to TLS v1.1 and TLS v1.0 for sites that don't support the newer protocol versions, and don't fallback nicely.

Bug fixes

  • AMF editor appeared twice when editing an AMF message
  • Publish Gist didn't trust the Charles root SSL certificate!
  • Many dialogs in Charles could be opened multiple times via either keyboard shortcut or menu command
  • Fixed the 'Throttle Settings' and 'External Proxy Settings' dialogs so that they can be dismissed using the Escape key
  • Fixed a race condition that could corrupt data sent over unproxied SSL connections
  • Fixed the large memory use that could occur when binary content was displayed in the Text or Raw Viewer

Version 3.9.3

22 October 2014

Minor bug fixes and improvements:

  • SSL improvements, including SNI support
  • Bypass Domains in Proxy Settings supports wildcards on domains again
  • Charles automatically detects a headless environment and runs in headless mode (such as Linux command-line)

Mac OS X improvements:

  • iOS Simulator SSL configuration: Charles can now install its SSL CA certificate into your iOS Simulators (in the Help menu)
  • Mac OS X Yosemite support
  • 1Password 5 support (Charles configures the bypass proxy settings to avoid conflicting with 1Password's browser extension)

Version 3.9.2

26 May 2014

Minor bug fixes and improvements:

  • Mac OS X: improve menubar show/hide behaviour, menubar icon improvements, improved 1Password detection
  • Configuration fixes for Protobuf and others
  • Map Remote bug fixed when mapping https to http

Version 3.9.1

5 May 2014

Minor bug fixes and improvements:

  • Retina toolbar icons on Mac OS X no longer go rogue when disabled or pressed
  • Full-screen support on Mac OS X
  • Menu bar item / System tray item improvements

Version 3.9

25 April 2014

Major new features and improvements:

  • Focus; focus on hosts that you're most interested in, and they'll be separated out in the structure view
  • Structure view highlighting to show where requests and responses are being added
  • Gist publish; publish one or more request and response traces as a Gist
  • Charles menu bar item on Mac OS X (with option to disable in the Preferences)
  • Retina icons and graphics for Mac OS X (not quite all, but a lot!)
  • 1Password 4 compatibility (fixes issue where 1Password shows a warning, and wouldn't fill passwords in a browser when Charles was running)
  • Webp support
  • Line wrapping support in the Raw viewer
  • Improved sorting in the Structure view (Can sort by name and revert to original ordering)
  • Rewrite rules; add case-sensitive option
  • Full-screen support on Mac OS X

Bug fixes

  • Character set detection fixed so unicode characters (and others) will be correctly displayed.
  • CSS viewer fixed so that CSS files with windows ('\r\n') line endings and a multi-line comment can be displayed.
  • Fix corrupt saved or exported files.
  • Stripped the query string from the automatically generated filenames in the Save Response to avoid creating file names with illegal characters.
  • Sequence view filter is now applied (if one exists) when switching from Tall to Wide view or vice versa.
  • Changes made in the Protobuf Text editor would be lost if the user switched to another editor tab.
  • Malformed HTTP requests would show in the Charles Sequence and Structure views as 'null:0'.
  • Requests where the path of the request is unknown (such as unproxied SSL connections) are now shown as '<unknown>' rather than '<default>' in the Structure view.
  • Fixed incorrectly formatted date/times that were shown in some summary and overview tables when Charles was configured to display times with millisecond precision.
  • The popup dialog that allows inspection of long content in some table columns would not be available if the table columns were rearranged to a different order.
  • Socket closed exception on kept-alive sockets now correctly detected as a failed keep-alive and retried. Addresses a fault when using the Rewrite tool with response body rewriting.

Version 3.8.3

23 October 2013

Minor bug fixes and improvements:

  • Support for Mac OS X Mavericks: prevents Charles from being starved of CPU resources by App Nap.
  • Headless mode fixed (no longer exits immediately on some platforms), and the preference setting to activate Throttling on startup will be respected.
  • -throttling command-line switch added to activate Throttling on startup.

Version 3.8.2

21 October 2013

Minor bug fixes:

  • SSL bad_record_mac errors with some SSL servers have been resolved
  • Fix loading saved .chls files from old Charles versions

Version 3.8.1

9 September 2013

Minor bug fixes and improvements:

  • Blacklist tool fixed (wouldn't activate)
  • CSV export: fix failure when exporting incomplete requests
  • Import/Export Settings: tidy naming and alert copy
  • Tooltips on the Recording button, Throttling button, and similar, now reflect the current state

Version 3.8

4 September 2013

Major new features and improvements:

  • Viewer mappings: specific locations may be mapped to viewer types, this enables specific viewers to be used, such as when the content isn't identified correctly (also Protocol Buffer mappings can be defined)
  • CSS viewer and editor added which formats minified CSS content for display
  • XML Text viewer now supports tag folding
  • Sort by name in structure view: now sorts by hostname rather than protocol and hostname.
  • Rewrite tool: allow rewriting of response status
  • Import and export Charles settings
  • Mac OS X Mavericks support

Bug fixes and minor changes:

  • Fixed the misleading handling of path patterns that don't start with '/', these paths will now automatically have a leading '/' prepended as all paths always start with '/'
  • Fixed authorization header editing
  • Fixed bug that caused error message dialogs to be hidden behind main Charles window when the 'Window Always On Top' option was enabled
  • Fix SSL certificate cache collision bug
  • JSON viewer: remove quotes from around strings. It was noisy.
  • HAR export timings now correct and validate.

Version 3.7

12 February 2013

Major new features and improvements:

  • Charles now bundles Java on Windows and Mac OS X so you do not need to have Java installed before using Charles
  • Mac OS X: Charles is now signed so you can launch it without warning on Mountain Lion. Also the look & feel on Mountain Lion has been improved
  • DNS lookup, TCP connection, and SSL negotiation timing information is now measured and reported
  • Keep-alive status for each request is now reported, so you can see whether a request was part of a kept-alive channel
  • Protocol Buffer support, see the documentation.

Bug fixes:

  • ACL warning no longer blocks all traffic
  • Comparing transactions sometimes resulted in incorrectly repeated content
  • Reverse proxy now correctly sets the Host header in the case of default ports
  • Other minor bug fixes and improvements

Version 3.6.5

8 December 2011

Major bug fixes:

  • Java 1.7 now supported. Corrects slow startup and hung responses bugs.
  • Java 1.7 bad certificate error workaround for sites that use now disabled algorithms (ie. MD2withRSA)
  • Windows: Fix launching Charles by opening a file
  • SSL empty requests regression from 3.6.4 fixed
  • SSL now records the correct remote address details
  • SSL errors now more consistently displayed in the browser
  • Authentication header viewer can now recover from slightly oddly formatted headers
  • Closed connections regression from 3.6.4 fixed

Other changes:

  • Double-clicking a request no longer switches Structure and Sequence view. I did this too many times accidentally. The contextual menu now has an option to switch.

Version 3.6.4

15 November 2011

Major enhancements:

  • Linux support greatly improved, including an APT repository for installing Charles, integration into Gnome window manager and an application icon.

Minor enhancements:

  • JSON-RPC support now includes named parameters support
  • CSV export includes more information
  • AMF viewer, contextual menu includes copy to clipboard and base 64 decode.
  • Mac OS X UI improvements: including save dialog improvements (no longer save into the parent)
  • Firefox add-on now supports Firefox 9 beta
  • Add "Always bypass external proxies for localhost" option to external proxies configuration, defaults to on to maintain existing behaviour.

HAR import/export bug fixes and enhancements:

  • Missing data handling
  • Charles specific status and exception information included for better export/import round-tripping
  • Non-name-value POST bodies supported
  • Date format compatibility
  • Better error messages in the case of unsupported HAR imports
  • Blank header handling

PCAP import bug fixes and enhancements:

  • Now works again.
  • Correctly import keep-alive responses
  • Display imported requests in the correct order

Major bug fixes:

  • Fix launch race condition that could result in a blank screen on startup
  • Fix apparent hang on startup at Configuring Proxies on Linux
  • Fix potential deadlock when using Breakpoints
  • Mac OS X: fix problems on 10.6.8 with automatically configuring proxies

Minor bug fixes:

  • Toolbar tools menu: remove tools that don't support toggling
  • Fix bug when opening some HTTP trace files
  • Fix bug handling zipped boddies on some Java versions

Version 3.6.3

5 September 2011

Minor bug fixes:

  • Mac OS X Lion: fix regression in 3.6.2 on Lion UI for tab panes

Version 3.6.2

5 September 2011

Major bug fixes:

  • High CPU usage on Mac OS X resolved
  • Msvcr100.dll not found error on Windows resolved

Minor bug fixes:

  • SAZ file import: close SAZ files after importing so they can be used, moved or renamed by another process
  • Firefox integration reports success more accurately and links to the correct download URL if automatic installation fails.

Minor enhancements:

  • Recording Settings - include and exclude lists are now sorted
  • Windows installer now allows the user to choose the install location 

Version 3.6.1

24 August 2011

Minor enhancements:

  • 512x512 icons on Mac OS X and 256x256 icons on Windows 7
  • Firefox 7 add-on update
  • Added an alert displaying the local OS IP address to the Help menu
  • Map Local tool now adds a note to requests that fail to map local as the expected local resource doesn't exist

Bug fixes:

  • Fiddler / SAZ import fixed and improved
  • Fix hang on start up at "Starting proxies..." on some configurations
  • Improved multipart body viewer detection of multipart/form-data bodies

Version 3.6

18 August 2011

New features:

  • HAR file import and export
  • Fiddler session (SAZ files) import
  • Mac OS X 10.7 support improved


  • Rewrite tool URL rewrite now allows query strings to be created
  • Mirror tool, filename length limit increased
  • Firefox add-on detection improved for newer Firefox versions

Bug fixes:

  • Authentication viewer bug fix
  • Fault on startup due to invalid data in RewriteConfiguration
  • Map Remote bug where Set-Cookie headers set a domain with a port of -1 

Version 3.5.2

17 August 2010

Bug fixes and minor enhancements.

  • Include response status in filtering for sequence view
  • Fix bug in table views for multipart responses
  • Fix SSL certificate bugs in Internet Explorer
  • Fix bug when using a custom CA cert that needs a password on startup
  • Fix bug in reverse proxy not rewriting redirects over SSL
  • Add "Use External Proxy Servers" toggle in Windows tray icon menu
  • Fix Base64 decode popup positioning over text areas
  • Fix multi-monitor positioning of the Charles window
  • Fix bug where on Mac OS X the "Grant Privileges" prompt would repeat endlessly
  • Fix POST support when authenticating with external proxy servers
  • Add Multipart request editor
  • Add Authentication request editor
  • Add OAuth authentication header support

Version 3.5.1

1 January 2010

Minor bug fixes.

  • Repeat advanced tool: fix bug which caused it to stop prematurely after a number of requests
  • Auto save tool: fix bug where "Enable on startup" didn't work

Version 3.5

23 December 2009

Major new features, performance enhancements and bug fixes.

New features:

  • Import .pcap files captured by WireShark, tcpdump etc
  • Transparent HTTP proxying – activated in the Proxy Settings, so you can connect to Charles as if it was any web server and it will connect to the remote host based on the Host header. This means you can transparently redirect HTTP traffic through Charles using firewall rules.
  • NTLM (NT LAN Manager) authentication for external proxies now supported in the External Proxies configuration
  • JavaScript syntax highlighting
  • JSON syntax highlighting
  • Base 64 decode right-click option for text areas
  • GUI improvements for Mac OS X and Windows, especially Windows 7

Performance enhancements:

  • Improve network performance by using tcpNoDelay
  • Memory usage problems on large downloads fixed

Bug fixes and enhancements:

  • Validation tool now validates CSS to CSS3
  • Character encoding of XML responses is now detected based on the header or defaults to UTF-8.
  • Ignore action in the contextual menu now works across multiple hosts
  • Repeat tool now respects throttling settings
  • Repeat, Edit, Validate added to the Tools menu. A shortcut key has been added for Repeat.
  • Sequence filter now also filters on the Info column
  • Sequence filter waits for you to stop typing before filtering, improves the performance when filtering large lists
  • Sequence auto scroll now automatically disables if you click off the last request, and re-enables when you click back onto the last request.
  • External Proxy Settings: bypass domains now supports wildcards
  • External Proxy Settings: don't pass localhost requests to the external proxy
  • Request / response viewers: improve automatic choosing of viewers
  • Mac OS X code-signing to solve issue with strict firewall setting
  • AMF editing bug fix for error when changing the type of a property to a string
  • Throttling bug fix for throttling when using an external proxy server
  • Repeat bug fix for repeating when using an external proxy server
  • Fix erroneous recording of chunked post request size as 2GB.
  • Fix the Host header on SSL connections made through a reverse proxy
  • Fix SSL Proxying for SSL connections through reverse proxy