Jellyfin 2 Samsung

Install Jellyfin on your Samsung Smart TV — fast, easy, and error-free.

🇩🇰 🇳🇱 🇬🇧 🇫🇷 🇩🇪

Massive thanks to jeppevinkel for providing the Jellyfin Tizen .wgt builds — an absolute lifesaver and hugely appreciated! 🙌 And a huge shout-out to Hungry__Alpaca for creating the awesome Moonfin fork — truly fantastic work! 🚀💙

---

📦 Current Versions

Channel	Version	Notes
Stable	v1.8.7.0	Recommended for most users
Beta	N/A	Includes new features

---

---

🎥 New to Jellyfin 2 Samsung?

Not sure where to start? No worries — we've made it easy.

Before diving in, check out this clear, step-by-step video guide that walks you through the entire installation process:

👉 Watch the YouTube tutorial: https://www.youtube.com/watch?v=_8mSV5pW-ic

It’s the quickest way to get set up with confidence.

---

📺 Older Samsung TVs
Samsung TVs running Orsay OS (the predecessor of Tizen) are not supported by this installer.
For those devices, use the Jellyfin Orsay Installer instead:
👉 https://github.com/PatrickSt1991/Jellyfin-Orsay-Installer

---

📦 Community Packages (New!)

Looking for older builds, custom .wgt files, or versions shared by other users?
Check out the new Tizen Community Packages repository — a curated collection of community-submitted packages.

👉 Browse community packages:
https://github.com/PatrickSt1991/tizen-community-packages

🚀 How It Works

---

⚠️ Before Running on Unix-Based Systems

Make sure the script is executable.

chmod +x Jellyfin2Samsung
./Jellyfin2Samsung

---

1. Launch the Tool

The tool automatically scans your local network for compatible Samsung Smart TVs.

---

2. Select a Release

Choose the desired Jellyfin release.

---

3. Pick a Version

Select the specific Jellyfin version you’d like to install.

---

4. Select Your TV

The tool lists all detected Samsung TVs. You can also manually enter an IP if your TV isn’t found.

---

5. Sit Back and Watch the Magic ✨

Once started, the installer takes care of everything else automatically.

---

⚠️ Certificate Required

A Samsung account is required only when a new Samsung security certificate must be created or regenerated. This usually occurs if the app package is modified, such as enabling plugins, changing permissions, or adjusting install requirements.

If your Jellyfin app—or any other app—requires a new certificate, you must log in with a Samsung account to generate the required security certificates before the app can be installed or updated.

---

⚙️ Settings

Language

Select your preferred language.

Certificates

Choose an existing certificate or let the tool generate a new one automatically.

Advanced Options

• Custom WGT: Upload your own .wgt file(s). The package name is randomized to allow side-by-side installs.
• Local IP: Your device’s local network IP address, entered as the Host IP in Samsung Developer Mode.
• Overwrite Existing Version: Attempts to overwrite an existing Jellyfin installation.
• Open After Installation: Automatically launches Jellyfin after installation.
• Remember IPs: Saves a manually entered IP address when the device is not found via scanning (one IP at a time).
• Remove Old Jellyfin: Attempts to uninstall previous Jellyfin versions before installing (not supported on all TVs).
• Force Samsung Login: Forces a Samsung account login to generate a new security certificate.
• Right-to-Left Reading: For right-to-left languages, the IP address must be inverted for Tizen Studio to work (e.g. 192.168.1.2 → 2.1.168.192).
• Jellyfin Config: Preconfigure the Jellyfin app so no setup is required on the TV after installation.

📝 Jellyfin Config

Update Mode consists of:

Type	Requirements
None	-
Server Settings	Server IP and port
Browser Settings	Server IP and port, API Key and Jellyfin user selection
User Settings	Server IP and port, API Key and Jellyfin user selection
Server & Browser Settings	Server IP and port, API Key and Jellyfin user selection
Server & Users Settings	Server IP and port, API Key and Jellyfin user selection
Browser & User Settings	Server IP and port, API Key and Jellyfin user selection
All Settings	Server IP and port, API Key and Jellyfin user selection

Server Settings

Setting	Description
Server IP	Pre-fills the Jellyfin server address in the app configuration, so you don’t need to enter it on the TV.
API Key	Required for Jellyfin-specific actions, such as loading and applying user settings.
Jellyfin User(s)	Select a specific user or all users to apply browser or user-level settings.
Enable TV Debug	Establishes a WebSocket connection between the Jellyfin app and the device running this tool to assist with debugging when the app fails to start or behaves unexpectedly.
Jellyfin Plugins	Retrieves installed plugins from the Jellyfin server and modifies them for compatibility with Samsung TVs.

Browser Settings

Setting	Description
Enable Backdrops	Displays background images behind library and item views.
Enable Theme Songs	Plays theme music when browsing libraries or items.
Enable Theme Videos	Plays theme videos in supported views.
Backdrop Screensaver	Uses backdrops as a screensaver when the app is idle.
Details Banner	Shows a banner image on item detail pages.
Cinema Mode	Automatically plays trailers before starting media playback.
Next Up Enabled	Displays the Next Up section for continued watching.
Enable External Video Players	Allows playback using external video players when supported.
Skip Intros	Enables automatic skipping of episode intros when available.
Audio Language Preference	Sets the preferred default audio language for playback.
Subtitle Language Preference	Sets the preferred default subtitle language.
Theme	Selects the app’s visual theme (e.g. Light or Dark).
Subtitle Mode	Controls how subtitles are displayed by default.

User Settings

Setting	Description
Auto Play Next Episode	Automatically plays the next episode in a series when the current one ends.
Remember Audio Selections	Remembers the selected audio track for future playback.
Remember Subtitle Selections	Remembers the selected subtitle track for future playback.
Play Default Audio Track	Always plays the default audio track when starting playback.
Enable Auto Login	Automatically signs in to the selected user when the app starts.

---

✅ Requirements

Before getting started, make sure you have:

• An active internet connection (required for generating or exchanging security certificates)
• A Samsung Tizen Smart TV with Developer Mode enabled
• A default web browser installed on your device
• A valid Samsung account (required only when a new Samsung certificate must be created)

---

🛠️ Support, Feedback & Wiki

Need help or want to report a bug?
👉 Open an issue
📖 Check the wiki

Got an idea for improvement?
💡 Share it on the Discussions board
or submit a feature request

We welcome all contributions and feedback to improve the experience for everyone!