Download. Install. Upload.
Choose the community installer for your system. The complete CLI is included; no source checkout or developer tools required.
GUI + CLI · macOS / Windows / Linux
macOS 13+ supports Apple silicon and Intel. Windows 10/11 uses the x64 installer; Ubuntu 24.04 / Debian 13 or newer uses the x64 DEB. Download links resolve the latest desktop release automatically.
Finding the latest community release…
Windows: run the EXE installer. Linux: install or upgrade with sudo apt install ./img-desktop_*.deb; credentials require an unlocked Secret Service such as GNOME Keyring. Follow the steps below for macOS.
First installation
- Open the DMG, drag Img.app into Applications, and launch it from there.
- Community builds are not Apple-notarized. If the first launch is blocked, find img under System Settings → Privacy & Security and choose Open Anyway after verifying the source. Do not disable system protections.
- Configure a default storage provider, then press ⌘⌥U to upload your clipboard and automatically copy the link.
Future updates
Settings → About and updates provides update checks, verified downloads, and installation with restart. Daily checks are optional. Storage configuration, library and queue are preserved. macOS may require allowing a new community build; use manual replacement if the app directory is not writable.
Terminal command
Finding the latest community release…
The GUI bundles the matching CLI. Choose Add terminal command under About and updates, or use the standalone CLI releases.
img version
img config path
img config validateDevelopers: build from source
These steps are not needed for normal installation. Build requirements are documented in the repository; release packages are built and verified by GitHub Actions.
git clone https://github.com/liyown/img.git
cd img
make desktop-package