Installing OFFED v0.2.0 - Unsigned Binary Instructions

Note: OFFED v0.2.0 binaries are currently unsigned. This means Windows SmartScreen and macOS Gatekeeper will show security warnings when you first run the application. This is expected behavior for open-source software distributed without code signing certificates.

Windows Installation

Option 1: Installing the EXE (Recommended for Quick Start)

  1. Download the .exe file from GitLab Releases

  2. Double-click the downloaded .exe file

  3. Windows SmartScreen Warning will appear:

  4. You'll see "Windows protected your PC" message
  5. Click "More info" link

  6. Click "Run anyway" button

  7. The application will launch normally

Option 2: Installing the MSI Installer

  1. Download the .msi installer from GitLab Releases

  2. Right-click the .msi file and select "Properties"

  3. At the bottom of the General tab, check the box next to "Unblock"

  4. Click "OK" to save

  5. Double-click the .msi file to run the installer

  6. If SmartScreen still appears:

  7. Click "More info"

  8. Click "Run anyway"

  9. Follow the installation wizard

Alternative: Enable Developer Mode (Advanced Users)

For users who frequently install unsigned applications:

  1. Open Settings → Privacy & Security → For developers
  2. Toggle "Developer Mode" to ON
  3. Click "Yes" to confirm
  4. Restart your computer

Warning: Only enable Developer Mode if you understand the security implications.

macOS Installation

For macOS Sequoia (15.0+)

  1. Download the .dmg file from Offed Homepage

  2. Double-click the .dmg file to mount it

  3. Drag OFFED.app to your Applications folder

  4. Attempt to open OFFED from Applications:

  5. You'll see a Gatekeeper warning: "OFFED cannot be opened because it is from an unidentified developer"

  6. Click "OK"

  7. Open System Settings:

  8. Go to System Settings → Privacy & Security
  9. Scroll down to the Security section at the bottom
  10. You'll see a message: "OFFED was blocked from use because it is not from an identified developer"

  11. Click the "Open Anyway" button next to this message

  12. Confirm:

  13. Enter your admin password when prompted
  14. A new dialog will appear asking "Are you sure you want to open it?"

  15. Click "Open"

  16. OFFED will now launch normally

For macOS Ventura and Earlier

  1. Download the .dmg file from GitLab Releases

  2. Double-click the .dmg file and drag OFFED.app to Applications

  3. Control-click (right-click) on OFFED.app in the Applications folder

  4. Select "Open" from the context menu

  5. In the warning dialog, click "Open" again to confirm

  6. OFFED will launch (you only need to do this once)

Alternative: Using Terminal (Advanced Users)

# Remove the quarantine attribute from the app
xattr -d com.apple.quarantine /Applications/OFFED.app

Then launch OFFED normally from Applications.

Using Homebrew

Macos Users can also install Offed through Homebrew


# Add Homebrew tap to your mac
brew tap mitradranirban/tap
# Install OFFED
brew install --cask offed
This will autmatically remove the quarantine attribute and install the

Linux Installation

Linux packages (AppImage, DEB, RPM) do not require code signing and should install without warnings.

AppImage

chmod +x OFFED-*.AppImage
./OFFED-*.AppImage

DEB (Debian/Ubuntu)

sudo dpkg -i offed_*.deb
sudo apt-get install -f  # Install dependencies if needed

RPM (Fedora/RHEL)

sudo rpm -i offed-*.rpm

Security Notes

Building from Source (Alternative)

If you prefer to build from source instead of using pre-built binaries:

# Clone the repository
git clone https://gitlab.com/mitradranirban/offed.git
cd offed

# Build using Makefile
make build

# Or build manually
trunk build --release
cargo tauri build

For detailed build instructions, see the README.

Support

If you encounter issues during installation, please: - Check the GitLab Issues - Open a new issue with your OS version and error details - Contact the maintainer: Dr. Anirban Mitra