# GameSaveManager

**Repository Path**: zzkuang/game-save-manager

## Basic Information

- **Project Name**: GameSaveManager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-06
- **Last Updated**: 2025-10-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Game Save Manager

A lightweight, modern Windows desktop application for managing and backing up your game save files with ease.

## 📖 Description

Game Save Manager is a powerful yet simple tool designed to help gamers protect their precious save files. Whether you're worried about save corruption, want to experiment with different playsthroughs, or simply need a reliable backup solution, this application provides an intuitive interface to manage multiple game profiles, create backups on-demand or automatically, and restore your saves whenever needed.

## ✨ Core Features

- **Multiple Game Profile Management** - Add and organize unlimited game save profiles with custom names
- **Manual Backup & Restore** - Create timestamped backups instantly with a single click
- **Automated Backups** - Set custom backup intervals (in minutes) for each game profile
- **Backup Rotation** - Automatically limit the number of backups to save disk space
- **Global Hotkeys** - Quick access to backup (F5) and restore (F6) functions with customizable key bindings
- **Modern UI** - Clean, professional Windows 11-inspired light theme with Segoe UI font
- **Timestamped Organization** - All backups are automatically organized by game and timestamp
- **Safe Restore** - Built-in confirmation dialogs prevent accidental overwrites

## 🛠️ Tech Stack

- **Language**: C# 12
- **Framework**: .NET 8
- **UI Framework**: WPF (Windows Presentation Foundation)
- **Dependencies**:
  - Newtonsoft.Json - For configuration persistence
  - NHotkey.Wpf - For global hotkey registration

## 🚀 How to Use

### Getting Started

1. **Launch the Application** - Run `GameSaveManager.exe`
2. **Add a Game Profile**:
   - Click the "Add Game" button
   - Browse and select your game's save folder
   - Enter a friendly name for the profile (e.g., "Ark: Survival Evolved")

### Creating Backups

**Manual Backup**:
- Select a game profile from the left panel
- Click "Backup Now" or press **F5**
- Your backup will appear in the middle panel with a timestamp

**Automated Backups**:
- Select a game profile
- Set the "Interval (mins)" to your desired frequency
- Click "Enable Auto-Backup"
- The application will automatically create backups at the specified interval

### Restoring Saves

1. Select a game profile from the left panel
2. Select a backup timestamp from the middle panel
3. Click "Restore Selected Backup" or press **F6**
4. Confirm the restoration in the warning dialog
5. Your save files will be restored immediately

### Managing Settings

**Backup Rotation**:
- Set "Max Backups" to limit the number of stored backups
- Older backups are automatically deleted when the limit is reached
- Set to 0 or leave empty to keep all backups

**Customizing Hotkeys**:
- Click the "Settings" button
- Click on a hotkey textbox
- Press your desired key combination
- Click "Save" to apply changes

### Deleting Profiles

- Select a game profile
- Click "Delete Game"
- The profile will be removed (backup files remain on disk)

## 📁 File Structure

```
GameSaveManager/
├── Backups/              # Backup storage (auto-created)
│   └── [GameName]/       # Per-game backup folders
│       └── [Timestamp]/  # Individual backup snapshots
├── GameProfiles.json     # Game profile configurations
├── settings.json         # Application settings (hotkeys, etc.)
└── icon.ico             # Application icon
```

## ⚙️ System Requirements

- **OS**: Windows 10 or later
- **Runtime**: .NET 8.0 Runtime (Desktop)
- **Disk Space**: Varies based on game save sizes and backup quantity

## 📝 Notes

- All backups are stored in the `Backups` folder relative to the application executable
- The application must remain running for auto-backups to work
- Backup timestamps use the format: `yyyy-MM-dd_HH-mm-ss`
- Global hotkeys work even when the application is minimized

## 🔒 License

This project is provided as-is for personal use.

## 🤝 Contributing

Feel free to fork this project and submit pull requests for improvements!

---

**Developed with ❤️ for gamers who value their progress**