# reVita v.1.0 | [Wiki](../../wiki) | [PS TV Configs](https://github.com/DerpyBubblez/reVita-Configs)
**reVita** is a plugin for PS Vita / PS TV, which allows you to remap inputs and trigger different actions. It is a continuation of [Rinnegatamante](https://github.com/Rinnegatamante)'s **[remaPSV](https://github.com/Rinnegatamante/remaPSV)**, which was fully rewritten as a kernel plugin.

[Here](https://github.com/DerpyBubblez/reVita-Configs) you can find ready to use [PS TV Configs](https://github.com/DerpyBubblez/reVita-Configs) by [Derpy](https://github.com/DerpyBubblez)

![Image](/include/screenshot.png)

## Table of content
- [Functionality](#functionality)
- [Compatibility](#compatibility)
  - [Firmware compatibility](#firmware-compatibility)
  - [Compatibility with plugins](#compatibility-with-plugins)
  - [Compatibility with Apps](#compatibility-with-apps)
- [Installation](#installation)
- [Usage](#usage)
  - [Wiki](../../wiki)
- [FAQ](#faq)
- [Fixes for some Apps](#fixes-for-some-apps)
- [Known issues](#known-issues)
- [Build](#build)
- [Credits](#credits)
- [remaPSV credits](##original-credits-from-remapsv-by-rinnegatamante)



## Functionality

- Remap
  - buttons (combos too)
  - analog sticks
  - back and front touch zones
  - gyroscope movements
- Emulate 
  - buttons (combos too)
  - analog sticks, 
  - touch presses and swipes
- Turbo buttons
- Sticky butons
- Trigger system events
  - Reboot
  - Sleep
  - Power Off
  - Display Off
  - Kill current application
  - Brightness control (works on PS TV too)
  - Savegames backup/restore
- Swap touchpads
- Display native and emulated touch pointers
- Disable Gyro's deadband for better sensivity
- Virtual DS4 controller
- External controllers support
- Per-game (in Adrenaline too) and global profiles
- Themes
- and more

## Compatibility
### Firmware compatibility

- 3.60 
- 3.65

### Compatibility with plugins

Want to use DS3 / DS4 ? Check this page [here](../../wiki/External-Controllers) for more details.
- **[X1Vita](https://github.com/Ibrahim778/X1Vita)** - full compatibility.
- **[MiniVitaTV](https://github.com/TheOfficialFloW/MiniVitaTV)** - full compatibility.
- **[ds34vita](https://github.com/MERLev/ds34vita)** - full compatibility. Should be installed **after** reVita in tai config.
- **[ds4touch](https://github.com/MERLev/ds4Touch)** - full compatibility. Should be installed **after** reVita in tai config.
- **[ds3vita](https://github.com/xerpi/ds3vita)** and **[ds4vita](https://github.com/xerpi/ds4vita)** - partial compatibility, use **[ds34vita](https://github.com/MERLev/ds34vita)** instead to get full support.
- **[DSMotion](https://github.com/OperationNT414C/DSMotion)** - not compatible, use **[DS34Motion](https://github.com/MERLev/DS34Motion)** instead to get full support.

### Compatibility with Apps

- Adrenaline - to get UI working, you need to change **Adrenaline Settings -> Graphics Filtering** to anything else **except** original.
- In some of hombrews and PSP/PS1 games GUI won't work - use **Shared profile** method for them. [[How To]](https://github.com/MERLev/reVita#known-issues).

## Installation

- Copy **[ioplus.skprx](https://github.com/MERLev/reVita/releases/download/1.0/ioplus.skprx)** to **ur0:/tai** folder, add **ioplus.skprx** into your **ur0:/config.txt** config file under ***KERNEL*** section.
- Copy **reVita.skprx** to **ur0:/tai** folder, add **reVita.skprx** into your **ur0:/config.txt** config file under ***KERNEL*** section. Should be installed **before** ***ds34vita***/***ds4touch*** in tai config.
- [Optional, to get Gyro support] Copy **reVitaMotion.suprx** to **ur0:/tai** folder, add **reVitaMotion.suprx** into your **ur0:/config.txt** config file under ***MAIN*** section.

## Usage

- To bring the config menu, press **START + SQUARE**, customisable under Settings -> Hotkeys.
- Read more on the [Wiki](../../wiki)

## FAQ

- How to open plugin menu ?
  - Press (start) + (square)
- What can you do with gyro ?
  - You can remap gyro direction (up, down, left, right) to right stick directions to enable gyro aim in any game.
- Is there a way to turn it on and off?
  - **START + TRIANGLE**, customisable under Settings -> Hotkeys
- Does it save presets on a game by game basis?
  - Yes, you can use Profile -> Profile Management for more options.
- What is deadband under gyro menu ?
  - Deadband limits gyroscope sensitivity, so smallest movements are ignored to handle shaking hands, and it is enabled by default in most vita games. Disabling it will higly increase sensitivity of gyroscope.
- I forgot my custom hotkeys to open menu. How do I find it?
  - Open VitaShell and open the file ux0:data/reVita/HOTKEYS.ini. "Open menu=" has your hotkeys to open the plugin menu.
- I've set the startup delay too low on a game and now it crashes when launching it. What do I do?
  - Hold (Start) when launching the game. It starts the plugin in safe mode, with a blank profile. Then load your profile, change the startup delay and save profile in profile manager.

## Fixes for some Apps
- MiniVitaTV
  - Adrenaline
    - Fix Adrenaline crash when pressing the DS4 TouchPad button - Remap DS4 TouchPad to anything.
    - Fix Vita inputs on PSX games - Enable "Vita as virtual DS4".
  - Retroarch
    - Fix Vita inputs on latest versions of Retroarch- Enable **"Vita as virtual DS4"**.
    
## Known issues

- Menu not opening in Adrenaline
  - Change **Adrenaline Settings -> Graphics Filtering** to anything else **except** original.
- Menu not opening
  - Minimise app
  - Setup config you need while on LiveArea
  - Save it as Shared profile (Profile > Profile management > Save as Shared)
  - Go back to the game
  - Press **START**+**CROSS**(configurable under Settings > Hotkeys) to import Shared profile.
- "Buy more RAM" error popup on menu open - means there is not enough RAM for plugin to initialise it's menu. Seems to be caused by usage of other heavy plugins, especially ucdc and PSVShell.
- Crash, when closing the menu
  - update reVita and ds34vita to latest versions (from github) 
## Build
- Make install **[ds34vita](https://github.com/MERLev/ds34vita)**.
- Make install **[DS34Motion](https://github.com/MERLev/DS34Motion)**
- Make install kernel module
```bash
cd reVita
mkdir build
cd build
cmake ..
make install
```
- Make motion module
```bash
cd reVitaMotion
mkdir build
cd build
cmake ..
make
```

## Credits

Thanks to evryone who helped me along the way :
- [bosshunter](https://github.com/bosshunter), for doing most of the testing and supplying me with ideas.
- [Rinnegatamante](https://github.com/Rinnegatamante), [remaPSV](https://github.com/Rinnegatamante/remaPSV) author, for various help provided.
- [spectreseven1138](https://github.com/spectreseven1138), for secondary profile implementation
- [S1ngyy](https://github.com/S1ngyy), for providing code for analogs/gyro support
- [pablojrl123](https://github.com/pablojrl123), for customizable buttons activation code.
- [Bythos](https://github.com/bythos14), for help with reversing, fixing libk and other general stuff.
- [ellipticaldoor](https://github.com/ellipticaldoor) for testing.
- [teakhanirons](https://github.com/teakhanirons) for various help and advices.
- [Princess-of-Sleeping](https://github.com/Princess-of-Sleeping) for help with reversing.
- Derpy (Cassie) for testing.
- W0lfwang for testing.
- [TheIronUniverse](https://github.com/TheIronUniverse) for testing.
- mantixero for testing it in PS4link.
- [MightySashiman](https://github.com/mightysashiman) for testing.
- Kiiro Yakumo for testing it in PS4Link.
- Nino1026 for testing.
- [Vita Nuova](https://t.co/3Efi3PGwK5?amp=1) communinity for all the help and support I got there.
- [HENkaku](https://discord.gg/m7MwpKA) communinity for various help.

Projects, which code was reused:
- [remaPSV](https://github.com/Rinnegatamante/remaPSV) - original plugin.
- [PSVshell](https://github.com/Electry/PSVshell) - process management and UI.
- [VitaShell](https://github.com/TheOfficialFloW/VitaShell) - FIO.
- [DSMotion](https://github.com/OperationNT414C/DSMotion) - cross-plugin communication.
- [BetterTrackPlug](https://github.com/fmudanyali/BetterTrackPlug) - Adrenaline integration.

## Original credits from [remaPSV](https://github.com/Rinnegatamante/remaPSV) by [Rinnegatamante](https://github.com//Rinnegatamante)

- Dmaskell92 for testing the plugin.
- All my Patroners for their awesome support:
- nobodywasishere
- RaveHeart
- Tain Sueiras
- 2Mourty
- Andyways
- ArkaniteOnVita
- Artūrs Lubāns
- BOBdotEXE
- ckPRO
- Count Duckula
- Daniel
- Eduardo Minguez
- Elwood Blues
- Gelson Silva
- Igor Kovacs Biscaia
- Jared Breland
- Lars Zondervan
- Mored1984
- gnmmarechal
- Oleg Des
- Pirloui
- rsn8887
- Samuel Batista
- styroteqe
- suLac4ever
- T33Hud
- Troy Murray
- Yakara Network
- PSX-Place.com