Vaporwave is a tool to manage, synchronize and backup ROMs and save files between different devices (computer, retro handhelds, smartphone, etc.) It's inspired in part from the e-books manager calibre.
Name is based on Steam (as the idea is to manage games and save files consistently between devices); the term vaporwave is also commonly associated with 80's/90's nostalgia, and therefore with retro gaming.
- Navigate local ROMs collection
- Add device based on its SSH connection
- Compare ROMs between computer and devices
- Compare save files between computer and devices, and detect where the more recent save files are stored
- Download/Upload ROMs files from/to devices
- Download/Upload save files from/to devices
- Tested on ArkOS with a RG351M device
- Tested on RetroOZ with a PowKiddy RGB10Max device
- Test/Add support for other devices and device OS (it's likely some OS store their ROMs differently)
- Add/Remove ROMs from collection
- Update local ROMs folder
- Improve UI/UX (file transfer progress bars, warning when user override save files that seems more recent, etc.)
- Improve save file comparison logic to better take into account cases where only the srm file was modified (the state file being the one actually containing the save states)
- Manage PPSSPP save files
- Save sync: Add a function that detects - for each ROM - the most recent save from all the locations, and uploads it to all locations. This could run in the background and sync on regular basis
- Manage multiple ROMs folders
- Manage save files and ROMs as 2 separate folders (to make it easier to backup save files on Dropbox, without uploading ROMs files )
- Sync with local RetroArch installation
- Add a nice app icon
- Download the latest version on releases page.
vaporwave-win64-jre-<version>.zip
contains the JAR (i.e. the executable), a JRE and an executable bat file. The bat file is a simple shortcut that launches the JAR file on the packaged JRE.vaporwave-linux-<version>.zip
contains the JAR and a sh file (which simply contains the commandjava -jar vaporwave.jar
).- Both zip files are basically identical. The one containing the Windows JRE is just easier to use. You can download
the
vaporwave-linux-<version>.zip
on Windows as well, as long as you know how to run the JAR.
- Decompress somewhere on your computer (it can be moved later to any folder)
- On Windows:
- Run the bat file
vaporwave.bat
- On the Windows 10 warning message, click "More Info", then "Run anyway"
- Run the bat file
- On Linux / macOS:
- Run the JAR file on Java 8 using
java -jar vaporwave.jar
. Ensure default JRE is version 8. - On Linux, the following command allows you select the default Java:
โ ~ sudo update-alternatives --config java [sudo] password for benoit: There are 4 choices for the alternative java (providing /usr/bin/java). Selection Path Priority Status ------------------------------------------------------------ 0 /usr/lib/jvm/java-14-openjdk-amd64/bin/java 1411 auto mode 1 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 manual mode 2 /usr/lib/jvm/java-14-openjdk-amd64/bin/java 1411 manual mode 3 /usr/lib/jvm/java-15-oracle/bin/java 1091 manual mode 4 /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java 1081 manual mode Press <enter> to keep the current choice[*], or type selection number: 4
- Run the JAR file on Java 8 using
- From the code:
- Import the project as a Gradle project in your IDE of choice, and run the Main.
./gradlew clean build
The script assumes a copy of the Win64 JRE is located at ~/Dev/jre1.8.0_251
. Change that line if necessary.
./dist.sh
./gradlew dependencyUpdates --refresh-dependencies
For test purpose, it's possible to add mock devices. Add the following to data/devices.json
.
{
"type": "be.encelade.vaporwave.model.devices.MockDevice",
"name": "mock",
"mockDataFileName": "ls-result-test-02",
"mockDataMd5FileName": "md5-test-02"
}
Test files can be customized.
- Update Kotlin 1.5.30 to 1.5.31
- Navigate local ROMs collection
- Add device based on its SSH connection
- Compare ROMs between computer and devices
- Compare save files between computer and devices, and detect where the more recent save files are stored
- Download/Upload ROMs files from/to devices
- Download/Upload save files from/to devices
- Tested on ArkOS with a RG351M device
- Tested on RetroOZ with a PowKiddy RGB10Max device