Skip to content →

Version History

Version 3.5.2

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

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

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 <?xml encoding="" ?> 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

Version 3.4.1

Minor feature and bug fix update.

  • Breakpoints: Bug fix on request body editing, this now works again
  • Location forms: pasting a full URL into the Host field parses it into the appropriate fields again, and better than before
  • Location forms: warn when invalid characters are entered into fields
  • Recording settings > Include: if this list contains entries but all disabled it will be treated as if it were empty and everything will be recorded

Version 3.4

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

Version 3.3.1

Minor new features and bug fixes. Experimental 64 bit Windows support.

  • Windows 64 bit support: Now with a separate 64 bit download to work with 64 bit JVMs
  • Mirror tool now no longer turns itself off when you restart Charles
  • Settings dialogs are now resizable
  • UI preference for display font now applies in more places, removed from some inappropriate places
  • Windows system tray icon – added more controls
  • Add "Copy URLs" option to request contextual menus to copy all of the request URLs
  • Add Raw editor to Edit & Repeat and Breakpoints
  • Add Breakpoints toggle button to toolbar and system tray icon on Windows
  • Bug fix: Copy and paste from tree+table views
  • Bug fix: Map Local rules that fail to find a suitable local file now try next matching rule

Version 3.3

Major new features and bug fixes.

  • New Features
    • HTML, CSS & RSS/Atom Validation
    • Export recorded sessions as XML
    • Auto Save tool can now use any export format
    • JSONP support
    • "Window Always On Top" setting in Preferences
    • Summary view table sorting improved to sort numerically and in reverse order
    • Map Remote can now map HTTP to HTTPS (vice versa already worked)
    • Location matching: Add /$ so that you can specify a pattern that matches only the given path, no files or subpaths.
  • Bug Fixes
    • Fix edit request bug where the path couldn't be changed
    • Improve handling of errors in Repeat & Edit
    • Improve SSL Map Remote support for non-existent source domains or non-existent source SSL servers.
    • SOCKS as external proxy bug fix
    • JSON viewer bug fixes
    • Window now remembers maximised state

Version 3.2.3

Minor new features and bug fixes.

  • SSL certificates generated as part of the SSL decryption are now version 3 (if appropriate) and include certificate extensions
  • Breakpoints: Can now edit the first line of the response headers, including the response code
  • Upgrade 3rd party libraries
  • Fix preference update bugs introduced in 3.2.2

Version 3.2.2

Minor new features and bug fixes

  • Fix Decrypt SSL through Reverse Proxy
  • Fix Session memory leak when sessions were closed but not garbage collected
  • Remember whether you view sessions in Structure or Sequence mode
  • Fix display of CDATA in XML Text view
  • Reverse Proxies & Port Forwarding now support binding to a specific local address
  • Fix keyboard expand/collapse in JTreeTable views
  • Large file support (> 2GB)
  • Location matching fix so that *s behave more consistently matching 0 or more chars
  • AMF header view/edit fix
  • AMF3 reference bug fix

Version 3.2.1

Minor new features and bug fixes

  • AMF3 date references parse bug fix
  • AMF3 XML support improved
  • AMF3 BlazeDS acknowledgement message parsing fix
  • AMF editing: Dates & Booleans can now be edited
  • Editor now automatically updates Host header value if URL host changes
  • Breakpoints: add scheme to breakpoints
  • Proxy bug causing slow Flex (in particular) application performance fixed
  • Map Remote mapping now more consistent – slight behaviour change, can now map file to file.
  • Map Local can now map onto a single file (if you write in the destination path manually).

Version 3.2

Major new features.

  • New features
    • Breakpoints
    • Throttling tool with individual throttle configurations per host and asymmetric throttling
    • Help pages added to most Tools, more to follow
    • Adobe BlaseDS support
    • Auto Save tool – auto saves timestamped session files for long-term monitoring and testing
    • New .chls file suffix and OS integration for opening Charles when you open a .chls file
    • Open .amf, .amf0 and .amf3 dump files directly in Charles
    • Open any file directly in Charles and view it as if it had been downloaded
    • Import multiple session files into one
    • Single-instance on Windows – only one copy of Charles can be running at a time
  • Enhancements
    • Tools with lists of locations can now enable/disable individual locations as well as the entire tool
    • AMF3 streaming over HTTP support
    • Hotkey on Windows to bring Charles to the front – Windows key C
    • Header viewer now pretty printed
    • SWF viewer shows total size of all fonts
    • Raw view added, shows the raw HTTP request or response
    • Map Local tool with case-sensitivity switch
    • SSL performance enhancements
    • Preference option to display seconds or milliseconds and bytes/second or bits/second
  • Bug fixes
    • Fix SSL with Decrypt SSL off over transparent SOCKS proxy
    • AMF3 integer encoding bug
    • Fix HTTP 100 continue bug where headers weren't cleared
    • and more

Version 3.1.4

Bug fixes and minor new features.

  • Rewrite Tool: Fix partial matches in rewrite value.
  • SOAP viewer: Improve detection of SOAP messages for clients who don't set the content-type properly (eg. Flash), and add resolution of references so SOAP display is now much improved.
  • AMF3: Raw AMF3 object parsing support now added for content-type application/x-amf3-object
  • Map Local: Add support for encoded URLs such as those with %20 in the path; these are now correctly converted before looking for the path/file on disc.
  • UI: Column states are now remember on all tables in the UI, so you can now resize and rearrange to suit your preferences.

Version 3.1.3

Minor bug fixes, minor new features.

  • Chart tab now includes charts for sizes, durations and types
  • Request & Response can now be displayed combined on one split-panel (in Preferences)
  • SSL handshake and certificate errors are now displayed in the tree
  • Default single-response recording limit increased to 100MB
  • Fixed Modal dialog lost-focus bug
  • Fixed Mac OS X proxy configuration hang occurred on some systems
  • Fix cookie parsing bug with last cookie attribute
  • Add Unicode BOM parsing capability
  • Change default text viewer tab size to 4 spaces from 8 spaces
  • Map tool now changes the request port if the protocol is changed
  • Version checker now reports OS and Java version for statistical purposes

Version 3.1.2

Minor bug fixes.

  • Fix tool and settings dialog sizing
  • Fix fault in Summary and Chart views for non-HTTP requests
  • Improved file popups for Map Local and Save All
  • Fix Recording settings bug where max requests can't be turned off
  • ICO and BMP viewers now work on Java 1.4

Version 3.1.1

Minor bug fixes.

  • AMF3 serialization fix (when used with edit function)
  • Proxy settings revert back to HTTP when SOCKS proxy disabled
  • Activating tools from request popup menu now correctly activated Selected Hosts mode if required

Version 3.1

Major new features. Please note this version drops support for Java 1.3.

  • User Interface
    • Dialog form layouts rewritten to unify layouts and show correct layout cross-platform (thanks to MigLayout)
    • Add "Minimise to System Tray" option in Preferences on Windows
    • Memory usage indicator now an option in Preferences
  • SSL
    • Map and Map Local tools now supported with SSL
    • New SSL root certificate with increased key sizes
  • Viewers
    • ICO support
    • BMP support
    • AMF tree now shows references inline to improve readability
    • AMF3 bug fix and improvements
    • Improved detection of resource types (using filename if mime-type unavailable)
  • Web Interface for controlling Charles added (Proxy menu)
  • SOCKS transparent proxying
  • Miscellaneous
    • Pattern matching can now include protocol (eg. http/https)
    • Tray icon now includes Start/Stop Recording and Throttling
  • Bug fixes
    • System proxy settings correctly reverted on Windows shutdown
    • Quit cleanly when another instance of Charles already running

Version 3.0.4

Minor bug fixes

  • SSL proxying bug on Java 1.4 fixed (was introduced in 3.0.3)

Version 3.0.3 re-release

Fixes launch bug on computers that haven't used Charles before

Version 3.0.3

Various improvements and minor bug fixes

  • Repeat and Edit functions now support SSL
  • SSL certificates now more closely match the actual server certificate
  • Chart now shows requests that are still in progress
  • Client Process tool added, to show which application is responsible for each request
  • DNS Spoofing now works through External Proxy servers
  • AMF viewer: double-click to resolve a reference restored
  • ASCII viewer renamed to Text
  • Port numbers are now shown, if appropriate, in the Sequence and Summary views
  • Map Local mime-type handling improved for server-side scripting pages and unknown file types
  • Rewrite tool with body rules now doesn't mangle binaries
  • SSL latency now properly reported
  • SSL latency bug for kept-alive connections fixed
  • Mozilla Firefox configuration bug fixed when profile directory couldn't be found
  • Mozilla Firefox profile directory can now be detected correctly on Java 1.4 on non-English Windows systems
  • Windows tray-icon functionality restored
  • Windows proxy settings are now only set for HTTP and SSL as Charles doesn't support FTP proxying
  • Windows configuration file moved to workaround Vista permissions issue
  • Windows installer removes Start option to workaround Vista user elevation issue

Version 3.0.2

Minor bug fixes and improvements

  • Copy to Clipboard: inconsistent image copying fixed
  • Microsoft Proxy Server as external proxy: bug with HTTPS connections fixed (thanks to Frans for his help debugging this)
  • DNS Spoofing and Map tools conflict resolved
  • JSON mime types now includes application/x-json
  • Windows: Installer UI changed
  • Windows: Launcher now supports IBM JRE
  • Mac OS X: Download now just includes the application
  • Mac OS X: Charles Proxy Settings helper now shows the Charles icon
  • Mac OS X: Upgrade to Quaqua 3.7.7, improves file chooser dialogs

Version 3.0.1

Minor bug fixes

  • The new JDIC tray icon code caused crashes on some Windows computers. The tray icon has been removed while a fix for this is investigated.
  • AMF Detail view parsing bug fixed

Version 3.0

Major new features and improvements

  • Editing and repeating of requests, including editing of AMF / Flash Remoting requests
  • Repeat multiple requests and Repeat Advanced for performance testing
  • Chart view of loading timeline
  • Local mapping tool to facilitate local development: use local files as if they are part of a website
  • Remote mapping tool to use parts of one website as if they were part of another
  • User Interface enhancements

Also changed and improved:

  • Summary table user interface: icons added, separate host name column added
  • Firefox 2 CSS: images loaded from CSS files have the CSS as their referer; now included in the summary of resources loaded for a page
  • Win32 launcher changed to provide Charles with its own task bar entry and Charles.exe in process list
  • Win32 application icon added to task bar and task switcher
  • No Caching tool now respects existing cache-control headers and adds stronger cache-control headers to bust caching
  • SWF viewer shows font information
  • Copy to Clipboard expanded to copy text and images
  • "General" tab improvements to include more information, including more summary data and compression statistics
  • and many other minor bug fixes and improvements