# Nava TV

A calm, fast home screen for your TV. Every streaming service, your live channels,
your own videos, search and settings — in one interface you drive with a single remote.

**Version 1.2.0 · Official launch: November 14, 2026.**

Nava TV comes in two forms:

| | Mini-PC | LG TV |
|---|---|---|
| What you need | any x86-64 mini-PC + HDMI | an LG TV with webOS |
| What you install | Nava TV on Debian 12 or 13 — the PC boots straight into it | the `com.nava.tv` app |
| Services open | full screen in Chrome, Home brings you back | in the TV's own LG apps only — never as a website |
| Live TV | mpv player | the TV's own player |
| Remote | USB air mouse / remote, keyboard, HDMI-CEC where supported | Magic Remote (pointer) or the regular LG remote |

Русская версия — [README.md](README.md).

## Features

- **Home** — a hero for whatever is in focus, rows for Continue watching, Apps,
  Live TV, Library and System. Rows remember where you were.
- **Apps** — the streaming services of your region in one row. Press OK and the
  service opens full screen; press **Home** to come back. Add favorites — they
  move to the front of the row.
- **Nava Store** — Nava TV's own app store: every service in the world by
  category. Open one, add it to Home or remove it (Store tab, or System → Store).
- **Search** — across services, channels and your files, plus "Search … in YouTube"
  and the web. Type with the on-screen keyboard or a real one.
- **Live TV** — add your own M3U playlist; ↑ ↓ and CH± switch channels, digits
  dial a number, "All channels" lists them all.
- **Library** — videos from `~/Videos` and USB sticks (mounted read-only), with
  Continue watching.
- **Appearance** — light by day, dark by night. On mini-PCs and capable TVs the
  wallpaper is alive (slowly drifting silk ribbons), the night spreads in a circle
  when you switch, and the hero title rises into place — just like the launch film.
- **Quick settings** — Wi-Fi, region, language, appearance, cursor mode,
  screensaver, playlist, sound output, power.
- **Cursor mode** — for websites that ignore the arrow keys: the arrows move a
  pointer, OK clicks.
- **About** — health checks (Chrome, mpv, sound, Wi-Fi, remote, CEC, IPTV,
  catalog), the IP address and the name/code of every remote button you press.
- **English and Russian.** The language follows the region and can be changed in
  quick settings.

Region catalogs: **United States** (14 services), **Europe** (14), **Russia** (16),
**CIS** (12), **World** (10). Without a choice the region follows the system time
zone (mini-PC) or the TV language (LG); it can be changed any time from the remote.

## Install on a mini-PC

### The easy way: the Nava TV USB installer

`nava-tv-1.2.0-installer-amd64.iso` is Debian 13 with Nava TV built in — one USB stick
installs everything.

1. Write the image to a USB stick (4 GB or more) with **balenaEtcher** or
   **Raspberry Pi Imager** (Windows, macOS, Linux), **Rufus** in *DD image* mode, or
   `sudo dd if=nava-tv-1.2.0-installer-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync`.
2. Plug in the network cable (or have your Wi-Fi password ready), boot the mini-PC
   from the stick (usually F12, F11, F8 or Esc at power-on). Secure Boot can stay on.
3. **Install Nava TV** starts by itself after 5 seconds. Pick your language, your
   **country** (it sets the time zone and the services catalog), keyboard, network,
   a password for the admin account `nava`, and the disk.
4. Confirm erasing the disk — **everything on it is deleted**.
5. Wait 15–30 minutes: Debian, Google Chrome and Nava TV are downloaded and set up.
   The mini-PC restarts straight into Nava TV.

If the network dropped during the last step, Nava TV finishes setting itself up on
the first start. The log is in `/var/log/nava-tv-install.log`.

**Security.** Security updates for Debian and Google Chrome install by themselves every
night around 04:00; after a Chrome update the TV session restarts, and if a kernel update
needs it, the mini-PC reboots at 04:30. No SSH server is installed, so nothing listens for
logins from the network; if you want one, run `sudo apt install openssh-server` and use a
strong password for `nava`.

### The manual way: an existing Debian


You need: an x86-64 (amd64) mini-PC, a TV over HDMI, a network (cable is easiest
during setup), a USB stick, and a USB remote or keyboard.

### 1. Debian

Install **Debian 13 "trixie"** (the current release) or **Debian 12 "bookworm"** — the netinst image for amd64:

- **Software selection**: untick everything except *standard system utilities*
  (add *SSH server* only if you want to read the log from a laptop — then use a strong
  password). No desktop.
- Pick your **location / time zone** correctly — Nava TV uses it to choose the
  services catalog.
- Better **not** to set up Wi-Fi in the Debian installer: then NetworkManager
  manages it and you choose networks with the remote.

### 2. Nava TV

Copy `nava-tv-1.2.0.tar.gz` to the mini-PC (USB stick or `scp`), then:

```bash
tar xzf nava-tv-1.2.0.tar.gz
cd nava-tv-1.2.0
sudo ./install.sh
sudo reboot
```

If Debian has a root password and no `sudo`, run `su -` first and drop `sudo`.

Options:

| Option | What it does |
|---|---|
| `--region us\|eu\|ru\|cis\|world` | services catalog (default: from the time zone) |
| `--playlist URL` | your IPTV playlist (M3U) |
| `--user tv` | the account the TV session runs as |
| `--no-quiet-boot` | keep the GRUB menu and boot messages |
| `--uninstall [--purge]` | remove Nava TV (`--purge` also removes settings) |

The installer adds Google Chrome (from Google's repository, with Widevine for
Netflix and others), cage, mpv, PipeWire, NetworkManager and the Inter font. It
needs the network only while installing. Running it again updates Nava TV and
keeps your settings.

After the reboot the mini-PC starts straight into Nava TV — no login, no desktop.

### 3. First run

1. Open **Settings → About**: every check should be green (HDMI-CEC is often
   missing on mini-PCs — that's fine).
2. **Settings → Wi-Fi** to join a network, **Region** to change the catalog,
   **Playlist** to add your channels.
3. Sign in to your services the first time you open them — Chrome remembers you.

### Remote

| Button | Action |
|---|---|
| ← ↑ → ↓, OK | move, select |
| Back / Esc | back |
| Home (`KEY_HOMEPAGE`) or F10 | home screen — also from any service and from the player |
| Menu, S | quick settings |
| Search, / | search |
| F9 | cursor mode |
| Vol± / Mute / Power | volume / power menu |

Remotes differ. Press each button in **Settings → About** to see its name and
code, then put them into `keys.*` in `/etc/nava-tv/tvd.conf`.

### Files

| Path | What |
|---|---|
| `/opt/nava-tv` | the service, the shell, the catalog |
| `/etc/nava-tv/tvd.conf` | settings (commented) |
| `/etc/nava-tv/catalog/` | your own apps and regions on top of the built-in ones |
| `~tv/.local/state/nava-tv/` | what you changed with the remote |

Log: `journalctl -u nava-tv -f`.

### Troubleshooting

Read the log over SSH, or on a second console (Ctrl+Alt+F2):
`journalctl -u nava-tv -b --no-pager | tail -100`.

| Problem | Where to look |
|---|---|
| Black screen after boot | the log: a cage error means no access to the GPU — `groups tv` must list `video` and `render`. |
| Chrome with an error instead of Home | the tvd service: `journalctl -u nava-tv -b \| grep tvd` |
| Home doesn't bring you back | About → Remote: is the remote seen? Put the Home code into `keys.home`. |
| No sound | Settings → Sound output; `pactl list short sinks` as the `tv` user. |
| Wi-Fi "unavailable" | `nmcli dev` shows `unmanaged`? Remove the device from `/etc/network/interfaces`. |
| No pointer in cursor mode | About → Cursor mode: access to `/dev/uinput`. |

Stop the shell: `sudo systemctl stop nava-tv`; start it again: `sudo systemctl start nava-tv`.

### Update

Unpack the new archive and run the installer again — it keeps your settings and
restarts the shell, no reboot needed:

```bash
tar xzf nava-tv-*.tar.gz && cd nava-tv-* && sudo ./install.sh
```

## Install on an LG TV

The `com.nava.tv_1.2.0_all.ipk` package runs on LG webOS TVs, from the 2015
models (webOS 2) to current ones. On older TVs Nava TV switches to a lighter
mode automatically (no blur, simpler wallpaper) to stay smooth.

LG lets you install apps outside the LG Content Store only through the
**Developer Mode** app:

1. Create a free account at https://webostv.developer.lge.com.
2. On the TV: LG Content Store → **Developer Mode** → sign in → turn on
   *Dev Mode Status* (the TV restarts) → turn on *Key Server*. Note the IP and
   the passphrase.
3. Install the package from a computer — either with **webOS Dev Manager**
   (a desktop app: add the TV, drop the .ipk on it) or with LG's CLI:

   ```bash
   npm install -g @webos-tools/cli
   ares-setup-device --add tv --info "{'host':'TV_IP','port':'9922','username':'prisoner'}"
   ares-novacom --device tv --getkey
   ares-install --device tv com.nava.tv_1.2.0_all.ipk
   ```

**Important:** Developer Mode lasts about 50 hours. Press *Extend* in the
Developer Mode app before it runs out — when it expires, the TV removes apps
installed this way and you need to install Nava TV again.

When Nava TV is installed, turn **Key Server** off in the Developer Mode app — it is only
needed while installing.

Services open only in the TV's own apps (Nava finds them in the TV's app list) —
never as a website. If a service's app isn't on the TV, Nava tells you to install
it; Nava Store shows which services this TV can open.

LG remote: arrows and OK, or the Magic Remote pointer. 🔴 red — search,
🟢 green — settings, 🟡 yellow — add the app in focus to favorites, 🔵 blue —
screensaver, digits — channel number. The **Home** button always opens LG's own
menu: an app can't take it over. Pin Nava TV first in the LG launcher.

## Try it on a computer

Open `demo.html` in any browser — the whole shell in one file, with demo data.
The keyboard is the remote: arrows, Enter, Esc, `/` search, `S` settings.

## License

Copyright © 2026 Nava. All rights reserved — see [LICENSE](LICENSE).
Third-party components: [NOTICE](NOTICE). Service names and logos belong to
their owners and only identify the service.
