Installation
Choose the package matching your operating system and CPU architecture. Download it from either source:
- GitHub Releases
- Lanzou Cloud, access code:
9vs5
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:
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:
yay -Syu res-downloaderBuilding 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:
wails3 task linux:build PRODUCTION=trueIn the PKGBUILD package() function, enter the project source directory and install the executable, shared desktop entry, and icon ($pkgdir is supplied by makepkg):
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:
chmod +x ./res-downloader_<version>_linux_amd64
./res-downloader_<version>_linux_amd64Once installed, continue to Quick Start.
