• 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.

• 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

• 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.

uv tool install tizen-tool

Run without installing:

uvx tizen-tool --help

You can also use pipx:

pipx install tizen-tool

make install-deps

Run the tool from a repository checkout with:

uv run tizen-tool --help

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

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

See .env.example for an example configuration.

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

• 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.

Useful commands:

make install-deps
make lint
make check-types
make check
make build

The development toolchain uses:

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

Run the full local check suite:

make check

Create a patch, minor, or major release from the main branch:

make release-patch
make release-minor
make release-major

These targets:

• install dependencies
• run the local checks
• run python-semantic-release
• infer the next version from conventional commits
• update pyproject.toml
• build distributions with uv build
• create and push the release commit and annotated tag

After pushing the release commit and tag, GitHub Actions publishes the tagged release to PyPI and creates the GitHub release from .github/workflows/ci.yml.