> For the complete documentation index, see [llms.txt](https://sharix.gitbook.io/sharix-tv/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sharix.gitbook.io/sharix-tv/installation/apple-tv-tvos.md).

# Apple TV (tvOS)

## **Requirements**

* A Mac computer, a Hackintosh, or a computer running macOS in a virtual machine.
* Xcode, which you can [download free from the Mac App Store](https://itunes.apple.com/gb/app/xcode/id497799835?mt=12).
* The [iOS App Signer application, available free from the official website](https://dantheman827.github.io/ios-app-signer/).
* Paired your computer with your Apple TV 4K so you can connect to it in Xcode. This is easily done by [following Apple’s guide on the topic](https://support.apple.com/en-gb/ht208088).
* Apple TV running on tvOS 13.0 and above

## Signing

The first step will be to create a certificate and provisioning profile to sign the Sharix TV app with. If you have a paid developer account can create these on the [Apple developer site](https://developer.apple.com/), under **Certificates, Identifiers & Profiles**. However, this is fiddly, and if you have a free developer account can’t do it all. For that reason, Sharix TV recommend using the following method, which is much easier:

### **Step 1**

Launch **Xcode**. Under **Xcode, Preferences, Accounts**, check your Apple ID is added. This is to sign the Sharix TV app with. If it isn’t, hit **+** to add an account, select **Apple ID**, and then sign in.

![](/files/-Mkqeywk_DT-2iI1Vo_h)

### **Step 2**

Now, in the menu bar select **File, New Project, tvOS, Single View App.**

![](/files/-MkqeywjP3edFWuKOTIs)

### **Step 3**

Now enter the project details. The Product Name should be **sharixtv**. The Organisation Name could be literally anything. The Organisation Identifier is normally **com.** followed by some personal string you can use for all your apps, for example **com.sharixtv**.

A Bundle Identifier will be generated automatically from those two fields. In the example from above, the bundle identifier would be **com.sharixtv.sharixtv.** The Team should be the Apple ID you added in [**Step 1**](/sharix-tv/installation/apple-tv-tvos.md#step-1) above.

![](/files/-Mkqeywia7keG2YzwI9P)

### **Step 4**

Once the project is open, configure it as shown below. Make sure to select your **specific** Apple TV 4K unit in the top-left, not a generic one. It must be connected to your computer via the same Wi-Fi network to do this.

The Identity fields should be populated automatically with the information from [**Step 3**](/sharix-tv/installation/apple-tv-tvos.md#step-3). The Signing fields **must** have your Apple ID selected, and show **no errors**. Select your Apple TV 4K’s current tvOS version under Deployment Target.

As you do this Xcode should create a provisioning profile and certificate automatically for the Sharix TV app, which you can see listed in the Signing section above.

![](/files/-MkqeywhWIlEVoLAjvcF)

### **Step 5**

Launch **iOS App Signer**. Drag the Sharix TV app into the Input File field.

Under Signing Certificate, select the Apple ID which you use in Xcode from [**Step 1**](/sharix-tv/installation/apple-tv-tvos.md#step-1). For Provisioning Profile, select the profile which Xcode generated automatically for you. It will probably have the Bundle Identifier which was created with the Xcode project in [**Step 3**](/sharix-tv/installation/apple-tv-tvos.md#step-3), for example, **com.sharixtv.sharixtv**.

The other fields can be ignored. Hit **Start** and save the now-signed Sharix TV app to your Desktop.

![](/files/-Mkqeywg4fqr9uDPIXBT)

## Installation

### **Step 1**

Once you have the Sharix TV app ready, launch Xcode, and select **Window, Devices and Simulators** from the menu bar. Make sure your Apple TV 4K is connected and highlighted in the sidebar.

![](/files/-Mkqeywd5p4HHCE6-miB)

### **Step 2**

Download the latest sharix\_tv\_tvos\_x.x.x.ipa file onto your computer.

### **Step 3**

Click the **+** button to add the Sharix TV IPA file.

### **Step 4** 

The Sharix TV app should now appear on your Apple TV home screen. Quit Xcode, and enjoy the Sharix TV app on your Apple TV 4K.

## Additional information

If you have a free Apple developer account (and aren’t jailbroken) you will have to sideload the Sharix TV app again every 7 days. If you have a paid account, it will last for a year.

To sideload a new version of the Sharix TV app, follow the sections [**Signing**](/sharix-tv/installation/apple-tv-tvos.md#signing) and [**Installation**](/sharix-tv/installation/apple-tv-tvos.md#installation) again. To sideload the previously signed Sharix TV app which you’ve already created an Xcode project and signing certificate for, follow [**Installation**](/sharix-tv/installation/apple-tv-tvos.md#installation) only.

If you retain the signed Sharix TV app at the end of [**Step 5**](/sharix-tv/installation/apple-tv-tvos.md#step-5) in the section [**Signing**](/sharix-tv/installation/apple-tv-tvos.md#signing), you can resign it easily using iOS App Signer. Just drop it in and use the **Re-Sign only** option, then push it across as detailed in [**Installation**](/sharix-tv/installation/apple-tv-tvos.md#installation).