Chiaki-lg

A native port of chiaki-ng for LG webOS smart TVs. Streams PS4/PS5 Remote Play directly to your LG webOS TV.

Tested on: PS5 + webOS 5+. PS4 and webOS 4.x are supported in the code and should work, but have not been directly tested. Please open an issue if you encounter problems on those platforms.

AI disclosure: This project was developed with assistance from Claude.ai, ChatGPT, and Google Gemini. All generated code was reviewed, tested, and integrated by the project author.

Features

PS4 and PS5 Remote Play over local network
1080p60 streaming with H.265, H.265 HDR, or H.264 video codecs
Hardware video decode via webOS NDL (direct media pipeline) — video is decoded on a dedicated hardware plane below the app surface, not software-rendered
Native Opus audio passthrough — raw Opus packets fed directly to webOS NDL hardware decoder (no software decode step)
Minimal built-in GUI — a lightweight launcher screen on every launch lets you enter your PS5's IP, import your chiaki-ng config, adjust settings, and connect
Full gamepad support — DualSense, DualShock 4, Xbox Wireless Controller, and other Bluetooth/USB gamepads via direct evdev with exclusive grab (EVIOCGRAB)
chiaki-ng settings import — drop a chiaki-ng-Default.ini export file onto the TV to auto-import registration credentials (PS5 IP still required)
Wake-on-LAN — wakes PS5 from rest mode before connecting (UDP broadcast + unicast)
PSN cloud wakeup — optional Sony push-notification wakeup via PSN session API when local UDP wakeup is unreliable (requires PSN refresh token)
Sleep-on-exit — sends PS5 to rest mode when you quit the app
Auto-reconnect — retries on transient network errors; exits cleanly on deliberate disconnects
Stats overlay — real-time bitrate, FPS, codec, and latency display toggled with the TV remote UP button
webOS version auto-detection — automatically selects the correct NDL backend (ndl-webos5 or ndl-webos4) at runtime
Two-tier logging — critical diagnostics always written; verbose chatter gated by log_level

Quick start

Step 1 — Download and install

Download the latest .ipk from the Releases page, then install it on your TV:

ares-setup-device   # one-time TV setup — TV must be on and in Developer Mode
ares-install --device myTV chiaki-lg_*.ipk

Or use WebOS Dev Manager if you prefer a GUI — it can install IPKs directly via drag and drop.

TV requirements: LG webOS 4.x or 5+ TV with Homebrew Channel installed and Developer Mode enabled.

Step 2 — Export your chiaki-ng registration

Chiaki-lg does not handle PS5 registration itself. You must have already registered with your PS5 using chiaki-ng on Windows, Linux, MacOS. This is a one-time step.

On Computer (Win/Linux/MacOS):

Open chiaki-ng
Go to Settings → Config → Export Settings To File
Copy/use that file and rename it chiaki-ng-Default.ini if needed

Step 3 — Copy the file to the TV

adb push chiaki-ng-Default.ini \
  /media/developer/apps/usr/palm/applications/org.homebrew.chiaki/chiaki-ng-Default.ini

Or transfer via WebOS Dev Manager's file browser.

Step 4 — Launch and connect

Launch Chiaki-lg on the TV
Enter the local IP address of your PS5 and click Import Config. The .ini file is renamed to .imported after a successful import so it won't be reprocessed
Open Settings and change anything as needed
Select Connect — streaming starts immediately

The .ini file does not contain your PS5's IP address. You must enter it manually before importing.

Configuration

Config file location on the TV:

/media/developer/apps/usr/palm/applications/org.homebrew.chiaki/config.json

Most settings are managed through the in-app Settings screen. You can also edit the file directly via SSH or WebOS Dev Manager.

Example config

{
    "host": "192.168.1.100",
    "ps5": true,
    "psn_account_id": "",
    "registered_key": "",
    "rp_key": "",
    "rp_key_type": 2,
    "video_width": 1920,
    "video_height": 1080,
    "video_fps": 60,
    "video_bitrate": 15000,
    "video_codec": "h265",
    "audio_volume": 100,
    "wakeup": true,
    "ps5_mac": "AA:BB:CC:DD:EE:FF",
    "wakeup_delay_ms": 60000,
    "sleep_on_exit": true,
    "log_level": "warning",
    "psn_refresh_token": ""
}

Config reference

Field	Type	Default	Description
`host`	string	`""`	PS5/PS4 local IP address
`ps5`	bool	`true`	`true` for PS5, `false` for PS4
`psn_account_id`	string	`""`	PSN account ID (base64) — written by import
`registered_key`	string	`""`	Registration key (base64) — written by import
`rp_key`	string	`""`	Remote Play key (base64) — written by import
`rp_key_type`	int	`0`	RP key type — written by import
`video_width`	int	`1920`	Stream width
`video_height`	int	`1080`	Stream height
`video_fps`	int	`60`	Stream frame rate
`video_bitrate`	int	`15000`	Target bitrate in kbps
`video_codec`	string	`"h265"`	`"h265"`, `"h265_hdr"`, or `"h264"` (PS4 always uses H.264)
`audio_volume`	int	`100`	Audio volume (0–100)
`wakeup`	bool	`false`	Send wakeup packets before connecting
`ps5_mac`	string	`""`	PS5 MAC address (used for Wake-on-LAN)
`wakeup_delay_ms`	int	`60000`	Max time (ms) to wait for PS5 to wake
`sleep_on_exit`	bool	`false`	Send PS5 to rest mode on app exit
`ss4s_module`	string	`"auto"`	SS4S backend. `"auto"` detects webOS version at startup and selects `ndl-webos5` (webOS 5+) or `ndl-webos4` (webOS 4.x) automatically. Override only if auto-detection fails.
`log_level`	string	`"warning"`	`"off"`, `"error"`, `"warning"`, `"info"`, `"verbose"`, `"debug"`
`psn_refresh_token`	string	`""`	PSN OAuth2 refresh token for cloud wakeup (optional — see below)

PSN cloud wakeup (optional)

If your PS5 ignores local UDP wakeup packets, you can enable PSN cloud wakeup. Copy the psn_refresh_token value from your chiaki-ng config:

Windows: %APPDATA%\Roaming\Chiaki\Chiaki.conf → field psn_refresh_token under [General]
Linux: ~/.config/Chiaki/Chiaki.conf → same field

Paste the value (beginning with v3.) into psn_refresh_token in config.json. The app uses Sony's push notification service as the primary wakeup method with local UDP as fallback. The token is valid for approximately 60 days. Also confirm that PS5 Settings → System → Power Saving → Features Available in Rest Mode → Enable Turning On PS5 from Network is enabled.

Gamepad support

Connect a gamepad via Bluetooth or USB. Supported controllers include DualSense, DualShock 4, Xbox Wireless Controller, and most HID-compliant gamepads.

The app uses direct evdev access with EVIOCGRAB to take exclusive control of the gamepad at the kernel level, preventing webOS from intercepting buttons (B→Back, A→OK, Guide→Home).

The TV remote is not forwarded to the PS5 as controller input. During streaming it serves only:

TV Remote Button	Action
Up (hold 0.5 s)	Toggle stats overlay
Up (short press)	Forwarded to PS5 as D-pad up
Back	Exit the app
Home	Exit the app

Logs

Logs are written to /tmp/chiaki.log on the TV (cleared on each launch).

# Stream logs live
ares-shell --device myTV -- "tail -f /tmp/chiaki.log"

# Download the log
ares-shell --device myTV -- "cat /tmp/chiaki.log" > chiaki.log

Set "log_level": "info" or "debug" in config.json for more detail. Critical events (session lifecycle, wakeup, errors) are always logged regardless of level.

Troubleshooting

Stream doesn't start / connection timeout Ensure Remote Play is enabled on your PS5 (Settings → System → Remote Play → Enable Remote Play). Verify the IP in config.json and that the TV and PS5 are on the same subnet.

Black screen with audio Likely a codec or NDL issue. Check logs. Try "video_codec": "h264" as a fallback — H.264 has broader compatibility across NDL versions.

Black screen on webOS 4 Check /tmp/chiaki.log for the [AUTO] line confirming which SS4S module was selected. If auto-detection chose ndl-webos5 incorrectly, set "ss4s_module": "ndl-webos4" in config.json manually.

PS5 won't wake from rest mode Add your psn_refresh_token to config.json to enable PSN cloud wakeup (see above).

Gamepad buttons intercepted by webOS Check logs for EVIOCGRAB FAILED. Disconnect and reconnect the controller after launching the app.

Import not working / file not found Ensure the file is named exactly chiaki-ng-Default.ini and placed in: /media/developer/apps/usr/palm/applications/org.homebrew.chiaki/

App crashes on launch Usually a malformed config.json. Check /tmp/chiaki.log. Delete the config file to let the app recreate defaults, then repeat the import.

Architecture

Video pipeline

H.264/H.265 NAL units from the chiaki-ng callback are fed directly to SS4S_PlayerVideoFeed(), which routes them to webOS NDL's hardware video decoder. NDL renders on a hardware plane below the app's OpenGL surface. The EGL surface is configured with an 8-bit alpha channel and cleared to transparent each frame so the video plane shows through. The SDL/GL layer is only used for UI overlays.

Audio pipeline

Raw Opus packets from the chiaki-ng audio callback are fed directly to SS4S_PlayerAudioFeed() with codec SS4S_AUDIO_OPUS. webOS NDL has native Opus hardware decoding — there is no software decode step.

Input pipeline

Gamepad input uses direct Linux evdev reads with EVIOCGRAB for exclusive device access, bypassing SDL's joystick subsystem. The evdev reader runs in a dedicated thread and pushes ChiakiControllerState updates directly to the chiaki session.

webOS version auto-detection

At startup, the app reads /var/run/nyx/os_info.json (present on all webOS devices) to determine the major webOS version, then selects ndl-webos5 (webOS 5+) or ndl-webos4 (webOS 4.x). If that file is unreadable it falls back to probing for libndl-directmedia2.so on disk. The result is logged as [AUTO] in /tmp/chiaki.log.

Building from source

Most users should download the IPK from the Releases page. Build from source only if you want to make code changes or the pre-built IPK doesn't work for your TV.

Requirements

Linux or WSL2 build machine
GCC, CMake ≥ 3.16, make, pkg-config, wget, git, Python 3 + pip
webOS native SDK toolchain — extract and run relocate-sdk.sh
ares-cli in PATH

pip3 install nanopb protobuf --break-system-packages

WSL users: keep source files on a Linux filesystem (~/) rather than /mnt/c/. Always build via ./build-webos.sh — not cmake --build directly.

Build

git clone https://github.com/streetpea/chiaki-ng.git
git clone <this-repo-url> chiaki-lg
cd chiaki-lg

export TOOLCHAIN_DIR=~/webos-sdk/arm-webos-linux-gnueabi_sdk-buildroot
./build-webos.sh ../chiaki-ng 2>&1 | tee build.log

The script cross-compiles all dependencies (OpenSSL, Opus, FFmpeg, json-c, miniupnpc, cURL, GF-Complete, Jerasure, SS4S), patches chiaki-ng sources for webOS glibc compatibility, pre-generates nanopb protobuf sources, builds the binary, and packages an .ipk via ares-package. Dependencies are cached in /tmp/webos-staging and skipped on subsequent runs.

The IPK is output to build-webos/*.ipk.

Common build errors

"cannot find -lchiaki" or "Syntax error: ( unexpected" — You ran cmake --build directly. Always use ./build-webos.sh.

"nanopb_generator.py not found" — Run pip3 install nanopb --break-system-packages.

Source files

File	Purpose
`main.c`	Entry point, session lifecycle, wakeup (UDP + PSN cloud), webOS version detection, SDL event loop
`config.c` / `config.h`	JSON config loader, default config generation
`config_import.c` / `config_import.h`	chiaki-ng INI settings import
`video.c` / `video.h`	Video callback → SS4S/NDL feed, codec negotiation, stats counters
`audio.c` / `audio.h`	Audio callback → SS4S/NDL Opus feed
`input.c` / `input.h`	Evdev gamepad reader thread with `EVIOCGRAB`
`ui.c` / `ui.h`	Launcher UI, settings screen, loading screen, stats overlay renderer
`stats.c` / `stats.h`	Thread-safe stream statistics and overlay state
`app_log.h`	Shared logging macros
`NDL_directmedia.h`	webOS NDL API declarations
`CMakeLists.txt`	Build system
`build-webos.sh`	One-shot cross-compile + IPK packaging script
`appinfo.json`	webOS app metadata
`config.json`	Default config (deployed to TV, populated on first run)
`config_json.example`	Annotated config template

Dependencies

Library	Version	Link	Purpose
chiaki-ng	main	static	PS Remote Play protocol
SS4S	—	dynamic	webOS NDL video/audio abstraction (ndl-webos4 + ndl-webos5)
OpenSSL	3.2.1	static	TLS for PSN API, crypto for chiaki
Opus	1.4	static	Audio codec (chiaki internal use)
FFmpeg	6.1.1	static	H.264/H.265 codec support
json-c	0.17	static	Config file parsing
cURL	8.7.1	static	PSN API HTTP calls
miniupnpc	2.2.7	static	UPnP (chiaki dependency)
GF-Complete	master	static	Erasure coding (chiaki dependency)
Jerasure	2.0	static	FEC (chiaki dependency)
SDL2	2.30.x	dynamic	Window/GL surface, TV remote input
nanopb	0.4.x	static	Protobuf (chiaki submodule)

License

AGPL-3.0 — same as chiaki-ng, on which this project is based.

Name		Name	Last commit message	Last commit date
packaging		packaging
src		src
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
README.md		README.md
build-webos.sh		build-webos.sh

Navigation Menu

Repository files navigation

Chiaki-lg

Features

Quick start

Step 1 — Download and install

Step 2 — Export your chiaki-ng registration

Step 3 — Copy the file to the TV

Step 4 — Launch and connect

Configuration

Example config

Config reference

PSN cloud wakeup (optional)

Gamepad support

Logs

Troubleshooting

Architecture

Video pipeline

Audio pipeline

Input pipeline

webOS version auto-detection

Building from source

Requirements

Build

Common build errors

Source files

Dependencies

License

About

Releases

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Chiaki-lg

Features

Quick start

Step 1 — Download and install

Step 2 — Export your chiaki-ng registration

Step 3 — Copy the file to the TV

Step 4 — Launch and connect

Configuration

Example config

Config reference

PSN cloud wakeup (optional)

Gamepad support

Logs

Troubleshooting

Architecture

Video pipeline

Audio pipeline

Input pipeline

webOS version auto-detection

Building from source

Requirements

Build

Common build errors

Source files

Dependencies

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages