Skip to content

Build on Linux

Dmitry Lyzo edited this page Jul 9, 2024 · 21 revisions

This is a guide for Ubuntu. But I believe that Tizen Studio can be installed on other distros if its requirements are met.

Prerequisites

  • Tizen Studio 4.6+ with IDE or Tizen Studio 4.6+ with CLI. See Installing TV SDK.
  • Git
  • Node.js 20+

Getting Started

  1. Install prerequisites.

  2. Install Certificate Manager using Tizen Studio Package Manager. See Installing Required Extensions.

  3. Setup Tizen certificate in Certificate Manager. See Creating Certificates.

    If you have installation problems with the Tizen certificate, try creating a Samsung certificate. In this case, you will also need a Samsung account.

  4. Clone or download Jellyfin Web repository.

    It is recommended that the web version match the server version.

    git clone -b release-10.9.z https://github.com/jellyfin/jellyfin-web.git

    Replace release-10.9.z with the name of the branch you want to build.

    You can also use git checkout to switch branches.

  5. Clone or download Jellyfin Tizen (this) repository.

    git clone https://github.com/jellyfin/jellyfin-tizen.git

Build Jellyfin Web

cd jellyfin-web
SKIP_PREPARE=1 npm ci --no-audit
USE_SYSTEM_FONTS=1 npm run build:production

You should get jellyfin-web/dist/ directory.

SKIP_PREPARE=1 can be omitted for 10.9+.

USE_SYSTEM_FONTS=1 is required to discard unused fonts and to reduce the size of the app. (Since Jellyfin Web 10.9)

Use npm run build:development if you want to debug the app.

If any changes are made to jellyfin-web/, the jellyfin-web/dist/ directory will need to be rebuilt using the command above.

Prepare Interface

cd jellyfin-tizen
JELLYFIN_WEB_DIR=../jellyfin-web/dist npm ci --no-audit

You should get jellyfin-tizen/www/ directory.

The JELLYFIN_WEB_DIR environment variable can be used to override the location of jellyfin-web.

Add DISCARD_UNUSED_FONTS=1 environment variable to discard unused fonts and to reduce the size of the app. (Until Jellyfin Web 10.9)
Don't use it with Jellyfin Web 10.9+. Instead, use USE_SYSTEM_FONTS=1 environment variable when building Jellyfin Web.

If any changes are made to jellyfin-web/dist/, the jellyfin-tizen/www/ directory will need to be rebuilt using the command above.

Build WGT

Make sure you select the appropriate Certificate Profile in Tizen Certificate Manager. This determines which devices you can install the widget on.

tizen build-web -e ".*" -e gulpfile.js -e README.md -e "node_modules/*" -e "package*.json" -e "yarn.lock"
tizen package -t wgt -o . -- .buildResult

You should get Jellyfin.wgt.

Clone this wiki locally