Skip to content

Remote control

Paul Becker edited this page Nov 9, 2026 · 2 revisions

CCCBib takes its commands as webOS launch parameters so the TV needs no open port. It is off by default. Turn it on once in Settings (Playback, then Remote Control). Tried on a real TV with luna-send, an MQTT client and Home Assistant.

A command is a small JSON object. If the app is not running it starts and runs the command. If it is already running it just gets the command and nothing restarts. An app that sits behind another app stays there and only play brigns it to the front. An app that was not running always starts in front.

Commands

Command Parameters
play (or only link) link is a media.ccc.de/v/... link (https:// is optional), nothing else is accepted. Optional: start (seconds), aspect (auto, zoom or stretch), subtitle (language code or none), language (audio language code). Without a link it continues the open talk
pause, resume, toggle, stop none (stop closes the player)
seek to (seconds) or by (seconds, negative goes back)
mute value true or false, without it the state toggles
aspect value: auto, zoom or stretch
speed value: 0.5 to 2 in steps of 0.25
subtitle value: language code or none
language value: audio language code
add link, links or items (a list like in the example below). Adds to the watchlist. With a position (seconds) or percent the talk also goes on the in progress list (Continue Watching)
remove link or links. Removes from the watchlist only
progress link with position (seconds) or percent, or items. The talk shows up on the in progress list and the watchlist stays as it is. Under 10 seconds clears the progress
progress-set items replaces the whole in progress list
progress-clear link or links, removes the progress

Every link is checked and talks that fail the check are skipped. progress-set changes nothing if one link in the list is not valid or cannot be loaded. A command takes up to 50 links and the in progress list never holds more than 20 talks (the most recent ones).

Example (send a whole in progress list):

{"cmd": "progress-set", "items": [
  {"link": "https://media.ccc.de/v/24c3-2303-en-inside_the_macosx_kernel", "position": 1200},
  {"link": "https://media.ccc.de/v/25c3-2874-en-the_ultimate_commodore_64_talk", "percent": 40}
]}

Sending commands

From a shell on the TV:

luna-send -n 1 luna://com.webos.service.applicationmanager/launch \
  '{"id":"org.webosbrew.cccbib","params":{"cmd":"play","link":"https://media.ccc.de/v/24c3-2303-en-inside_the_macosx_kernel","aspect":"zoom"}}'

From a computer with the webOS CLI: ares-launch org.webosbrew.cccbib -p '{"cmd":"pause"}'.

From Home Assistant (core LG webOS TV integration):

service: webostv.command
data:
  entity_id: media_player.lg_tv
  command: system.launcher/launch
  payload:
    id: org.webosbrew.cccbib
    params:
      cmd: play
      link: https://media.ccc.de/v/24c3-2303-en-inside_the_macosx_kernel

Reading the state

Use the TV's web inspector (port 9998). window.cccbib.report() in the app page returns state (playing or paused or idle), now (title and link and position of the talk), focused (the talk the remote or pointer is on in a list or grid) and your watchlist and in progress list. The page title is CCCBib - <talk title> while a talk is open and CCCBib otherwise. With the inspector on, curl -s http://<tv-ip>:9998/json/list shows it as title.

Zoom and Stretch only work when the app was installed the normal way (yarn deploy, ares-install or the Homebrew Channel). Copying the files onto the TV by hand skips that.

Clone this wiki locally