wow-backup/INSTALL.md
2026-08-25 16:06:46 +01:00

98 lines
3.1 KiB
Markdown

# Installing WoW Backup
## Download
Download the appropriate installer for your platform from the **[latest release](https://git.asarius.site/rukira/wow-backup/releases/latest)**:
| 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` |
_Note: The Linux version is untested and experimental. Use at your own risk._
---
## Windows
1. Download the `.msi` installer from the latest release.
2. Double-click the `.msi` file to start the installation wizard.
3. Follow the on-screen prompts to complete installation.
4. Launch **WoW Backup** from the Start Menu or desktop shortcut.
### Windows Defender SmartScreen
If Windows Defender SmartScreen flags the installer (*"Windows protected your PC — Microsoft Defender SmartScreen prevented an unrecognized app from starting"*):
1. Click **More info**.
2. Click **Run anyway**.
---
## macOS
### Option 1: Install via Homebrew (Recommended)
Installing via [Homebrew](https://brew.sh/) automatically handles macOS quarantine flags and simplifies future updates:
**Install:**
1. Add the tap:
```shell
brew tap rukira/tap https://git.asarius.site/rukira/homebrew-tap.git
```
2. Install WoW Backup:
```shell
brew install --cask --no-quarantine wow-backup
```
**Update:**
```shell
brew update
brew upgrade --cask wow-backup
```
**Uninstall:**
```shell
brew uninstall --cask --zap wow-backup
```
---
### Option 2: Manual DMG Download
1. Download the `.dmg` file from the **[latest release](https://git.asarius.site/rukira/wow-backup/releases/latest)**.
2. Double-click the `.dmg` file to mount the disk image.
3. Drag **WoW Backup.app** into your `/Applications` folder.
4. Eject the disk image.
#### Unsigned Application / Gatekeeper Notice
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:
- **Terminal (Fastest):** Run the following command to strip the quarantine attribute:
```shell
xattr -cr "/Applications/WoW Backup.app"
```
- **macOS System Settings:**
1. Open **System Settings** → **Privacy & Security**.
2. Scroll down to the **Security** section.
3. Click **Open Anyway** next to the WoW Backup notice.
4. Confirm and launch the app.
---
## Linux (Experimental)
1. Download the `.deb` package from the latest release.
2. Open your terminal in the download folder and install the package:
```shell
sudo apt install ./wow-backup_*.deb
```
*Alternatively, with `dpkg`:*
```shell
sudo dpkg -i wow-backup_*.deb
sudo apt-get install -f
```
3. Launch **WoW Backup** from your desktop application launcher or run `wowbackup` in the terminal.