Download

Get the .dmg from click here. Open it, then drag the app to the Applications folder on your disk.

macOS Install Notes

Unsigned builds may show Gatekeeper warnings.

• Right-click the app and choose Open.
• Or go to System Settings → Privacy & Security → Open Anyway.

Install from Terminal

Optional: if you prefer Terminal (or need to troubleshoot), these are common commands after downloading browser.dmg.

Note: the mounted volume might be /Volumes/browser or /Volumes/browser 1.

• Verify the file and (optionally) checksum

  ls -lh ~/Downloads/browser.dmg
  shasum -a 256 ~/Downloads/browser.dmg

• Mount (without opening Finder)

  hdiutil attach -nobrowse ~/Downloads/browser.dmg

• Inspect the mounted volume (name may be browser, browser 1, etc.)

  ls /Volumes
  ls "/Volumes/browser"

• Install via Terminal (copy app into /Applications)

  sudo ditto "/Volumes/browser/browser.app" "/Applications/browser.app"

• Remove quarantine flag (if Gatekeeper blocks it)

  xattr -dr com.apple.quarantine "/Applications/browser.app"

• Verify signing / Gatekeeper assessment

  codesign --verify --deep --strict --verbose=2 "/Applications/browser.app"
  spctl --assess --type execute --verbose "/Applications/browser.app"

• Unmount / eject

  hdiutil detach "/Volumes/browser"

• Delete the downloaded DMG (optional cleanup)

  rm -f ~/Downloads/browser.dmg

Open

Open from Applications or ⌘ + Space.

Browse

Type URL or search in address bar. Press Enter.

Shortcuts

For Developers

Clone the repo, install dependencies, and launch.

• Clone and setup

  git clone https://github.com/bniladridas/browser.git
  cd browser
  flutter pub get
  cp .env.example .env

• Configure Firebase

  flutterfire configure --platforms macos
  git checkout -- lib/firebase_options.dart

• Run the app

  flutter run -d macos

Do not commit .env; it contains private Firebase keys.