Repository navigation
Remote control
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.
| 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}
]}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_kernelUse 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.