description.html

<p><a href="https://github.com/SiriosDev/TVLauncher/releases/latest"><img src="https://img.shields.io/github/v/tag/SiriosDev/TVLauncher?style=for-the-badge&amp;label=version&amp;sort=semver" alt="Version" /></a> <a href="https://github.com/SiriosDev/TVLauncher/releases/"><img src="https://img.shields.io/github/downloads/SiriosDev/TVLauncher/total?style=for-the-badge" alt="Downloads" /></a></p>
<p><a href="https://github.com/SiriosDev/TVLauncher/blob/main/LICENSE"><img src="https://img.shields.io/github/license/SiriosDev/TVLauncher?style=for-the-badge" alt="License" /></a> <a href="https://github.com/SiriosDev/TVLauncher/actions/workflows/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/SiriosDev/TVLauncher/release.yml?style=for-the-badge&amp;label=Release" alt="Release" /></a> <a href="https://github.com/SiriosDev/TVLauncher/actions/workflows/update-description.yml"><img src="https://img.shields.io/github/actions/workflow/status/SiriosDev/TVLauncher/update-description.yml?style=for-the-badge&amp;label=Desc" alt="Desc" /></a></p>
<h1 id="tvlauncher">TVLauncher</h1>
<p>A simple, minimalist launcher for LG webOS TVs.</p>
<p>TVLauncher is made for custom launchers that do not support system applications or need a simple alternative way to organize them. It provides a direct, minimal path to the built-in Live TV application.</p>
<h2 id="installation">Installation</h2>
<p>Download the latest <code>.ipk</code> package from the <a href="https://github.com/SiriosDev/TVLauncher/releases">Releases</a> page and install it on your LG webOS TV using one of the methods below.</p>
<p>There is no setup, configuration, account, or additional dependency. Install it, reorder it in you custom home, and launch it.</p>
<h3 id="homebrew-channel">Homebrew Channel</h3>
<p>Before using the installation methods below, add the TVLauncher repository to the <a href="https://www.webosbrew.org/">Homebrew Channel</a>. In the Homebrew Channel's custom repositories, add:</p>
<pre class="text"><code>https://raw.githubusercontent.com/SiriosDev/TVLauncher/main/repo.json</code></pre>
<p>TVLauncher will then appear in the available apps and can be installed directly on the TV.</p>
<h3 id="ares-cli">Ares CLI</h3>
<p>Install the <a href="https://webostv.developer.lge.com/develop/tools/cli-installation">webOS CLI</a>, register your TV as a developer device, and install the package from a terminal. You can download the package from the Releases page or install it through the Homebrew Channel repository above:</p>
<div class="sourceCode" id="cb2"><pre class="sourceCode bash"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">npm</span> install <span class="at">--global</span> @webos-tools/cli</span>
<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a><span class="ex">ares-setup-device</span> <span class="co">#If you haven&#39;t already registered your TV</span></span>
<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a><span class="ex">ares-install</span> <span class="at">--device</span> <span class="op">&lt;</span>device-name<span class="op">&gt;</span> <span class="op">&lt;</span>downloaded_file_name<span class="op">&gt;</span>.ipk</span></code></pre></div>
<p>Replace <code>&lt;device-name&gt;</code> with the name configured in Ares.</p>
<h3 id="webos-dev-manager-desktop">webOS Dev Manager Desktop</h3>
<p>Click the upper-right <strong>Install</strong> button (or the equivalent install action) in <strong>Apps</strong> section. Select the downloaded <code>.ipk</code> file and confirm the installation.</p>
<h3 id="lg-dev-manager">LG Dev Manager</h3>
<p>Add the custom repository with:</p>
<pre class="text"><code>https://raw.githubusercontent.com/SiriosDev/TVLauncher/main/repo.json</code></pre>
<p>Navigate to the repository and install TVLauncher. Alternatively, you can install the downloaded <code>.ipk</code> file directly from the <strong>Apps &gt; Installed</strong> section, clicking the <strong>Install</strong> button in the upper side, or by drag'n'dropping the file (only on Desktop Browser).</p>
<h2 id="usage">Usage</h2>
<p>Open <strong>TV Launcher</strong> from your TV's apps. The app immediately launches the built-in Live TV application and closes after the launch succeeds.</p>
<p>No settings are required and there is nothing else to configure.</p>
<h2 id="tests">Tests</h2>
<p>TVLauncher has been tested only on <strong>NANO77</strong>. It should work on any version of webOS 4.0 or later. Reports, suggestions, and compatibility feedback are always welcome in the issues.</p>
<h2 id="credits">Credits</h2>
<p>Installation and development information was cross-checked against the following public projects and documentation:</p>
<ul>
<li><a href="https://webostv.developer.lge.com/develop/tools/cli-installation">LG webOS CLI documentation</a></li>
<li><a href="https://github.com/webosbrew/webos-homebrew-channel">webos-homebrew-channel</a></li>
<li><a href="https://github.com/webosbrew/dev-manager-desktop">webOS Dev Manager Desktop</a></li>
<li><a href="https://github.com/Scoty/lg-dev-manager">LG Dev Manager</a></li>
</ul>
<h2 id="ai-usage">AI Usage</h2>
<p>AI assistance was used for researching sources and documentation, writing commit messages, and code autocomplete during development.</p>
<h2 id="license">License</h2>
<p>TVLauncher is distributed under the <a href="LICENSE">Apache License 2.0</a>.</p>
<h2 id="disclaimer">Disclaimer</h2>
<p>LG, LG Electronics, webOS, and Live TV are trademarks or registered trademarks of their respective owners.</p>
<p>TVLauncher is an independent, community-developed, open-source project. It is not affiliated with, endorsed by, sponsored by, or officially associated with LG Electronics or any of its subsidiaries.</p>
<p>All trademarks, logos, product names, and brand names mentioned in this project are the property of their respective owners and are used solely for identification and compatibility purposes.</p>
<p>The use of these trademarks does not imply any partnership, endorsement, or authorization by their respective owners.</p>