Install gim
All builds are early pre-releases, for testing. The newest one of each app is linked on the download page.
Android
Section titled “Android”Android 8.0 or later, arm64 or x86_64. Download the APK from gim-android releases and open it. The APK is signed with a debug key, so Android asks you to allow installing apps from your browser or file manager.
macOS 15 or later, Apple silicon or Intel. Download the zip from gim-mac releases. The app is ad-hoc signed and not notarized, so the first launch needs one extra step:
- Unzip the download and move
GIM.appto Applications. - Open it. When macOS says it cannot verify the app, close the dialog.
- Open System Settings › Privacy & Security, scroll down and click Open Anyway.
Or clear the quarantine flag in Terminal:
xattr -dr com.apple.quarantine /Applications/GIM.appiOS and Windows
Section titled “iOS and Windows”Not available yet. iOS needs distribution through the App Store or TestFlight; the Windows app is in development.
Command line
Section titled “Command line”gim is a command-line client for scripts and testing, in
gim-client-sdk. Build it from
source with a Rust toolchain and a C compiler:
git clone https://github.com/gimhq/gim-client-sdk.gitcd gim-client-sdkcargo build --release -p gim-cli # -> target/release/gimEvery command takes a profile directory (--profile DIR or GIM_PROFILE), which holds one device.
register creates it on the built-in hub:
gim --profile ~/.gim register alice "Alice"gim --profile ~/.gim whoamiNever use one profile from two gim processes at once. gim --help lists every command.