Skip to content

Installation

Paw provides one executable for the desktop app and the command line. Install a package for your operating system, or install the executable with Go.

Homebrew (macOS and Linux)

Install the Lucor Homebrew tap:

brew install --cask lucor/tap/paw

The qualified command adds the tap if needed. You can also add the tap first:

brew tap lucor/tap
brew install --cask lucor/tap/paw

On Linux, a current Homebrew installation with Linux cask support is required. The Homebrew bin directory must be on the PATH used by your desktop session for the Paw desktop launcher to run.

Download a release

Find the latest packages on GitHub Releases.

SystemRelease packageArchitecture
macOS.dmgIntel (amd64), Apple Silicon (arm64)
Linux.tar.xzamd64, arm64
Windows.exeamd64
FreeBSD.tar.xzamd64, arm64

macOS

Download the DMG for your processor. Open it and move Paw to Applications.

Paw is not notarized. After you copy Paw to Applications, remove its quarantine flag:

xattr -r -d com.apple.quarantine /Applications/Paw.app

Repeat this after installing an update.

Linux

Extract the archive. In the extracted directory containing the Makefile, run:

make user-install

To install system-wide instead, run sudo make install.

Windows

Download the Windows amd64 executable from the release page and run it.

FreeBSD

Extract the archive. From the directory containing the Makefile, run gmake user-install. Install GNU Make (gmake) first if needed. To install system-wide, run sudo gmake install.

Go

If your system has a version of Go supported by Paw, install the latest published release:

go install go.lucor.dev/paw@latest

The build needs a C compiler and the platform libraries listed in the Fyne build requirements.

Go installs paw in GOBIN, or in GOPATH/bin when GOBIN is not set. Add that directory to your PATH to run paw and paw cli.

This installs the executable only. It doesn’t add an application launcher to your desktop.

Run Paw

Open the desktop application using the installed application launcher, if available, or run:

paw

To start command-line mode:

paw cli

See Command line for usage. The executable must be on your PATH to use paw from the shell.