This project provides a simple solution for synchronizing save game files between two or more MiSTer FPGA devices via a Raspberry Pi. The Pi acts as an intermediary, periodically checking for a trigger file on the MiSTer devices, and if found, synchronizing the save files between them.

Please wait for the final release. In the current state it erases save files from the second MiSTer. Working on a newer version that will back-up in two separate folders and then merge them in one folder that then wil synchonise with both devices.

This is my first project and it has not been thoroughly tested. I am not responsible for any damage or loss of save games or save states that may occur as a result of using these scripts. Please use this project at your own risk.

It's strongly recommended to take a backup of your save games and save states before using these scripts. If you encounter any issues, please report them through the GitHub issue tracking system.

Remember, you are responsible for your own data and the safety of your devices. Always take precautions when using scripts that modify, copy, or delete data.

You'll need a Raspberry Pi set up with a Unix-based OS (like Raspbian) and connected to the same network as your MiSTer devices. Ensure you have FTP and lftp installed. If not, you can install them using the following commands:

sudo apt-get update
sudo apt-get install ftp lftp

Clone this repository and copy the scripts MiSTerTrigger.sh and MiSTerSaveGames.sh into your /etc directory:

git clone https://github.com/rotami/MiSTerPiSync.git
sudo cp MiSTerPiSync/MiSTerTrigger.sh /etc/
sudo cp MiSTerPiSync/MiSTerSaveGames.sh /etc/

Remember to update the scripts with your specific details (IP addresses, FTP usernames and passwords). You edit the files with command: sudo nano /etc/MiSTerSaveGames.sh and sudo nano /etc/MiSTerTrigger.sh

Ensure the scripts are executable:

sudo chmod +x /etc/MiSTerTrigger.sh
sudo chmod +x /etc/MiSTerSaveGames.sh

Your MiSTer devices need to be setup to allow FTP access. This is typically done in the MiSTer's INI file. If you haven't done this, please consult the MiSTer FPGA project's documentation.

Ensure that your MiSTer devices are connected to the same network as your Raspberry Pi.

Copy the MiSTerSync.sh script to the scripts directory of your MiSTer devices.

Cron jobs need to be set up on your Raspberry Pi to run the scripts at regular intervals. Open the crontab editor:

crontab -e

Add the following lines at the end of the file:

* * * * * /etc/MiSTerTrigger.sh > /dev/null 2>&1
@reboot /etc/MiSTerTrigger.sh > /dev/null 2>&1

Save and close the file.

On your MiSTer device, run the MiSTerSync.sh script when you want to trigger a sync. This will create a trigger file that the Pi will detect, initiating the synchronization process.

Make sure that the IP addresses, FTP usernames and passwords in your scripts match those of your MiSTer devices and that they're connected to the same network as your Pi. Also make sure to use static ip-adresses on your router. Otherwise the ip-adresses will change from time to time and the script will fail. If you're still having issues, try running the scripts manually on your Pi and check the output for any error messages.