chiaki-lg

KO | EN

gitlite — search

#ai #go #golang #rust #deep-learning #docker #macos #nodejs #awesome #vue #awesome-list #pytorch #security #ios

(★ 12)

Port of Chiaki-ng to WebOS

chiaki-lg 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Chiaki-lg

A native port of [chiaki-ng](https://github.com/streetpea/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](https://claude.ai), [ChatGPT](https://chat.openai.com), and [Google Gemini](https://gemini.google.com). 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](../../releases/latest) page, then install it on your TV:

```bash
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](https://github.com/webosbrew/dev-manager-desktop) 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](https://github.com/webosbrew/webos-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](https://github.com/streetpea/chiaki-ng) on Windows, Linux, MacOS. This is a one-time step.

**On Computer (Win/Linux/MacOS):**
1. Open chiaki-ng
2. Go to **Settings → Config → Export Settings To File**
3. Copy/use that file and rename it `chiaki-ng-Default.ini` if needed

### Step 3 — Copy the file to the TV

```bash
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](https://github.com/webosbrew/dev-manager-desktop)'s file browser.

### Step 4 — Launch and connect

1. Launch **Chiaki-lg** on the TV
2. 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
3. Open **Settings** and change anything as needed
4. 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

```json
{
    "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).

```bash
# 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](../../releases/latest) 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](https://github.com/webosbrew/native-toolchain) — extract and run `relocate-sdk.sh`
- [ares-cli](https://github.com/webosbrew/ares-cli-rs) in PATH

```bash
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

```bash
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](https://github.com/streetpea/chiaki-ng), on which this project is based.

chiaki-lg

chiaki-lg 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

chiaki-lg

chiaki-lg 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README