Softpedia >Mac >Internet Utilities >Charles >  Changelog

Charles Changelog

What's new in Charles 4.6.6

Mar 25, 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)

New in Charles 5.0 Beta 13 (Jan 25, 2024)

  • Various UI improvements
  • Bug fixes:
  • Recover from "Timer already cancelled" error

New in Charles 5.0 Beta 12 (Jan 25, 2024)

  • 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

New in Charles 4.6.5 (Oct 18, 2023)

  • Support for trusting SSL certificates on iOS 17 Simulator

New in Charles 5.0 Beta 11 (Jul 7, 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

New in Charles 5.0 Beta 10 (Jun 18, 2023)

  • Fix checkbox cells in tables

New in Charles 5.0 Beta 9 (Jun 18, 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)

New in Charles 4.6.4 (Apr 7, 2023)

  • Bug fixes:
  • Crash on macOS in file dialogs

New in Charles 4.6.3 Beta 2 (Oct 11, 2021)

  • Support HAR _error field
  • Automatically upgrade legacy GitHub tokens
  • Don't log invalid proxy requests

New in Charles 4.6.2 (Jul 7, 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

New in Charles 4.6.1 (Nov 16, 2020)

  • Fixes Dark Mode support on macOS.

New in Charles 4.6 (Nov 8, 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

New in Charles 4.6 Beta 3 (Sep 28, 2020)

  • Improved macOS and iOS SSL certificate compatibilty
  • External DNS Resolver option
  • Crash fixes for macOS

New in Charles 4.5.6 (Jan 15, 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.

New in Charles 4.5.5 (Dec 5, 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

New in Charles 4.5.4 (Nov 4, 2019)

  • Fixes an error on launch on macOS.

New in Charles 4.5.2 (Nov 4, 2019)

  • Resolve hangs on first launch
  • Add an option to reset the Charles SSL CA in the SSL Proxying Help menu
  • Fix memory leak

New in Charles 4.5.2 Beta 1 (Oct 11, 2019)

  • Sequence filter now filters on any column
  • Custom columns in the sequence view
  • macOS: Dark Mode support
  • macOS Catalina support
  • Highlight rules for matching requests and highlighting them in the structure or sequence view
  • Upgrade to Java 11

New in Charles 4.2.8 (Feb 28, 2019)

  • Bug fixes:
  • Fix mangling of requests with schemes starting with M

New in Charles 4.2.7 (Sep 14, 2018)

  • 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).
  • 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
  • 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

New in Charles 4.2.7 Beta 3 (Sep 12, 2018)

  • Fix Chrome 66 certificate trust issues with Map Remote

New in Charles 4.2.7 Beta 2 (Sep 10, 2018)

  • 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 shouldn't occur. Such as in 204 responses.
  • Fixes to port forwarding with external proxies
  • Fixes to IPv6 addresses with external proxies
  • Raw request editor removed as it could often result in invalid requests
  • Fixes to using external proxies when Charles is acting as a SOCKS proxy
  • Fixes to tunnelled HTTPS requests with external proxies
  • Find dialog no longer uses 100% CPU on macOS
  • 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 paths starting with ~/

New in Charles 4.2.6 (Jun 23, 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

New in Charles 4.2.6 Beta 2 (May 13, 2018)

  • HTTP 2 proxying error with small POSTs.

New in Charles 4.2.5 (Apr 7, 2018)

  • Improvements:
  • 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 behavior.
  • 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

New in Charles 4.2.5 Beta 1 (Mar 28, 2018)

  • Bug fixes and improvements:
  • macOS: Attempt to reduce crashes

New in Charles 4.2.1 (Nov 22, 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

New in Charles 4.2.1 Beta 2 (Oct 28, 2017)

  • HAR: improve import of HAR files exported from Chrome (especially for H2).

New in Charles 4.2.1 Beta 1 (Oct 2, 2017)

  • Attempt to reduce crashes.

New in Charles 4.2 (Oct 2, 2017)

  • MAJOR NEW FEATURES:
  • TLS handshake sizes are now correctly accounted for when SSL Proxying
  • TLS information in the Overview tab now includes detailed information about the TLS connection, including:
  • Session resumption
  • Ciphers
  • Certificates
  • Extensions
  • 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
  • macOS:
  • 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

New in Charles 4.2 Beta 1 (Aug 29, 2017)

  • Bug fixes and improvements:
  • Extended TLS information on the Overview tab
  • Better information about SSL/TLS exceptions to help troubleshooting
  • Active Connections view enhanced
  • WebSocket information added to Overview tab
  • Maintain and reuse outgoing connections for better overall performance (especially with Firefox)
  • macOS: Fix menu accelerators when there is no session open
  • macOS: Fullscreen dialog focus fixes
  • Toolbar icons changed to improve distinction between states for colour blind users
  • Menubar / System Tray icons changed to reflect throttling status (and improved, but not 100% yet, on Linux)
  • Lots of other bug fixes and minor improvements

New in Charles 4.1.4 (Jul 11, 2017)

  • Minor improvements:
  • Mirror tool now supports 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

New in Charles 4.1.4 Beta 3 (Jul 5, 2017)

  • WebSocket support extended to off-spec clients that upgrade to WebSockets on an existing HTTP connection

New in Charles 4.1.4 Beta 2 (Jul 3, 2017)

  • Support raw IPv6 addresses in [] format
  • Fix rare hung-connection fault
  • Fix fault showing detail of multipart request files
  • Fix SSL connection failure when the server failed the handshake by closing the connection
  • Mirror tool: support partial byte range responses
  • macOS: Fix popup menus disappearing

New in Charles 4.1.3 (Jun 20, 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 behavior, 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

New in Charles 4.1.3 Beta 4 (Jun 5, 2017)

  • Bug fixes and improvements:
  • Brotli support
  • Rare chunked transfer bug fix

New in Charles 4.1.2 (May 13, 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

New in Charles 4.1.2 Beta 4 (May 8, 2017)

  • Fix un-antialiased text display on Windows and Linux
  • Fix HTTP 2 Map Local and Map Remote issues
  • Apply user's text preferences to all viewers

New in Charles 4.1.1 (Apr 21, 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

New in Charles 4.1 (Apr 10, 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

New in Charles 4.1 Beta 2 (Dec 17, 2016)

  • Protobuf 3 support, including Protobuf registry for importing your protobuf descriptors
  • Unproxied SSL traffic now shows enhanced information
  • Flow chart
  • Throttling consistency improvements
  • Export image from Chart view

New in Charles 4.0.2 (Nov 19, 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 occasional hanging issue when using a retina display
  • macOS: The window can now be dragged by the title label, and not when full-screen
  • JSON import/export: include exception details
  • Focused setting now remembered in Sequence view
  • Anti-alias text on Chart view

New in Charles 4.0.2 Beta 1 (Sep 21, 2016)

  • Bug fixes:
  • Local Address menu now reports IPv4 and IPv6 addresses clearly
  • PCAP file import improvements
  • Fix Repeat tool faults
  • Avoid resolving the remote address twice in some cases
  • Ensure throttle settings are applied to repeated HTTP2 requests

New in Charles 4.0.1 (Sep 20, 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

New in Charles 4.0.1 Beta 3 (Sep 17, 2016)

  • Local Address menu now reports IPv4 and IPv6 addresses clearly
  • PCAP file import improvements
  • Fix Repeat tool faults
  • Avoid resolving the remote address twice in some cases
  • Ensure throttle settings are applied to repeated HTTP2 requests

New in Charles 4.0 (Aug 1, 2016)

  • 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

New in Charles 3.11.6 Beta 2 (Jul 1, 2016)

  • New features:
  • Fix breakpoints not working on 304 responses
  • Fix ConcurrentModificationException when saving a session
  • macOS Sierra support

New in Charles 3.11.6 Beta 1 (Jul 1, 2016)

  • New features:
  • Add ssl command line tool
  • Add support for global preferences file on Mac OS X

New in Charles 3.11.5 (May 29, 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

New in Charles 3.11.5 Beta 2 (Mar 9, 2016)

  • Add ssl command line tool
  • Add support for global preferences file on Mac OS X

New in Charles 3.11.5 Beta 1 (Mar 8, 2016)

  • New features:
  • Add ssl command line tool
  • Add support for global preferences file on Mac OS X

New in Charles 3.11.4 (Feb 29, 2016)

  • Improvements:
  • SSL now works with ATS on iOS 9
  • Bug fixes:
  • Fix a crash on launch on Mac OS X 10.8 - 10.10

New in Charles 3.11.4 Beta (Feb 23, 2016)

  • Fixed crash on launch on older versions of Mac OS X.

New in Charles 3.11.3 (Feb 15, 2016)

  • Improvements:
  • 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

New in Charles 3.11.3 Beta 6 (Jan 25, 2016)

  • SSL improvements for Blackberry
  • Charles Proxy website now on SSL
  • SSL cipher improvements

New in Charles 3.11.3 Beta 4 (Dec 4, 2015)

  • SSL improvements for Blackberry
  • Charles Proxy website now on SSL
  • SSL cipher improvements

New in Charles 3.11.3 Beta 3 (Dec 2, 2015)

  • SSL cipher improvements

New in Charles 3.11.3 Beta 2 (Dec 1, 2015)

  • SSL improvements for Blackberry
  • Charles Proxy website now on SSL

New in Charles 3.11.3 Beta 1 (Nov 23, 2015)

  • New features:
  • SSL improvements for Blackberry
  • Charles Proxy website now on SSL

New in Charles 3.11.2 (Nov 9, 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

New in Charles 3.11.2 Beta 2 (Oct 29, 2015)

  • Copy and paste for request/responses
  • Compose tool to create new responses
  • Export selected request/responses (using contextual menu)
  • More settings for Throttling, to simulate unreliable and variable connections
  • Profiles: save profiles containing different configuration options
  • SSL root certificate import and export (now you can share your SSL root certificate between different users)

New in Charles 3.11.1 (Oct 27, 2015)

  • Bug fixes and improvements:
  • Fix Websocket support
  • Mozilla Firefox add-on now installed from addons.mozilla.org
  • 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

New in Charles 3.11 (Oct 4, 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)
  • Improvements:
  • 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

New in Charles 3.11 Beta 4 (Sep 2, 2015)

  • Copy and paste for request/responses
  • Compose tool to create new responses
  • Export selected request/responses (using contextual menu)
  • More settings for Throttling, to simulate unreliable and variable connections
  • Profiles: save profiles containing different configuration options
  • SSL root certificate import and export (now you can share your SSL root certificate between different users)

New in Charles 3.11 Beta 2 (Jul 8, 2015)

  • New features:
  • Copy and paste for request/responses
  • Compose tool to create new responses
  • Export selected request/responses (using contextual menu)
  • More settings for Throttling, to simulate unreliable and variable connections
  • Profiles: save profiles containing different configuration options
  • SSL root certificate import and export (now you can share your SSL root certificate between different users)

New in Charles 3.10.2 (Jul 7, 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

New in Charles 3.10.1 (Mar 31, 2015)

  • 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

New in Charles 3.11 Beta 1 (Mar 21, 2015)

  • New features:
  • Copy and paste for request/responses
  • Compose tool to create new responses
  • Export selected request/responses (using contextual menu)

New in Charles 3.10 (Mar 21, 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
  • 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
  • Improvements:
  • 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

New in Charles 3.10 Beta 9 (Feb 28, 2015)

  • Major 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.
  • Charles now prefers Java 8 on Mac OS X. Finally. I've been calling the Apple Java 6 version the main version for Mac OS X, because I found Java 7 a bit sluggish, and especially unbearable on retina displays. Java 6 (or in fact Java 6 in general) is really old, and it doesn't support any of the latest SSL cyphers, which are increasingly essential these days. Not to mention other SSL features. So I'm thrilled that Java 8 appears to be working pretty well on Mac OS X now (and I expect more retina improvements really soon!).
  • Yosemite support has also improved, a little bit. The typeface has changed. It looked really strange to me for a few days, but now I can't tell the difference. I hope the experience is similar, and then better, 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
  • Improvements:
  • 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
  • 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

New in Charles 3.10 Beta 5 (Dec 3, 2014)

  • Note that 3.10b5 generates a new SSL certificate for each installation of Charles. You can export the certificate using the Help menu. For other devices, such as mobile devices, setup their proxy to Charles and then visit http://ssl.charles/ to download the current SSL certificate.

New in Charles 3.9.3 (Oct 22, 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)

New in Charles 3.9.2 (May 26, 2014)

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

New in Charles 3.9.1 (May 5, 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

New in Charles 3.9 (May 5, 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 '' rather than '' 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.

New in Charles 3.8.3 (Oct 23, 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.

New in Charles 3.8.2 (Oct 22, 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

New in Charles 3.8.1 (Sep 10, 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

New in Charles 3.8 (Sep 4, 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.

New in Charles 3.7 (Feb 14, 2013)

  • 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

New in Charles 3.6.5 (Dec 8, 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.

New in Charles 3.6.4 (Nov 15, 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

New in Charles 3.6.3 (Sep 6, 2011)

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

New in Charles 3.6.2 (Sep 2, 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

New in Charles 3.6.1 (Aug 24, 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

New in Charles 3.6 (Aug 18, 2011)

  • New features:
  • HAR file import and export
  • Fiddler session (SAZ files) import
  • Mac OS X 10.7 support improved
  • Enhancements:
  • 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

New in Charles 3.5.2 (Aug 18, 2010)

  • 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

New in Charles 3.5.1 (Jan 29, 2010)

  • 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.

New in Charles 3.4 (Oct 4, 2009)

  • Major changes and new features. SSL proxying has been changed to be opt-in per site, rather than on for all sites by default. This is to reduce user problems with Charles's SSL certificates. Charles also uses a new SSL CA certificate.
  • Please note that the Charles config file in version 3.4 is not backwards compatible. Charles makes a backup of the 3.3.1 config file when you first start Charles 3.4 in case you need to downgrade.
  • SSL Proxying:
  • Added an explicit list of locations for which SSL proxying will be enabled. You can add to this list by right-clicking on host names in the Structure view.
  • Support for client SSL certificates for authentication. See the Client SSL Certificates option in the Proxy menu.
  • Setting to use your own SSL CA certificate for Charles to use (PKCS12 format)
  • Charles's generated SSL certificates can now be permanently trusted in the browser, as an alternative to trusting the CA certificate
  • Mac OS X Leopard and Snow Leopard SSL certificate fixes
  • Recording settings:
  • Separate include and exclude lists, for people who exclusively want to record specific sites in Charles
  • Location matching:
  • Location matching now supports query strings
  • Location path matching no longer implicitly adds a * after the final /, so you can more accurately match paths. Existing patterns will be ported on upgrade.
  • Content viewers:
  • XML text view performance improvements using a new layout engine
  • Syntax highlighted HTML
  • Line numbers can now be used in combination with word wrap
  • Diff request/responses. Including experimental tree-diff support for XML and AMF etc.
  • AMF / Flex:
  • Improved error messages in the event of invalid data
  • AMF3 over HTTP support
  • AMF editor – change the type of a property
  • AMF3 support added for LiveCycle DS externalizable classes
  • Improved display of Flex method calls in transaction info
  • Tools:
  • Rewrite tool: Add to the response Notes field to describe the Rewrite rules that have been applied
  • Rewrite tool: can now add to empty query strings
  • Map Local & Map Remote in the contextual menu
  • Mac OS X:
  • Mac OS X Snow Leopard look and feel improvements
  • Mozilla Firefox:
  • Auto-install Firefox add-on
  • Bug fixes:
  • Fix hang with certain Nvidia graphics cards
  • Find results sorting
  • Fix lsof and netstat runaway processes in Client Process tool
  • Minor enhancements:
  • Add -config command line switch to specify config file location
  • Support for ; as an alternative for & in query strings
  • WinHTTP proxy settings autoconfiguration
  • Web Interface improvements – now export & clear sessions, enable/disable any tool
  • Record how long it takes to send the request – improves latency calculation on uploads
  • Brief details of each response are shown in the Structure view tree
  • Headless support using -headless command-line switch

New in Charles 3.3.1 (Mar 26, 2009)

  • inor new features and bug fixes. Experimental 64 bit Windows support