Skip to content

Installation

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

Installation

Requires macOS 14+.

Build from source

git clone https://github.com/roypadina/LanGuard.git
cd LanGuard
xcodebuild -workspace LanGuard.xcworkspace -scheme LanGuard -configuration Release build

Then copy the built LanGuard.app (under DerivedData/.../Build/Products/Release/) into /Applications and launch it. 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).

Homebrew (planned)

brew install --cask roypadina/tap/languard   # not live yet

This needs a notarized release + a Homebrew tap. Tracking it on the Roadmap.

Uninstall

Quit from the menu, drag LanGuard.app to the Trash, and remove the login item under System Settings → General → Login Items if present.

Clone this wiki locally