Skip to content

Updating Guide

Jump to bottom
BrightCraft edited this page Aug 1, 2026 · 12 revisions

Methods of updating Moonlight app on Tizen TV

Updating using Apps2Samsung

The following method is highly recommended for most users and is compatible with all Samsung TVs running Tizen OS 5.5 or higher.

Installing the new Moonlight app via Apps2Samsung

If you have completed all the previous steps, then you can install the updated Moonlight app on the target device.

  • Before proceeding further, you should delete the existing Moonlight app that you already have installed on your Samsung TV to prevent any errors while installing the new updated Moonlight app.
  • Now you need to follow the Installing Moonlight via Apps2Samsung guide to successfully install the latest version of Moonlight app on your Samsung TV.

Updating using Tizen Studio

The following method is mainly recommended for advanced users with newer Samsung TVs running Tizen OS 7.0 or higher.

Deleting the outdated Moonlight app from Tizen Studio

To avoid conflicts when importing the updated Moonlight project into Tizen Studio by selecting the root directory or uploading an archive file, then you should follow the steps below carefully.

Note

Before proceeding further, you should delete the existing Moonlight app that you have already installed on your Samsung TV to prevent errors while installing the new updated Moonlight app.

  1. Run Tizen Studio and make sure to open the Moonlight project under the Project Explorer view.
  2. In the Project Explorer view:
    • Right-click on the Moonlight project and select the Delete option to continue.
  3. In the Delete Resources window:
    • Select the Delete project contents on disk checkbox and click the OK button to remove the Tizen project.
  4. Now you need to follow the Importing the Moonlight app into Tizen Studio guide from the beginning to import the updated Tizen project to Tizen Studio.
  5. Ensure you have already enabled Developer mode and connected your TV to Device Manager or follow the Enabling Developer Mode and Connecting the TV to the Device Manager guide from the beginning to learn how to enable Developer mode and connect your target device in Device Manager.
  6. Also, if you don't have a certificate profile, follow the Creating and Signing the Certificate Profile guide to create and sign a new one; if you already have a valid certificate profile, you can skip this step; and if your existing certificate profile has expired, proceed to the next section.

Extending the Expiration of an existing Certificate Profile

If you ran into an expired certificate while attempting to install the updated Moonlight app, you must extend and sign your existing certificate profile to successfully run the application on your Samsung TV. However, you can skip this section entirely if your installation completed successfully without any expiration errors.

Note

Before proceeding, ensure you have already imported the Moonlight app, enabled developer mode, and successfully connected your target TV device.

  1. In the Tizen Studio menu:
    • Go to the Tools tab and select Certificate Manager to open the certificate wizard.
    • You may be prompted to select a profile file for import, so you should click the Cancel button in the Migration for Certificate Profile dialog.
  2. In the Certificate Manager window:
    • Click + in the Certificate Profile and select Samsung as certificate profile type.
  3. Under Device Type section:
    • Select TV as the device type and click the Next button.
  4. Under Certificate Profile section:
    • Choose Moonlight in the Select an existing certificate profile field and click the Next button.
    • You will be asked to remove the existing author certificate and create a new one, so you should click the Yes button.
  5. Under Author Certificate section:
    • Select Create a new author certificate option and click the Next button.
    • Enter Moonlight in the Author name field and Mgs12345 in both Password fields.
    • Ensure the Apply the same password for the distributor certificate checkbox is selected before clicking the Next button.
    • You will be asked to sign in with your Samsung Account, so you need to click the OK button.
    • After successful login, you can close the browser window and continue to the Certificate Manager window.
    • Then, specify a backup directory for your certificate backup file in the Backup path field and click the Next button.
    • You will be asked again to remove the existing distributor certificate and create a new one, so you should click the Yes button.
  6. Under Distributor Certificate section:
    • Select Create a new distributor certificate option and click the Next button.
    • Set the privilege level to Public and leave the Password fields untouched.
    • Select the Add individual DUIDs option, then the Device ID (DUID) for the target device will be added automatically, because you have already connected the TV with Device Manager, so you need to continue by clicking the Next button.
    • After completing the distributor certificate, you can close the certificate profile creation wizard by clicking the Finish button.
    • A new dialog will appear with the message telling you that your new certificate profile has been successfully created and set as active, so you need to click the OK button.
  7. After you have successfully extended and signed the existing Moonlight certificate profile, close the Certificate Manager by clicking the Close button.

If you need more details, check the Extending Certificate Expiry guide from Samsung's official documentation.

Installing the new Moonlight app via Tizen Studio

If you have completed all the previous steps, then you can install the updated Moonlight app on the target device.

  • Before proceeding further, you should delete the existing Moonlight app that you already have installed on your Samsung TV to prevent any errors while installing the new updated Moonlight app.
  • Now you need to follow the Installing Moonlight via Tizen Studio guide to successfully install the latest version of Moonlight app on your Samsung TV.

Updating using Docker

The following method is mainly recommended for advanced users with older Samsung TVs running Tizen OS 5.5 to 6.5.

Deleting the outdated Docker image from Docker

To avoid conflicts when pulling the updated Docker image to Docker Desktop, then you should follow the below steps carefully.

  1. Run Docker Desktop and make sure to close any resource intensive applications.
  2. Then, open Windows PowerShell or a similar terminal depending on your OS.
  3. In the Windows PowerShell window, enter the following command to remove the Docker image: 
    docker image rm ghcr.io/brightcraft/moonlight-tizen:master
  4. After that, you can enter the exit command to close the Windows PowerShell window.

Installing the new Moonlight app via Docker

If you have completed all the previous steps, then you can install the updated Moonlight app on the target device.

  • Before proceeding further, you should delete the existing Moonlight app that you already have installed on your Samsung TV to prevent any errors while installing the new updated Moonlight app.
  • Now you need to follow the Installing Moonlight via Docker guide to successfully install the latest version of Moonlight app on your Samsung TV.

Clone this wiki locally