tizen-tool 0.2.2

Small CLI for building, re-signing, and installing Tizen web packages through a Dockerized Tizen Studio environment

Tizen tool

• License
• Contributing
• Code of conduct

tizen-tool is a small CLI for building, re-signing, and installing Tizen web packages through a Dockerized Tizen Studio environment.

It provides:

• a reproducible Tizen Studio setup inside Docker
• build, resign, and install commands
• strict configuration loading from CLI arguments, environment variables, and .env
• local caching of the Tizen Studio installer by version
• Docker image reuse keyed by the Tizen Studio version, required packages, and bundled Docker resources

The project is intentionally small. It is designed to remain predictable, easy to audit, and simple to run from a single working directory.

What it does

• Builds a .wgt package from a Tizen web app directory
• Re-signs an existing .wgt package with a configured profile
• Installs a .wgt package on a TV over sdb
• Builds and reuses a local Docker image with Tizen Studio and the required Tizen packages

Typical workflow:

1. Configure .env
2. Build or re-sign a package
3. Install it on a TV

Requirements

• Python 3.10 or newer
• Docker with Linux image support
• uv
• a valid Tizen signing profile directory containing profiles.xml

The default local development version is Python 3.14, as defined in .python-version. CI also runs on Python 3.14.

Installation

Install as a tool

uv tool install tizen-tool

Run without installing:

uvx tizen-tool --help

You can also use pipx:

pipx install tizen-tool

Local development

make install_deps

Run the tool from a repository checkout with:

uv run tizen-tool --help

Configuration

The tool reads .env from the current working directory. The effective precedence is:

1. CLI arguments
2. Environment variables
3. .env

Name	Required	Description
TIZEN_VERSION	Yes	Tizen Studio version (3.7 or newer), used to resolve the installer URL.
REQUIRED_PACKAGES	Yes	JSON array of Tizen package IDs installed into the Docker image.
CACHE_DIR	No	Directory used for application cache files. Defaults to ~/.tizen-tool.
PROFILES_DIR	Build / resign	Directory containing profiles.xml. Relative paths are resolved from the current working directory.
PROFILE	Build / resign	Signing profile name from profiles.xml.
TV_IP	Install	TV address or serial. Accepted forms: host, host:port, IPv4, or [IPv6]:port.
BUILD_SRC_DIR or SRC_DIR	Build fallback	Source directory for the app when not passed on the CLI.
BUILDIGNORE_FILE or BUILD_IGNORE_FILE	Build fallback	Optional gitignore-style exclude file for the build copy step.
BUILD_REBUILD, INSTALL_REBUILD, RESIGN_REBUILD, or REBUILD	No	Forces Docker image rebuilding for the corresponding command.
INSTALL_PACKAGE_FILE or PACKAGE_FILE	Install fallback	.wgt package path used when not passed on the CLI.
RESIGN_PACKAGE_FILE or PACKAGE_FILE	Resign fallback	.wgt package path used when not passed on the CLI.

See .env.example for an example configuration.

Examples

Build a package:

tizen-tool build /path/to/app

Build with explicit package overrides:

tizen-tool build /path/to/app \
  --required-package TV-Samsung_Public_6.0 \
  --required-package TV-Samsung_Wearable_6.0

Re-sign a package:

tizen-tool resign /path/to/app.wgt

Install a package on the configured TV:

tizen-tool install /path/to/app.wgt

Print LAN IPv4 addresses by interface for TV Developer Mode:

tizen-tool get-lan-ips

Override the TV target from the CLI:

tizen-tool install /path/to/app.wgt --tv-ip 192.168.1.100

Force rebuilding the Docker image:

tizen-tool build /path/to/app --rebuild

Run the package directly from a checkout:

uv run tizen-tool --help

Outputs and runtime behavior

• build copies the app into a temporary directory, runs tizen build-web, and writes the final .wgt to dist/ inside the source directory
• resign writes the new package to resigned/ next to the source package
• install mounts the package directory read-only and installs by package name over sdb
• installer binaries are cached under <CACHE_DIR>/installers/ by TIZEN_VERSION
• temporary files are stored under <CACHE_DIR>/tmp/
• the Docker image is reused unless its identifying labels no longer match the requested configuration

When an installer is not already cached for the requested TIZEN_VERSION, the tool tries both known Tizen installer URL patterns, stores the first successful match in the local cache, and reuses it for subsequent image rebuilds of the same version.

The project supports Tizen Studio 3.7 or newer. Older CLI installers require a preinstalled Java runtime and are intentionally rejected during configuration validation.

Development

Useful commands:

make install_deps
make lint
make check_types
make check
make check_deps_updates
make check_deps_vuln
make build

The development toolchain uses:

• ruff
• ty
• prek
• pysentry-rs
• bandit

Run the full local check suite:

make check

Release

Create a release from the main branch with no tracked changes in the working tree:

make release V=0.1.0

The release target:

• installs dependencies
• runs the local checks
• builds distributions
• updates the version if V differs from the current project version
• commits and pushes the version bump when needed
• creates and pushes the annotated tag v<V>
• can publish an existing version by pushing only the tag when V already matches the current version

GitHub Actions publishes tagged releases to PyPI from .github/workflows/ci.yml.