[GH-ISSUE #483] Import/Export log (.chls) and config (.xml) files from Charles #480

Open
opened 2026-03-03 19:19:09 +03:00 by kerem · 12 comments
Owner

Originally created by @NghiaTranUIT on GitHub (Apr 26, 2020).
Original GitHub issue: https://github.com/ProxymanApp/Proxyman/issues/483

Originally assigned to: @NghiaTranUIT on GitHub.

Description

Some users request that Proxyman would be able to import .chls file from Charles Proxy, so they can migrate their work to Proxyman easily.

We should support it.

Acceptance Criteria

  • Import .chls log file
  • Import .xml file for all Charles Setting (Map Local, Remote, Breakpoint, ...)
  • Able to export files (.chls and .xml) back to Charles
Originally created by @NghiaTranUIT on GitHub (Apr 26, 2020). Original GitHub issue: https://github.com/ProxymanApp/Proxyman/issues/483 Originally assigned to: @NghiaTranUIT on GitHub. ### Description Some users request that Proxyman would be able to import .chls file from Charles Proxy, so they can migrate their work to Proxyman easily. We should support it. ### Acceptance Criteria - Import .chls log file - Import .xml file for all Charles Setting (Map Local, Remote, Breakpoint, ...) - Able to export files (.chls and .xml) back to Charles
Author
Owner

@dougmcbride commented on GitHub (Apr 26, 2020):

It would be even better if logs could be saved in the .chls format as well. This way people who work in Charles shops could switch over to Proxyman without forcing the whole team to move at once.

Would this be a separate ticket, or part of this one?

<!-- gh-comment-id:619468706 --> @dougmcbride commented on GitHub (Apr 26, 2020): It would be even better if logs could be saved in the `.chls` format as well. This way people who work in Charles shops could switch over to Proxyman without forcing the whole team to move at once. Would this be a separate ticket, or part of this one?
Author
Owner

@NghiaTranUIT commented on GitHub (Apr 26, 2020):

Good point @dougmcbride 👍 I will update the ticket's description to support export files back to Charles since the Serialization and Deserialization are mostly the same 😄

<!-- gh-comment-id:619469118 --> @NghiaTranUIT commented on GitHub (Apr 26, 2020): Good point @dougmcbride 👍 I will update the ticket's description to support export files back to Charles since the Serialization and Deserialization are mostly the same 😄
Author
Owner

@NghiaTranUIT commented on GitHub (Apr 26, 2020):

Meanwhile, @dougmcbride if you need to import/export flow data between Charles and Proxyman, you can export as HAR, which is widely supported by other apps like Charles and Google Chrome.

https://docs.proxyman.io/basic-features/import-export

<!-- gh-comment-id:619479438 --> @NghiaTranUIT commented on GitHub (Apr 26, 2020): Meanwhile, @dougmcbride if you need to import/export flow data between Charles and Proxyman, you can export as **HAR**, which is widely supported by other apps like Charles and Google Chrome. https://docs.proxyman.io/basic-features/import-export
Author
Owner

@grschom commented on GitHub (Apr 27, 2020):

A good workaround until ProxyMan supports opening .chls files natively 👍

FYI, I noticed Charles has a command line interface that I successfully used to convert a .chls to .har and open via proxyman.

<!-- gh-comment-id:619978879 --> @grschom commented on GitHub (Apr 27, 2020): A good workaround until ProxyMan supports opening `.chls` files natively 👍 FYI, I noticed Charles has a [command line interface](https://www.charlesproxy.com/documentation/tools/command-line-tools/) that I successfully used to convert a `.chls` to `.har` and open via proxyman.
Author
Owner

@NghiaTranUIT commented on GitHub (Apr 27, 2020):

Thank for the idea. I successfully convert .chls to .har via CLI.

In order to directly import .chls to Proxyman, Charles has to be installed in the user machine, so Proxyman will call Charles to convert to .har then importing to Proxyman.

I will support this feature in the next release 👍

<!-- gh-comment-id:619987053 --> @NghiaTranUIT commented on GitHub (Apr 27, 2020): Thank for the idea. I successfully convert .chls to .har via CLI. In order to directly import `.chls` to Proxyman, Charles has to be installed in the user machine, so Proxyman will call Charles to convert to `.har` then importing to Proxyman. I will support this feature in the next release 👍
Author
Owner

@NghiaTranUIT commented on GitHub (May 3, 2020):

Hey @grschom and @dougmcbride, let check out this Beta build https://proxyman.s3.us-east-2.amazonaws.com/beta/Proxyman_1.22.0_Import_Charles_Proxy_File.dmg
I gonna release today or tmr

From now, you can:

  • Open directly .chls file or drag the file to Proxyman to open
  • It requires that Charles Proxy app is installed
  • Or you can open the Converter Window in File Menu -> Convert

Thank you 💪

2020-05-03 10 38 48

<!-- gh-comment-id:623063655 --> @NghiaTranUIT commented on GitHub (May 3, 2020): Hey @grschom and @dougmcbride, let check out this Beta build https://proxyman.s3.us-east-2.amazonaws.com/beta/Proxyman_1.22.0_Import_Charles_Proxy_File.dmg I gonna release today or tmr From now, you can: - Open directly `.chls` file or drag the file to Proxyman to open - It requires that Charles Proxy app is installed - Or you can open the Converter Window in File Menu -> Convert Thank you 💪 ![2020-05-03 10 38 48](https://user-images.githubusercontent.com/5878421/80907793-ed31a380-8d43-11ea-89ec-f1c569d9ef4c.gif)
Author
Owner

@NghiaTranUIT commented on GitHub (May 4, 2020):

Just release Proxyman 1.23.0: https://github.com/ProxymanApp/Proxyman/releases/tag/1.23.0

From now, we can open Charles Log directly 👍 @grschom @dougmcbride

<!-- gh-comment-id:623240660 --> @NghiaTranUIT commented on GitHub (May 4, 2020): Just release Proxyman 1.23.0: https://github.com/ProxymanApp/Proxyman/releases/tag/1.23.0 From now, we can open Charles Log directly 👍 @grschom @dougmcbride
Author
Owner

@grschom commented on GitHub (May 4, 2020):

awesome! Thanks for implementing this so quickly!

<!-- gh-comment-id:623526536 --> @grschom commented on GitHub (May 4, 2020): awesome! Thanks for implementing this so quickly!
Author
Owner

@taberruu commented on GitHub (Aug 19, 2020):

The Charles Map-Local-Export contains only a relative reference to the file.

An extended import/export for Map-Local including the files would be very useful.
Do we need another Issue for this?

<!-- gh-comment-id:676281607 --> @taberruu commented on GitHub (Aug 19, 2020): The Charles Map-Local-Export contains only a relative reference to the file. An extended import/export for Map-Local including the files would be very useful. Do we need another Issue for this?
Author
Owner

@NghiaTranUIT commented on GitHub (Aug 19, 2020):

Thanks for raising it. It's perfect timing to support this feature @benjidea 👍

I created a new ticket for it: https://github.com/ProxymanApp/Proxyman/issues/591

<!-- gh-comment-id:676315543 --> @NghiaTranUIT commented on GitHub (Aug 19, 2020): Thanks for raising it. It's perfect timing to support this feature @benjidea 👍 I created a new ticket for it: https://github.com/ProxymanApp/Proxyman/issues/591
Author
Owner

@bskendig commented on GitHub (Sep 28, 2022):

A way for Proxyman to directly export a .chls file hasn't been added yet, right? I'm interested in this for the same reasons @dougmcbride gave above.

<!-- gh-comment-id:1261242518 --> @bskendig commented on GitHub (Sep 28, 2022): A way for Proxyman to directly export a `.chls` file hasn't been added yet, right? I'm interested in this for the same reasons @dougmcbride gave above.
Author
Owner

@NghiaTranUIT commented on GitHub (Oct 3, 2022):

Sorry for the late reply @bskendig. I missed the notification.


Charles Proxy doesn't publicize the structure of the .chls file, so I don't know how to properly construct them.

However, not sure if you're aware of:

<!-- gh-comment-id:1265674849 --> @NghiaTranUIT commented on GitHub (Oct 3, 2022): Sorry for the late reply @bskendig. I missed the notification. ------------- Charles Proxy doesn't publicize the structure of the `.chls` file, so I don't know how to properly construct them. However, not sure if you're aware of: - Proxyman can directly open `.chls`. Document at https://docs.proxyman.io/advanced-features/charles-proxy-converter - Proxyman can export as a HAR file, then use Charles Proxy to open it.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/Proxyman#480
No description provided.