Skip to content

INSTALL.md

Latest commit

 

History

History
113 lines (85 loc) · 2.49 KB

INSTALL.md

File metadata and controls

113 lines (85 loc) · 2.49 KB
Raw

Installation Guide

Homebrew Installation (Recommended)

  1. Add the tap that contains Casks/pingbar.rb:

    brew tap jedisct1/pingbar https://github.com/jedisct1/pingbar

  2. Install using Homebrew Cask:

    brew install --cask jedisct1/pingbar/pingbar

  3. Launch PingBar (automatically installed to /Applications):

    open /Applications/PingBar.app

Manual Installation

Prerequisites

  • macOS Monterey (12.0) or later
  • Xcode Command Line Tools or Xcode
  • Swift 5.9 or later

Build from Source

  1. Clone the repository:

    git clone https://github.com/jedisct1/pingbar.git
cd pingbar

  2. Build and create app bundle:

    make bundle

  3. Install to Applications:

    make install

    Or manually copy:

    cp -r PingBar.app /Applications/

  4. Launch PingBar from Applications or Spotlight

Development Installation

For developers who want to work on PingBar:

  1. Clone and build:

    git clone https://github.com/jedisct1/pingbar.git
cd pingbar
make build

  2. Create a development link:

    ./bundle_pingbar_app.sh --link

  3. Run tests (requires Xcode):

    make test

First Launch

  1. Grant Permissions: On first launch, macOS may ask for permissions
  2. DNS Management: For DNS switching features, you'll need to enter your admin password
  3. Launch at Login: Enable in Preferences if desired

Uninstallation

Homebrew

brew uninstall --cask pingbar

Manual

make uninstall
# Or manually:
rm -rf /Applications/PingBar.app

Troubleshooting

  • "PingBar can't be opened": Right-click → Open, then click "Open" again
  • DNS changes not working: Ensure you're entering the correct admin password
  • App not starting: Check Console.app for error messages
  • Build issues: Ensure you have Xcode Command Line Tools: xcode-select --install

Build Options

Command Description
make build Debug build
make build-release Release build
make bundle Create app bundle
make test Run tests
make clean Clean build artifacts
make install Install to /Applications
make uninstall Remove from /Applications
make archive Create release archive