-
-
Notifications
You must be signed in to change notification settings - Fork 0
Installation Guide
The following method works for everyone, but is more recommended for users with newer Samsung TVs running Tizen OS starting from model year 2024 (Tizen 8.0) or later
.
Samsung TV SDK is a set of tools for developing applications for Samsung TV, using Tizen. To work with Samsung TV SDK, you need to install Tizen Studio IDE
, Samsung TV Extensions
and Samsung Certificate Extension
on your system.
Note
If you have already installed Samsung TV SDK on your Windows PC system, then you can skip the below steps.
- Download and run the Tizen Studio installer.
- In the
Installer
:- Accept the software license statement by clicking the
Accept
button. - Set the SDK and data location (leave as default) and click the
Install
button to start installing the required packages and tools in the specified directory. - After the installation is complete, open the
Package Manager
by checking theLaunch the Package Manager
box before clicking theFinish
button.
- Accept the software license statement by clicking the
- In the
Package Manager
:- Select the
Extension SDK
tab and findTV Extensions-X.X
andSamsung Certificate Extension
which are the required extensions. - Click the
Install
button for both extensions and accept the software license statement by clicking theAccept
button. - After the extensions have been successfully installed, close the
Package Manager
by clicking theX
button at the top of the window.
- Select the
- If you want to continue with other steps, then launch the
Tizen Studio
by checking theLaunch the Tizen Studio
box before clicking theOK
button. - You may be prompted to select a directory as the workspace (leave as default) and launch the
Tizen Studio
by checking theUse this as the default and do not ask again
box before clicking theLaunch
button.
If you need more details, check the Installing TV SDK guide by Samsung.
If you have already installed Tizen Studio
and the required extensions, you can continue to import the existing Tizen project into Tizen Studio
by selecting the root directory or uploading an archive file.
- In the
Tizen Studio
menu:- Go to the
File
tab and selectImport
to open the import wizard.
- Go to the
- In the
Import
window:- Open
Tizen
and selectTizen Project
as import source and click theNext
button.
- Open
- Under
Select Directory / File
section:- Select the
Archive file
option to import the project from the archive file and click theBrowse
button. - Find the downloaded file
Moonlight.wgt
(e.g. which you can get from the Release tab) and click theNext
button.
- Select the
- Under
Select Project
section:- Select a Tizen TV profile
tv-samsung
and versionX.X
from theProfile
andVersion
drop-down menus for theMoonlight
project. - Then select the check box for the
Moonlight
project to prepare it for import and click theFinish
button.
- Select a Tizen TV profile
- Now the selected
Moonlight
project has been imported into your workspace.
If you need more details, check the Importing Web Applications guide by Samsung.
After you have imported the Moonlight
project, then you need to enable the Developer mode
and connect your Samsung TV to your computer using Device Manager
which is a tool within Tizen Studio
. So this allows you to run and install the application on a TV device for development.
- Enable the
Developer mode
on your Samsung TV:- Go to the
Apps
panel and press12345
on the remote, then a dialog should popup. - Set
Developer mode
toOn
, then enter your computer's IP address in theHost PC IP
field. - Restart the TV by holding the power button, then go to the
Apps
panel. - Depending on your model, a
DEVELOP MODE
will appear in theApps
panel at the top of the screen.
- Go to the
- Get the
TV IP Address
on your Samsung TV:- Go to the
Settings
panel, then go to theGeneral
section. - Select the
Network
menu, then selectNetwork Status
and click theIP Settings
button. - Now you can get the IP address from the
IP Address
field.
- Go to the
- In the
Tizen Studio
menu:- Go to the
Tools
tab and selectDevice Manager
to open the device manager.
- Go to the
- In the
Device Manager
window:- Select
Remote Device Manager
and click+
to add a TV device. - Under the
Add Device
window, enterSamsung TV
in theName
field and enter the IP address of your Samsung TV in theIP
field. - Then it is recommended to leave the
Port
field untouched and click theAdd
button. - Under the
Remote Device Manager
window, select the TV from the list and switch the connection toOn
and click theClose
button.
- Select
- Once you have successfully connected the TV with
Device Manager
, closeDevice Manager
by clicking theX
button at the top of the window.
If you need more details, check the TV Device guide by Samsung.
After completing the previous steps, you need to create and sign the certificate profile in order to run the application on your Samsung TV. This step is essential for signing the application for development and distribution.
Note
Before proceeding further with creating and signing the certificate profile, you must have already imported the Moonlight app, enabled developer mode, and connected your target TV device.
- In the
Tizen Studio
menu:- Go to the
Tools
tab and selectCertificate 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 theMigration for Certificate Profile
dialog.
- Go to the
- In the
Certificate Manager
window:- Click
+
in theCertificate Profile
and selectSamsung
as certificate profile type.
- Click
- Under
Device Type
section:- Select
TV
as the device type and click theNext
button.
- Select
- Under
Certificate Profile
section:- Enter
Moonlight
in theCreate a new certificate profile
field and click theNext
button.
- Enter
- Under
Author Certificate
section:- Select
Create a new author certificate
option and click theNext
button. - Enter
Moonlight
in theAuthor name
field andMgs12345
in bothPassword
fields. - Ensure the
Apply the same password for the distributor certificate
box is checked before clicking theNext
button. - You will be asked to sign in with your
Samsung Account
, so you need to click theOK
button. - After successful login, you can close the browser window and continue to the
Certificate Manager
window. - Then you need to define a certificate backup path for your certificate file in the
Backup path
field (e.g. C:\Users\USERNAME\Documents\Tizen Certificate Backup) and click theNext
button.
- Select
- Under
Distributor Certificate
section:- Select
Create a new distributor certificate
and click theNext
button. - Set the privilege level to
Public
and leave thePassword
fields untouched. - Select the
Add individual DUIDs
option, then theDevice ID
(DUID) for the target device will be added automatically, because you have already connected the TV withDevice Manager
, so you need to continue by clicking theNext
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.
- Select
- After you have successfully added and signed the
Moonlight
certificate profile, close theCertificate Manager
by clicking theClose
button.
If you need more details, check the Creating Certificates guide by Samsung.
If you have completed all the previous steps, then you can install the Moonlight app on the target device. This step is important to install and launch the application on the connected device.
Note
Before proceeding further with the installation of the Moonlight app, you must have already completed the previous steps, as well as created and signed your certificate profile.
- Ensure you have enabled
Developer mode
and the TV is already connected usingDevice Manager
before proceeding further. - In the
Project Explorer
view:- Click on the
Moonlight
project, then open theconfig.xml
file and rename theIcon
field from./icons/icon128.png
toicon.png
as the icon source. - Next you need to right-click on the
Moonlight
project, then go toRun As
and selectTizen Web Application
as the launch mode.
- Click on the
- The installation process will start after a few seconds, so you should wait until it is finished. After that, close
Tizen Studio
by going toFile
tab and selectExit
option. - Now the
Moonlight
app will automatically open on the target device and can be found underRecent Apps
on your Samsung TV.
If you need more details, check the Launching Applications on the TV guide by Samsung.
The following method is recommended for users with older Samsung TVs running Tizen OS starting from model year 2020 (Tizen 5.5) to 2023 (Tizen 7.0)
.
WSL 2 is the default distro type when installing a Linux distribution and uses virtualization technology to run a Linux kernel inside of a lightweight utility virtual machine (VM). This step is essential for running Docker Desktop
because it enables executing Linux containers on Windows PC through the native WSL 2 Linux kernel.
Note
If you have already installed WSL 2 on your Windows PC system, then you can skip the below steps.
- Open the
Start
menu, typeWindows Features
in the search bar, and clickTurn Windows features on or off
from the search results, and theWindows Features
window will open:- Find the
Windows Subsystem for Linux
andVirtual Machine Platform
features and enable both by checking the boxes. - After enabling the required features, click the
OK
button and restart your system.
- Find the
- Open the
Start
menu, typeWindows PowerShell
in the search bar, and right-clickWindows PowerShell
from the search results and selectRun as administrator
.- You may be prompted by
User Account Control
(UAC), so you need to clickYes
to allow it to run with administrative privileges.
- You may be prompted by
- In the
Windows PowerShell
window:- Enter command
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
to enableWindows Subsystem for Linux
feature, then restart your system. - After that, enter command
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
to enableVirtual Machine Platform
feature, then restart your system again.
- Enter command
- Now you need to download the latest
WSL 2
Linux kernel update package here:- Double-click on
wsl_update_x64.msi
to run the installer, then you will be prompted for elevated permissions, where you must selectYes
to approve this installation. - Once the installation is complete, proceed to the next step by running
Windows PowerShell
with administrative privileges. - After that, enter the command
wsl --set-default-version 2
to setWSL 2
as the default version when installing a new Linux distribution.
- Double-click on
- Alternatively, you can download
WSL 2
from theMicrosoft Store
which has more frequent updates using the commandwsl.exe --install
, then you can update theWSL 2
package using the following commandwsl.exe --update
under theWindows PowerShell
window, but still the first option is more recommended. - You have successfully installed
WSL 2
and now you can install your favorite Linux distribution.
If you need more details, check the Manual installation steps of WSL guide by Microsoft.
Docker Desktop is an easy-to-install application for your Mac, Windows or Linux environment that enables you to build and share containerized applications and microservices. This step is important to build or use the pre-built Docker image
to install the application on the connected device.
Note
Before proceeding further with installing Docker Desktop as your preferred Linux distribution, you should already have WSL 2 installed on your Windows PC.
- Download and run the Docker Desktop installer.
- In the
Installer
:- Under
Configuration
section, select theUse WSL 2 instead of Hyper-V
andAdd shortcut to desktop
options. - Click the
OK
button and follow the instructions in the installation wizard to authorize the installer and continue. - When the installation is complete, click the
Close and restart
button to complete the installation process by closing the installer and restarting the system.
- Under
- Open
Docker Desktop
, then a new window will appear asDocker Subscription Service Agreement", then you need to click the
Accept` button to continue. - Now
Docker Desktop
will start normally and then you can skip creating an account to useDocker
as it is optional. - Open
Docker Desktop
, then a new window will display theDocker Subscription Service Agreement
, then you need to click theAccept
button to continue openingDocker Desktop
.
If you need more details, check the Install Docker Desktop on Windows guide by Docker.
If you have completed all the previous steps, then you can install the Moonlight app on the target device. This step is important to install the application using the pre-built Docker image and launch it on the connected device.
Note
Before proceeding further with the installation of the Moonlight app, you must already have WSL 2 and Docker Desktop installed on your Windows PC.
- Enable the
Developer mode
on your Samsung TV:- Go to the
Apps
panel and press12345
on the remote, then a dialog should popup. - Set
Developer mode
toOn
, then enter your computer's IP address in theHost PC IP
field. - Restart the TV by holding the power button, then go to the
Apps
panel. - Depending on your model, a
DEVELOP MODE
will appear in theApps
panel at the top of the screen.
- Go to the
- Get the
TV IP Address
on your Samsung TV:- Go to the
Settings
panel, then go to theGeneral
section. - Select the
Network
menu, then selectNetwork Status
and click theIP Settings
button. - Now you can get the IP address from the
IP Address
field.
- Go to the
- Now, you need to run
Docker Desktop
and make sure to close any resource intensive applications. - Open
Windows PowerShell
or a similar terminal depending on your OS, then enter the following command to pull the pre-built Docker image:docker pull ghcr.io/ndriqimlahu/moonlight-tizen:master
- This operation may take a while, please be patient.
- After that, in
Windows PowerShell
, enter the following command to run and enter the container:docker run -it --rm ghcr.io/ndriqimlahu/moonlight-tizen:master
- After that, in
Windows PowerShell
, follow the steps below to install the application on your TV:- Enter the following command to connect to your Samsung TV over
SDB
(Smart Development Bridge):
sdb connect YOUR_TV_IP
Note: Replace
YOUR_TV_IP
withIP Address
of your TV.- Next, enter the following command to confirm that you are connected, then take note of the Device ID:
sdb devices
Note: Just to clarify Device ID will be the last column, something like
UE55AU7172UXXH
.- Next, enter the following command to install the package:
tizen install -n Moonlight.wgt -t YOUR_DEVICE_ID
Note: Replace
YOUR_DEVICE_ID
withDevice ID
of your TV.- Next, enter the following command to exit the container:
exit
Note: Moonlight should now be available under
Recent Apps
on your Samsung TV. - Enter the following command to connect to your Samsung TV over
- Finally, in
Windows PowerShell
, enter the following command to remove the Docker image, as it is no longer needed:docker image rm ghcr.io/ndriqimlahu/moonlight-tizen:master
Note: At the end you can enter the
exit
command to close theWindows PowerShell
window. - (Optional) Disable the
Developer mode
on your Samsung TV:- Go to the
Apps
panel and press12345
on the remote, then a dialog should popup. - Set
Developer mode
toOff
and then click theOK
button to close the dialog. - Restart the TV by holding the power button, then go to the
Apps
panel. - Depending on your model, a
DEVELOP MODE
will disappear from theApps
panel at the top of the screen.
- Go to the