GitHub - BernaLang/savesync: Sync your game saves across multiple devices automatically using Google Drive! Can be used at runtime or via the GUI, enjoy!

BernaLang / savesync Public

Notifications You must be signed in to change notification settings
Fork 0
Star 1

Sync your game saves across multiple devices automatically using Google Drive! Can be used at runtime or via the GUI, enjoy!

1 star 0 forks Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
.gitignore		.gitignore
README.txt		README.txt
icon.ico		icon.ico
icon.png		icon.png
icon_old.png		icon_old.png
savesync.py		savesync.py
savesync.spec		savesync.spec

Repository files navigation

===========================================
        SaveSync - Game Save Manager
===========================================

Sync your game saves to Google Drive automatically.
Download saves before playing, upload after closing.

# Instalation and usage
- Get the latest release from the github Releases
- On the app, add your google client credentials generated in the google console
- Configure a game + create a shortcut that auto runs the app and the game
- Enjoy savefiles synced across PCs :)


## DEV

-------------------------------------------
REQUIREMENTS
-------------------------------------------
- Python 3.10+
- Dependencies: pip install pydrive2 winshell pywin32

-------------------------------------------
HOW TO RUN (Development)
-------------------------------------------
GUI Mode:    python savesync.py
CLI Mode:    python savesync.py --game <game_id>
Help:        python savesync.py --help

-------------------------------------------
HOW TO BUILD EXE
-------------------------------------------
1. Install PyInstaller:
   pip install pyinstaller

2. Build the executable:
   pyinstaller savesync.spec --noconfirm

3. Find EXE in: dist\SaveSync_v<version>.exe

-------------------------------------------
HOW TO UPDATE VERSION
-------------------------------------------
1. Edit savesync.py, line ~20:
   VERSION = "1.0.0"  -->  VERSION = "1.1.0"

2. Edit savesync.spec, update the version in:
   - Import statement: from savesync import VERSION
   - EXE name uses VERSION automatically

3. Rebuild the EXE (see above)

-------------------------------------------
DATA STORAGE
-------------------------------------------
All config files are stored in:
  %APPDATA%\saveSync\

Contents:
  - client_secrets.json   (Google API credentials)
  - credentials.txt       (OAuth tokens)
  - settings.json         (App settings)
  - games\*.json          (Per-game configs)

-------------------------------------------
USAGE WORKFLOW
-------------------------------------------
1. First run: Paste Google OAuth client secrets
2. Add games via "+ Add Game" button
3. Click shortcut icon (🔗) to create desktop shortcut
4. Use shortcut to sync & play automatically!

-------------------------------------------
SETTINGS
-------------------------------------------
Access via ⚙ Settings button in the GUI.

- Show log window when launching via shortcut
  When enabled (default), desktop shortcuts show a 
  progress window during sync. Disable for silent mode.

-------------------------------------------
SYNC CONFLICT HANDLING
-------------------------------------------
If local saves are NEWER than cloud, you'll be asked:
  - Keep Local: Skip download, upload after playing
  - Use Cloud:  Overwrite local with cloud saves
  - Cancel:     Abort sync

-------------------------------------------
FILES
-------------------------------------------
savesync.py     - Main application (GUI + CLI)
savesync.spec   - PyInstaller build config
README.txt      - This file