[Youtube Video] Understanding config.xml in Tizen TV Development

At the heart of every Tizen TV app sits a single small file that controls how the app runs: config.xml. Understanding its structure is essential for any Samsung Smart TV developer.

The widget Tag: Root of Everything

The entire config.xml file is wrapped in a <widget> tag — the root element for every Tizen web application. It carries important attributes like the app’s unique ID, version number, and view mode (typically fullscreen for TV apps). This element also declares the XML namespaces for both the W3C widget spec and Tizen-specific extensions.

Core Identity Fields

Inside the widget tag, a handful of elements define what your app is:

• <name> — the app name shown on the device
• <icon> — the icon image displayed in the app launcher
• <description> — a short description of the application
• <content src="index.html"/> — the entry point that Tizen loads when the app launches
• <author> — developer or organization information

Tizen-Specific Configuration

The <tizen:application> element is what tells Tizen exactly how to launch your app. It specifies the application ID, package ID, and the minimum required Tizen version. Without this element, your app simply will not run on a Tizen device.

Privileges and Cross-Origin Access

Two more important sections round out a typical config.xml:

• <tizen:privilege> — declares system-level permissions your app needs, such as internet access or filesystem read permissions. Each required privilege needs its own entry.
• <access origin="*"/> — controls cross-origin network access. Setting this to * allows requests to any domain, which is common for apps that fetch remote content.
• <feature> — declares hardware features the app depends on (optional but useful for store filtering).

Editing config.xml

You can edit config.xml directly in Tizen Studio using its built-in visual editor, or open it in any code editor you prefer. The file is plain XML, so the structure is easy to read and modify by hand once you know what each element does.

Watch the video to see config.xml explained visually — a small file with massive power over how your Tizen TV app behaves.