wow-backup/INSTALL.md

Installing WoW Backup

Download

Download the appropriate installer for your platform from the latest release:

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 automatically handles macOS quarantine flags and simplifies future updates:

Install:

1. Add the tap:

   brew tap rukira/tap https://git.asarius.site/rukira/homebrew-tap.git
   

2. Install WoW Backup:

   brew install --cask --no-quarantine wow-backup
   

Update:

brew update
brew upgrade --cask wow-backup

Uninstall:

brew uninstall --cask --zap wow-backup

---

Option 2: Manual DMG Download

1. Download the .dmg file from the latest release.
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:

  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:

   sudo apt install ./wow-backup_*.deb
   

   Alternatively, with dpkg:

   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.