Preview Your Apple TV App Bundle Preview Your Apple TV App Bundle

Preview Your Apple TV App Bundle

Taylor Kirchwehm Taylor Kirchwehm


  1. Install Xcode
  2. Install Cocoapods
  3. Create an Apple TV App Bundle

Installing Your App Bundle

Once your .zip file download is complete, unzip the file to reveal its contents.

Step 1) Open a Command Line (the Terminal application comes preinstalled on Mac) and “cd”, which is short for change directory into the folder that your unzipped Apple TV app bundle is saved in.

If you don’t change the name of the folder that you download from the Zype platform or your email, and you downloaded and saved the folder to your Downloads, you will type the following commands into Terminal.

Type, cd Downloads and hit enter.

Type ls and hit enter.

Type cd and the name of your application folder. In this example, you would type original (13) or drag the app bundle folder into Terminal and hit enter.

You’ve successfully navigated to the correct application folder! If you have not installed Cocoapods (see prerequisites above), you will not be able to complete this next command.

Step 2) With Cocoapods installed, the final command you will type into Terminal is pod install and hit enter.


This command will generate a workspace file (.xcworkspace) that you can open in Xcode.

Make sure that you open the application workspace in Xcode ([Your_app_name].xcworkspace - NOT [Your_app_name].xcodeproj).


Step 3) Change your application target name. 

Within your application workspace in Xcode navigate to the general settings > Identity and Type: 


Change the name  field to the title of your choice, in this example, i’m using the target name “AppleTVZype” and hit enter, a new window will open, asking to rename the target name within your project code, click on the Rename option and then ok.


4) Update your bundle identifier: 

Log in to your Apple Developer account and navigate to Certificates, IDs & Profiles > Identifiers > App IDs

Click on the App ID that corresponds to your project application and copy the ID field:


Navigate to the general setting of your project and modify the field of bundle identifier: 


Running a Simulation of the App

Once the code is indexed, you can run a simulation of the app.

Click the play button in the top left of the screen and choose what device to run or simulate the program on.

Helpful Tip: If you add multiple test apps and want to delete one you can open the simulator remote and delete the app from the screen (like you would on an actual Apple TV device). Hold the mouse over the app icon, and it will give you the option to delete it.


App Customizations (Optional)


You can update the Theme color by navigating to Zype > Info.plist and modifying the value to either "Dark" or "Light".