Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Vitaki Fork: Difference between revisions

From GameBrew
Created page with "{{Infobox Vita Homebrews |title=Vitaki Fork |image=VitakiForkVita.png |description=PlayStation 4/5 Remote Play for PS Vita. |author=ywnico |lastupdated=2025/02/24 |type=Utilities |version=0.06c |license=AGPL-3.0 |download=https://dlhb.gamebrew.org/vitahomebrews/VitakiForkVita.7z |website=https://github.com/ywnico/vitaki-fork |source=https://github.com/ywnico/vitaki-fork |donation= }} {{#seo: |title=Vita Homebrew Apps (Utilities) - GameBrew |title_mode=append |image=Vitak..."
 
No edit summary
Line 2: Line 2:
|title=Vitaki Fork
|title=Vitaki Fork
|image=VitakiForkVita.png
|image=VitakiForkVita.png
|description=PlayStation 4/5 Remote Play for PS Vita.
|description=Mod of Vitaki with bugfixes and new features.
|author=ywnico
|author=ywnico
|lastupdated=2025/02/24
|lastupdated=2025/02/24
Line 19: Line 19:
|image_alt=Vitaki Fork
|image_alt=Vitaki Fork
}}
}}
Vitaki Fork is a feature-enhanced fork of AAGaming's [[Vitaki Vita]], itself a port of the open source Chiaki Remote Play client for PlayStation Vita. Chiaki enables Remote Play functionality for PlayStation 4 and PlayStation 5 consoles on various platforms. This fork adds audio support, improved controls, motion input, and network remote play capabilities, specifically optimized for the PS Vita.
This is a fork of AAGaming's [[Vitaki Vita|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.


==News and Improvements in the Fork==
==Features==
*Full audio support
* Implemented audio.
*Extended control mappings including L2, R2, L3, R3, and the trapezoid touchpad button aligned with official PS4 Remote Play controls
* Implemented controls.
*Motion controls integration
** Control mappings for L2, R2, L3, R3, and touchpad (trapezoid button), following the official ps4 remote play maps in <code>vs0:app/NPXS10013/keymap/</code>. Note that <code>Select</code> + <code>Start</code> sends the PS (home) button.
*External network remote play using manually specified remote IP addresses
** Motion controls (thanks to [https://github.com/Epicpkmn11 @Epicpkmn11], who also contributed some other controller improvements).
*Console wakeup fixes
* Implemented external network remote play (with manually-specified remote IP addresses).
*Visible debug logs and button tooltips
* Fixed console wakeup.
*Instant disconnection bug fixes
* Made debug logs visible, added tooltips on some buttons.
*Lag reduction by disabling vblank_wait and capping FPS at 30
* Fixed instant disconnection bug.
*Merged improvements from the chiaki4deck project to enhance connection stability
* Disabled <code>vblank_wait</code> and set fps to 30 to reduce lag.
*LiveArea icon fixes
** NOTE: the fps in the config file (<code>chiaki.toml</code>) will be ignored.
*Numerous crash mitigation and bug fixes
* Merged in updates from chiaki4deck (improved some connection issues).
* Included [https://git.catvibers.me/aa/chiaki/pulls/13 ghost's LiveArea icon fixes].
* Many bug and crash fixes.


==Usage Instructions==
==User guide==
===Local Connection===
=== Local connection ===
*Connect your PS Vita and PS5 (or PS4) to the same WiFi network.
* Connect PS Vita and PS5 (or PS4) to the same local WiFi network.
*Sign into the same PlayStation Network (PSN) account on both devices.
* Log in to the same PSN account on both the PS5 and the Vita.
*Launch Vitaki on your PS Vita; ensure your encoded PSN ID is detected or manually refresh it.
* Open Vitaki on PS Vita.
*Your console should be detected automatically; select it to register using an 8-digit pairing code obtained from your PS5/PS4 under Settings > System > Remote Play > Pair Device.
* 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).
*Once registered, select the console again to start a Remote Play session.
* The console should be automatically detected and appear as an icon.
===Remote Connection===
* Select the console and Vitaki should ask for a registration code. On the PS5, navigate to <code>Settings &gt; System &gt; Remote Play</code> and select <code>Pair Device</code>. An 8-digit numeric code should appear; enter this into Vitaki and hit triangle to save.
*Requires setting a static IP and port forwarding on your network (UDP holepunching is unsupported).
* Select the console again in Vitaki. It should now connect (and in the future, will not ask for the device pairing code).
*Register the console locally first as above.
 
*Use the “Add remote host” feature in Vitaki to enter the remote IP and connect.
=== Remote connection ===
*Remote hosts cannot currently be status-detected; connections may require retry if the console was asleep.
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 &quot;manual remote connection&quot; section in [https://streetpea.github.io/chiaki-ng/setup/remoteconnection/#manual-remote-connection these instructions] to set up a static IP and port forwarding on your network.
* Select the <code>add remote host</code> 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 &quot;Trying to request session&quot; for 90 seconds and then time out. If the remote host was reachable but asleep, &quot;Trying to request session&quot; should fail after just a few seconds.
 
=== Config settings ===
Some configuration lacks a UI but can be set in the config file located at <code>ux0:data/vita-chiaki/chiaki.toml</code>.
 
* <code>circle_btn_confirm = true</code> swaps circle and cross in the main UI, so that circle is confirm and cross is cancel (<code>false</code> 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.
* <code>auto_discovery = false</code> makes Vitaki not start discovery on launch. It can still be started manually by selecting the wifi icon.


==Controls==
==Controls==
Line 72: Line 89:
|}
|}


==Known Issues==
==Known issues==
* Latency:  Especially on remote connections (not local WiFi).
* Latency. On remote connections (not local WLAN), it's especially bad. ([https://github.com/ywnico/vitaki-fork/issues/12 Relevant GitHub issue])
* Crash (C2-12828-1):  May occur if incompatible plugins such as reRescaler are installed.
* Vitaki may crash with error C2-12828-1 if incompatible plugins such as reRescaler are installed. Thanks to [https://github.com/GuillermoAVeces @GuillermoAVeces] for identifying this. ([https://github.com/ywnico/vitaki-fork/issues/1 Relevant issue]).
* Only one session per launch:  Typically, only one stream runs per app launch. If your screen goes gray and unresponsive, restart Vitaki.
* Typically only one stream works per launch. If the screen becomes gray and unresponsive, restart Vitaki. ([https://github.com/ywnico/vitaki-fork/issues/16 Relevant issue])
*Multiple consoles:  Used to cause crashes, but this has likely been fixed.
* In the past crashes occurred when multiple consoles are on the network, but this has likely been fixed. ([https://github.com/ywnico/vitaki-fork/issues/6 Relevant issue]).
**In case of problems:
 
***Try restarting Vitaki first.
If problems arise:
***Try deleting/renaming the configuration file ( ux0:data/vita-chiaki/chiaki.toml).
* Try restarting Vitaki first.
***If the problem persists, please report it (or comment on an existing issue) on the [https://github.com/ywnico/vitaki-fork project's GitHub page].
* Then, try deleting/renaming the config file (<code>ux0:data/vita-chiaki/chiaki.toml</code>).
* If that doesn't help, create a new [https://github.com/ywnico/vitaki-fork/issues issue] (or comment on an existing issue).


==Changelog==  
==Changelog==  
'''v0.06c'''
'''v0.06c'''
*Fix manual remote connection to PS4 consoles
*Fix manual remote connection to PS4 consoles.
*Swap circle and cross in the main UI on Japanese vitas
*Swap circle and cross in the main UI on Japanese vitas.
'''v0.06b'''
'''v0.06b'''
*Implement 2 PRs from @Epicpkmn11
*Implement 2 PRs from @Epicpkmn11.
**Add motion controls (PR [https://github.com/ywnico/vitaki-fork/pull/21 #21])
**Add motion controls (PR [https://github.com/ywnico/vitaki-fork/pull/21 #21]).
**Make compatible with [[AnalogsEnhancer Vita]] (PR [https://github.com/ywnico/vitaki-fork/pull/22 #22])
**Make compatible with [[AnalogsEnhancer Vita]] (PR [https://github.com/ywnico/vitaki-fork/pull/22 #22]).
'''v0.06'''
'''v0.06'''
*Allow manual creation of remote hosts for remote play (not on local network)
*Allow manual creation of remote hosts for remote play (not on local network).
*Implement console wakeup
*Implement console wakeup.
*Various UI updates
*Various UI updates.
*Add some more control maps
*Add some more control maps.
*Fix a bunch of bugs and crashes
*Fix a bunch of bugs and crashes.
**PSN ID was sometimes copied incorrectly (may have been the root of some connection issues)
**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
**Fix some crashes with multiple host tiles in the UI.
**Various others
**Various others.
'''v0.05'''
'''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.
*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.
Line 106: Line 124:
*Add more controls.  
*Add more controls.  
*Disabled vblank_wait and set fps to 30 to reduce lag.
*Disabled vblank_wait and set fps to 30 to reduce lag.
**NOTE: the fps in the config file (chiaki.toml) will be ignored
**NOTE: the fps in the config file (chiaki.toml) will be ignored.
*Made debug logs visible, added tooltips on some buttons
*Made debug logs visible, added tooltips on some buttons.
*Cleaned up some code, fixed some crashes and bugs
*Cleaned up some code, fixed some crashes and bugs.
'''v0.03'''
'''v0.03'''
*Merge in updates from streetpea/chiaki4deck.
*Merge in updates from streetpea/chiaki4deck.
Line 114: Line 132:
'''v0.02'''
'''v0.02'''
*Minor updates to [https://git.catvibers.me/aa/chiaki aa's amazing work] porting chiaki to vita.
*Minor updates to [https://git.catvibers.me/aa/chiaki aa's amazing work] porting chiaki to vita.
**Fix audio
**Fix audio.
**Fix LiveArea assets ([https://git.catvibers.me/aa/chiaki/pulls/13 PR from ghost])
**Fix LiveArea assets ([https://git.catvibers.me/aa/chiaki/pulls/13 PR from ghost]).
**Merge updates from upstream chiaki
**Merge updates from upstream chiaki.
'''v0.01'''
'''v0.01'''
* First Release.
* First Release.


== External links ==
== External links ==
* Github - https://github.com/ywnico/vitaki-fork
* GitHub - https://github.com/ywnico/vitaki-fork

Revision as of 04:42, 5 October 2025

Vitaki Fork
General
Authorywnico
TypeUtilities
Version0.06c
LicenseAGPL-3.0
Last Updated2025/02/24
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).
  • 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.

  • 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.
  • auto_discovery = false makes Vitaki not start discovery on launch. It can still be started manually by selecting the wifi icon.

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.06c

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

v0.06b

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

v0.01

  • First Release.

External links

Advertising: