Fixing MacOS build issue. Improving documentation.

This commit is contained in:
Rukira 2026-08-25 09:40:28 +01:00
parent cfd093af72
commit 616fd21872
4 changed files with 65 additions and 31 deletions

View file

@ -6,13 +6,13 @@ This guide provides step-by-step instructions for installing and running **WoW B
## Download
Download the appropriate installer for your platform from the **[GitHub Releases](https://github.com/rukira/wow-backup/releases)** page:
Download the appropriate installer for your platform from the **[latest release](https://git.asarius.site/rukira/wow-backup/releases)**:
| Platform | Package Format | Installer File Pattern |
|---|---|---|
| **macOS** | DMG Disk Image | `WoW Backup-<version>.dmg` |
| **Windows** | Windows Installer (MSI) | `WoW Backup-<version>.msi` |
| **Linux** | Debian Package (DEB) | `wow-backup_<version>_amd64.deb` |
| Platform | Package Format | Installer File Pattern |
|--------------------------|---|---|
| **macOS** | DMG Disk Image | `WoW Backup-<version>.dmg` |
| **Windows** | Windows Installer (MSI) | `WoW Backup-<version>.msi` |
| **Linux** (Experimental) | Debian Package (DEB) | `wow-backup_<version>_amd64.deb` |
---
@ -27,16 +27,10 @@ Download the appropriate installer for your platform from the **[GitHub Releases
Because WoW Backup is distributed without Apple Developer ID code-signing notarization, macOS Gatekeeper may show a warning on first launch (*"WoW Backup cannot be opened because the developer cannot be verified"* or *"Apple could not verify that WoW Backup is free of malware"*).
To launch the app for the first time:
- **Option A (Finder)**:
1. Open Finder and navigate to `/Applications`.
2. Right-click (or Control-click) on **WoW Backup.app** and choose **Open**.
3. In the security popup, click **Open**.
- **Option B (Terminal)**:
Run the following command in Terminal to clear the quarantine attribute:
```shell
xattr -d com.apple.quarantine "/Applications/WoW Backup.app"
```
1. Open **System Settings**
2. Navigate to **Security & Privacy**.
3. Click **Open Anyway** under **Allow apps downloaded from**.
4. Restart WoW Backup.
---
@ -68,17 +62,3 @@ If Windows Defender SmartScreen flags the installer (*"Windows protected your PC
```
3. Launch **WoW Backup** from your desktop application launcher or run `wowbackup` in the terminal.
---
## First-Time Setup & Overview
Once started, WoW Backup runs discreetly in the system tray / menu bar:
1. **Accessing Dashboard**: Click the tray icon in the macOS menu bar or Windows/Linux system tray to open the application window.
2. **Settings Configuration**:
- Navigate to **Settings** (gear icon).
- Set your **World of Warcraft Installation Folder** (e.g. `_retail_` or `_classic_`).
- Select your **Backup Destination Folder**.
- Set your preferred **Daily Backup Time**, **Retention Policy** (number of backups to keep), and **Compression Mode** (`ZIP` or folder replication).
- Optionally enable **Launch at Startup** so backups occur automatically without manual intervention.
3. **Lifecycle**: Closing the main window hides it to the tray while keeping the scheduler running. To quit the application completely, select **Quit** from the tray menu.