script.tinyppi

A CoreELEC addon that displays detailed playback information in a custom overlay window during video playback. It provides real-time data on video, audio, HDR, system resources, and more — with special support for Amlogic hardware (e.g. CoreELEC devices).

---

Installation

Option 1 — Via Repository (recommended)

1. Open Settings → File Manager → Add Source.
2. Enter the repository URL and confirm:

   https://ce-repo.github.io/repository.jamal2362/
   

3. Go to Add-ons → Install from ZIP file and select the source you just added.
4. Install the repository ZIP file.
5. Go to Install from repository, open the repository, select TinyPPI and install.

Option 2 — Manual ZIP install

1. Download the latest .zip file.
2. Copy it to your device storage.
3. In CoreELEC: Settings → Add-ons → Install from ZIP file, then select the file.

---

Usage

Assign a remote shortcut — Easy way (Keymap Editor)

1. Install the Keymap Editor addon.
2. Open it and select Edit → Global → Add-ons.
3. Select Launch TinyPPI.
4. Press the key or button you want to assign, then confirm.
5. Go back and select Save.

Pressing the assigned key/button will now launch or close TinyPPI in the Video OSD.

Assign a remote shortcut — Manual (gen.xml)

Place the following in Userdata/keymaps/gen.xml, replacing xxxxx with your key name:

<keymap>
  <global>
    <keyboard>
      <xxxxx>RunAddon(script.tinyppi)</xxxxx>
    </keyboard>
  </global>
</keymap>

Launch from another addon or autostart (Python)

import xbmc
xbmc.executebuiltin('RunScript(script.tinyppi)')

Launch via Kodi URL

plugin://script.tinyppi/

---

Advanced Launch Arguments

TinyPPI supports additional arguments to open specific modes or apply VS10 output modes directly — without opening the overlay or the dialog first.

Open the VS10 mode selection dialog

RunScript(script.tinyppi,dialog)

Opens the VS10 mode selection dialog instead of the main TinyPPI overlay.

Apply a VS10 output mode directly

Use run_mode followed by the mode name to switch the VS10 output mode immediately. This is useful for keymap shortcuts or automation from other addons.

RunScript(script.tinyppi,run_mode,sdr8)
RunScript(script.tinyppi,run_mode,sdr10)
RunScript(script.tinyppi,run_mode,hdr10)
RunScript(script.tinyppi,run_mode,dv)
RunScript(script.tinyppi,run_mode,original_sdr)
RunScript(script.tinyppi,run_mode,original_hdr)
RunScript(script.tinyppi,run_mode,original_dv)

Mode	Description
original_sdr	Pass through SDR content unchanged
original_hdr	Pass through HDR10 content unchanged
original_dv	Pass through Dolby Vision content unchanged
hdr10	Convert to HDR10 output
dv	Convert to Dolby Vision output
sdr8	Convert to SDR 8-bit output
sdr10	Convert to SDR 10-bit output

Example: keymap shortcut for a direct mode switch

<keymap>
  <global>
    <keyboard>
      <xxxxx>RunScript(script.tinyppi,run_mode,hdr10)</xxxxx>
    </keyboard>
  </global>
</keymap>

Example: trigger from another addon (Python)

import xbmc
xbmc.executebuiltin('RunScript(script.tinyppi,run_mode,dv)')