Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xerpi/vita2hos
[WIP] PlayStation Vita to Horizon OS (Nintendo Switch OS) translation layer
https://github.com/xerpi/vita2hos
Last synced: 7 days ago
JSON representation
[WIP] PlayStation Vita to Horizon OS (Nintendo Switch OS) translation layer
- Host: GitHub
- URL: https://github.com/xerpi/vita2hos
- Owner: xerpi
- License: gpl-2.0
- Created: 2022-02-08T18:20:31.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-10-19T08:03:22.000Z (about 1 year ago)
- Last Synced: 2024-12-23T05:03:40.151Z (14 days ago)
- Language: C
- Homepage: https://discord.gg/Z9kAsBqkbx
- Size: 3.79 MB
- Stars: 1,108
- Watchers: 67
- Forks: 33
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING.txt
Awesome Lists containing this project
- Awesome-PlayStation-Vita - vita2hos - A PlayStation Vita to Horizon OS (Nintendo Switch OS) translation layer (🕹️ Emulators / 🙅♀️ Non-Emulation)
README
# _vita2hos_
A PlayStation Vita to Horizon OS (Nintendo Switch OS) translation layer (**_not_** an emulator)
## How does it work?
PlayStation Vita (ARMv7 CPU) executables can be run natively on Nintendo Switch ARMv8 CPU in 32-bit execution mode.
When loading a PlayStation Vita executable, _vita2hos_ redirects the [module](https://wiki.henkaku.xyz/vita/Modules) imports of said executable to jump to routines that implement the same behavior, by using native Horizon OS services, like the one exposed by the original PlayStation Vita OS modules.
## How can I use it?
### Running it on a real console
1. Copy `vita2hos.nsp` to your microSD card (i.e. to: `atmosphere/vita2hos.nsp`)
2. Create [`atmosphere/config/override_config.ini`](https://github.com/Atmosphere-NX/Atmosphere/blob/master/config_templates/override_config.ini) and add the following lines to it:
```ini
[hbl_config]
override_any_app=true
override_any_app_key=R
override_any_app_address_space=32_bit
; adjust the path according to the location of your file
path=atmosphere/vita2hos.nsp
```
- Note: As long as this file exists you won't be able to use the homebrew menu and instead will always run _vita2hos_.
A quick workaround would be to rename the file and restart your Switch.
Unfortunately `override_config.ini` doesn't allow multiple `path` entries which is why it has to be done this way.
3. Copy a PlayStation Vita executable (`.velf` or `.self`/`eboot.bin`) to `sd:/vita2hos/executable`
4. Boot (or reboot) your Switch and start any game while holding down `R`
- Attempting to use _vita2hos_ via applet mode (album button) will currently result in a fatal error and wouldn't be recommended anyway.
5. Enjoy!
### Running it on yuzu
1. Copy a PlayStation Vita executable (`.velf` or `.self`/`eboot.bin`) to `sd:/vita2hos/executable` (_File_ → _Open yuzu Folder_ → `sdmc/`)
2. Run `vita2hos.nsp`
3. Enjoy!
### Running it on Ryujinx
1. Copy a PlayStation Vita executable (`.velf` or `.self`/`eboot.bin`) to `sd:/vita2hos/executable` (_File_ → _Open Ryujinx Folder_ → `sdcard/`)
2. Disable PPTC (_Options_ → _Settings_ → _System_ → Unselect _Enable PPTC (Profiled Persistent Translation Cache)_)
3. Run `vita2hos.nsp`
4. Enjoy!
## Building
1. `mkdir build && cd build`
2. Two options:\
a. `arm-none-eabi-cmake ..`\
b. `cmake -DCMAKE_TOOLCHAIN_FILE:FILEPATH=$DEVKITPRO/cmake/devkitARM.cmake ..`
3. `make` (or `ninja` if configured with `-G Ninja`)
4. `vita2hos.nsp` will be generated
I recommend passing `-DCMAKE_COLOR_DIAGNOSTICS:BOOL=TRUE`, especially when using Ninja.
## Project status, compatibility and supported features
This is still in very early stages and therefore it can only run very simple CPU-rendered PlayStation Vita homebrews.
There is very initial 3D graphics support (it can run vitasdk's GXM triangle and cube samples by hardcoding _vita2hos_'s GLSL shaders to match the Cg shaders the samples use).
## Special Thanks
A few noteworthy teams/projects who've helped along the way are:
* **[Vita3K](https://vita3k.org/)**
_vita2hos_ uses Vita3K's shader recompiler, and some parts of _vita2hos_'s code are based on Vita3K's implementation. Please, consider [**donating**](https://vita3k.org/#donate) and [**contributing**](https://vita3k.org/#contribute) to Vita3K!
* **[UAM - deko3d shader compiler](https://github.com/devkitPro/uam)**
_vita2hos_ uses UAM ([deko3d](https://github.com/devkitPro/deko3d)'s shader compiler) to compile shaders. Please, also consider contributing to that project and donating to the developers!
* **[Ryujinx](https://ryujinx.org/)**
* **[yuzu](https://yuzu-emu.org/)**
* **[Atmosphère](https://github.com/Atmosphere-NX/Atmosphere)**
* **[Switchbrew](https://github.com/switchbrew/)**
Also special thanks to @PixelyIon and @SciresM for their help, and to all the testers, especially @TSRBerry.
## Disclaimer
* **Nintendo Switch** is a trademark of **Nintendo Co., Ltd**
* **PlayStation Vita** is a trademark of **Sony Interactive Entertainment**