Setting up Charles Proxy on Apple TV (tvOS)

Update: This post is a little out of date. WillowTree has posted the most up to date version of this. Please check it out: https://willowtreeapps.com/ideas/a-how-to-guide-for-apply-tv-setup-with-charles-proxy.

I use Charles Proxy as one of my development tools. I have done so for years. It’s invaluable to me. If you do any sort of client development that calls any sort of web service, you should look into Charles Proxy too.

This blog post is mostly taken from this excellent post on WillowTree development blog post called: 12 Steps For Setting Up Charles Proxy With tvOS. I recently tried to follow their steps, but was unable to get the SSL cert I needed from the the URL outlined (www.charlesproxy.com/getssl). You can now get the SSL cert directly from the Charles Proxy app. This post includes most of their steps, but have an updated step for getting the SSL cert. They deserve all of the credit here for the original post.

Set up a profile

In order to set up tvOS, you need to use a profile to setup a proxy.

  1. Download and install Apple Configurator.
  • Open Charles and navigate to Help -> _SSL Proxying -> Save Charles Root Certificate.

Prepare Apple TV in Configurator

In order to be able to install profiles onto your Apple TV, the device needs to be prepared and supervised.

  1. With the Apple TV turned on, connect it to your Macbook using the USB-C adapter.

Install the profile

  1. Now you will need to load the Profile onto the Apple TV. This requires a USB-C adapter.

You should start to see web traffic in Charles Proxy from your Apple TV.

I’ve got another blog post about Charles Proxy and using it in a development/QA process. I hope to have that post out shortly, it’s still a work in progress.

Updated June 9th, 2017: Added the Prepare Apple TV in Configurator section.

Originally published at ryan.grier.co on September 28, 2016.

Sr. iOS Engineer at Warner Bros. Digital Labs