Skip to content

Installation ​

Choose the package matching your operating system and CPU architecture. Download it from either source:

Windows ​

Most 64-bit Windows PCs with Intel or AMD processors should use the installer labeled amd64. The amd64 architecture supports both Intel and AMD processors, not just AMD. Choose arm64 only for Windows devices with an ARM processor.

Download the Windows installer and follow its instructions. Approve the UAC prompt when installing the certificate for the first time.

The standard installer uses the system WebView2 Runtime; the fixed_webview2 installer bundles a fixed version. To switch between them, close the app and install over the same directory. After switching to the standard version, the app uses the system runtime, and the installer removes only fixed WebView2 files listed in installation records. Untracked legacy files and other files in the directory are preserved, but the standard version will not load them as its runtime.

If installation stops partway through, see Retry a failed Windows installation.

Windows 7 only supports version 2.3.0 from the legacy archive.

macOS ​

Choose _mac_amd64.dmg for Intel Macs or _mac_arm64.dmg for Apple Silicon (M-series). The _mac_universal.dmg package supports both architectures.

Download the .dmg file and drag res-downloader.app to Applications.

If macOS blocks the first launch, allow the app under System Settings → Privacy & Security.

Linux ​

Debian / Ubuntu ​

On Debian, Ubuntu, and similar systems, use apt to install the .deb package for your architecture:

bash
sudo apt install './res-downloader_<version>_linux_amd64.deb'

apt handles dependencies automatically. You can also use sudo dpkg -i, but must install any missing dependencies separately.

Permission notice mentioning _apt

If installation ends with “Download is performed unsandboxed as root” because _apt cannot access the file, this notice alone does not mean installation failed. See Debian / Ubuntu installation permission notice to check the installation status or retry from an accessible location.

Arch Linux ​

If yay is installed, update your system and install res-downloader from the AUR:

bash
yay -Syu res-downloader
Building from source or maintaining the AUR package

The current version uses Wails v3 with GTK4 and WebKitGTK 6.0. When building from source or maintaining the PKGBUILD, configure the gtk4, webkitgtk-6.0, and nss (providing the browser certificate tool certutil) dependencies and use this build command:

bash
wails3 task linux:build PRODUCTION=true

In the PKGBUILD package() function, enter the project source directory and install the executable, shared desktop entry, and icon ($pkgdir is supplied by makepkg):

bash
install -Dm755 bin/res-downloader "$pkgdir/usr/bin/res-downloader"
install -Dm644 build/linux/application.desktop "$pkgdir/usr/share/applications/res-downloader.desktop"
install -Dm644 build/linux/Debian/usr/share/icons/hicolor/256x256/apps/res-downloader.png \
  "$pkgdir/usr/share/icons/hicolor/256x256/apps/res-downloader.png"

When installing through yay with a PKGBUILD already adapted to the current version, no manual changes are needed.

AppImage ​

Keep the AppImage in a stable directory, make it executable, and launch it as your normal user. For bwrap permission errors on Ubuntu, see the AppArmor configuration example.

Browser certificate tools ​

AppImage and standalone executables do not install the host's certutil tool automatically. Synchronizing existing shared browser certificate stores requires libnss3-tools on Debian / Ubuntu, nss on Arch Linux, or nss-tools on Fedora. Installing the DEB through apt handles this dependency automatically.

If the tool is missing, install it with your system package manager and retry the certificate operation. Do not launch the application with sudo.

Standalone executable ​

For a standalone executable, add execute permission before launching:

bash
chmod +x ./res-downloader_<version>_linux_amd64
./res-downloader_<version>_linux_amd64

Once installed, continue to Quick Start.

Make sure you have the rights to the resources you process and comply with local laws, platform terms, and copyright requirements.