Vitaki Fork

Vitaki Fork
Vitaki Fork
General
Author	ywnico
Type	Utilities
Version	0.06d
License	AGPL-3.0
Last Updated	2026/02/07
Links
	Download
	Website
	Source

This is a fork of AAGaming's Vitaki, a port of the open source Chiaki Remote Play client for PlayStation Vita. Chiaki allows Remote Play functionality for PlayStation 4 and PlayStation 5 consoles on various platforms. This fork adds a number of bugfixes and new features.

Features

Implemented audio.
Implemented controls.
- Control mappings for L2, R2, L3, R3, and touchpad (trapezoid button), following the official ps4 remote play maps in vs0:app/NPXS10013/keymap/. Note that Select + Start sends the PS (home) button.
- Motion controls (thanks to @Epicpkmn11, who also contributed some other controller improvements).
- Enable use of external controllers on PSTV (thanks to @TheThomasD).
Implemented external network remote play (with manually-specified remote IP addresses).
Fixed console wakeup.
Made debug logs visible, added tooltips on some buttons.
Fixed instant disconnection bug.
Disabled vblank_wait and set fps to 30 to reduce lag.
- NOTE: the fps in the config file (chiaki.toml) will be ignored.
Merged in updates from chiaki4deck (improved some connection issues).
Included ghost's LiveArea icon fixes.
Many bug and crash fixes.

User guide

Local connection

Connect PS Vita and PS5 (or PS4) to the same local WiFi network.
Log in to the same PSN account on both the PS5 and the Vita.
Open Vitaki on PS Vita.
Check settings (gear icon) to ensure your encoded PSN ID is there (if it's not automatically populated, or you accidentally deleted it, press START to re-detect it).
The console should be automatically detected and appear as an icon.
Select the console and Vitaki should ask for a registration code. On the PS5, navigate to Settings > System > Remote Play and select Pair Device. An 8-digit numeric code should appear; enter this into Vitaki and hit triangle to save.
Select the console again in Vitaki. It should now connect (and in the future, will not ask for the device pairing code).

Remote connection

UDP holepunching is not supported. Instead, a remote connection requires a static IP and port forwarding.

Register your console on your local network following the above instructions.
Follow the "manual remote connection" section in these instructions to set up a static IP and port forwarding on your network.
Select the add remote host button (the leftmost button in the toolbar) in Vitaki. Enter the remote IP address and the registered console.

If you are on the local network, your console will be discovered locally and a separate tile for remote connection will not be shown. If you want to test on the local network, turn off discovery (wifi icon in the toolbar).

Currently, Vitaki cannot detect the status of remote hosts. Therefore, when selecting one, it will both send the wakeup signal and immediately try to start remote play. If the console was asleep, then this first attempt at remote play will fail, so try again in 10 or 15 seconds.

Note: if the remote host cannot be reached, it will get stuck on "Trying to request session" for 90 seconds and then time out. If the remote host was reachable but asleep, "Trying to request session" should fail after just a few seconds.

Config settings

Some configuration lacks a UI but can be set in the config file located at ux0:data/vita-chiaki/chiaki.toml.

Swapping circle/cross in UI

circle_btn_confirm = true swaps circle and cross in the main UI, so that circle is confirm and cross is cancel (false makes cross into confirm and circle into cancel). Note that this does not affect the button mappings in remote play, only in the UI before remote play starts.

Disabling auto discovery

auto_discovery = false makes Vitaki not start discovery on launch. It can still be started manually by selecting the wifi icon.

Enabling AnalogsEnhancer plugin

enable_analogsenhancer = true makes Vitaki-fork compatible with the AnalogsEnhancer plugin. This option is false by default, since compatibility with PSTV controllers is then broken.

Priority hosts

Experimental: I don't actually have enough consoles to confirm whether this feature works or not.

The Vitaki UI is limited to 4 consoles. If you are on a crowded network with many consoles and yours isn't showing up, you can manually add the following to the config file:

[[priority_hosts]]
server_mac = "00:11:11:11:11:11"

[[priority_hosts]]
server_mac = "00:22:22:22:22:22"

and so on for each console you want to prioritize, where the MAC address is the LAN MAC address of your PS5/PS4 console (you can find it in Settings > Network > Connection Status > View Connection Status).

Note that each additional priority host should have its own priority_hosts header above it. Also, be sure to quote the MAC address. If Vitaki crashes immediately on opening, it is probably due to an invalid TOML file breaking the parser.

Controls

Map sent to PS4/5	Vita controls
`L2`	`L1` + left side of rear touch sensor
`R2`	`R1` + right side of rear touch sensor
Touchpad (trapezoid button)	front touch screen
Left analog stick button	`D-pad left` + `Square`
Right analog stick button	`D-pad right` + `Circle`
PS (home) button	`Select` + `Start`

Known issues

Latency. On remote connections (not local WLAN), it's especially bad. (Relevant GitHub issue)
Vitaki may crash with error C2-12828-1 if incompatible plugins such as reRescaler are installed. Thanks to @GuillermoAVeces for identifying this. (Relevant issue).
Typically only one stream works per launch. If the screen becomes gray and unresponsive, restart Vitaki. (Relevant issue)
In the past crashes occurred when multiple consoles are on the network, but this has likely been fixed. (Relevant issue).

If problems arise:

Try restarting Vitaki first.
Then, try deleting/renaming the config file (ux0:data/vita-chiaki/chiaki.toml).
If that doesn't help, create a new issue (or comment on an existing issue).

Changelog

v0.06d

Add support for PSTV with external controllers (thanks to @TheThomasD !).
Experimental support for manually adding a host MAC, for cases where the network has more than four consoles on it.

v0.06c

Fix manual remote connection to PS4 consoles.
Swap circle and cross in the main UI on Japanese vitas.

v0.06b

Implement 2 PRs from @Epicpkmn11.
- Add motion controls (PR #21).
- Make compatible with AnalogsEnhancer Vita (PR #22).

v0.06

Allow manual creation of remote hosts for remote play (not on local network).
Implement console wakeup.
Various UI updates.
Add some more control maps.
Fix a bunch of bugs and crashes.
- PSN ID was sometimes copied incorrectly (may have been the root of some connection issues).
- Fix some crashes with multiple host tiles in the UI.
- Various others.

v0.05

This release updates the controls to match the official PS4 remote play app options (adjustable in Vitaki settings). For images of the remote play keymaps (numbered 0, 1, 2, 3, 4, 5, 6, 7, and 25), see vs0:app/NPXS10013/keymap/. I kept my (admittedly weird) original control scheme as 99.

v0.04b

Add a workaround to address a connection issue (#2) in which the vita would connect and immediately disconnect.

v0.04

Add more controls.
Disabled vblank_wait and set fps to 30 to reduce lag.
- NOTE: the fps in the config file (chiaki.toml) will be ignored.
Made debug logs visible, added tooltips on some buttons.
Cleaned up some code, fixed some crashes and bugs.

v0.03

Merge in updates from streetpea/chiaki4deck.
Note: This was a big changeset, and it required a bit of work to get running on Vita (holepunching and rudp disabled), so there may be crashes. Working ok for me so far.

v0.02

Minor updates to aa's amazing work porting chiaki to vita.
- Fix audio.
- Fix LiveArea assets (PR from ghost).
- Merge updates from upstream chiaki.

v0.01

First Release.

External links

GitHub - https://github.com/ywnico/vitaki-fork