Skip to content

Installation

Jump to bottom
Roy Padina edited this page Jun 5, 2026 · 2 revisions

Installation

Requires macOS 14+ (Sonoma).

Homebrew (recommended)

brew install --cask roypadina/tap/languard

LanGuard is ad-hoc signed (not notarized), so on first launch macOS blocks it. Either right-click /Applications/LanGuard.app → Open (then Open again), or clear quarantine once:

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

Build from source

git clone https://github.com/roypadina/LanGuard.git
cd LanGuard
xcodebuild -workspace LanGuard.xcworkspace -scheme LanGuard -configuration Release build
cp -R ~/Library/Developer/Xcode/DerivedData/LanGuard-*/Build/Products/Release/LanGuard.app /Applications/
open /Applications/LanGuard.app

The app lives in the menu bar — no Dock icon.

On first launch:

  • Click Allow on the notification prompt if you want toggle banners.
  • LanGuard registers itself as a login item (re-registers automatically if you later move the app; prompts you if macOS needs approval).

Uninstall

brew uninstall --cask languard      # if installed via Homebrew
# or drag /Applications/LanGuard.app to the Trash

defaults delete com.roy.languard     # forget all settings (optional)

Also remove it under System Settings → General → Login Items if still listed.

Clone this wiki locally