Install

Install Purlview

One executable for macOS, Linux and Windows, on Intel and Arm. No runtime, no administrator rights.

macOS macOS 13 Ventura or later, Apple silicon and Intel

Native installer Recommended

$ curl -fsSL https://purlview.com/install.sh | sh

Checks the download against checksums.txt, puts purlview in ~/.local/bin and adds that folder to your PATH. Open a new terminal to use it. No administrator rights.

Check
$ purlview --version
Upgrade
Run the install command again. Upgrading ends active shares.
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ curl -fsSL https://purlview.com/install.sh | sh -s -- --uninstall

Other ways to install

Homebrew

With manual pages and shell completions.

Install
$ brew install --cask idyl-labs/tap/purlview
Upgrade
$ brew upgrade --cask purlview
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ brew uninstall --cask purlview

Archive

Signed with a Developer ID and notarized, so macOS opens it without a warning.

Download
Download from the release page

Apple silicon purlview_<version>_darwin_arm64.tar.gzIntel purlview_<version>_darwin_amd64.tar.gzUnpack it and put purlview on your PATH.

Linux kernel 3.2 or later, any distribution, x64 and Arm64

Native installer Recommended

$ curl -fsSL https://purlview.com/install.sh | sh

Checks the download against checksums.txt, puts purlview in ~/.local/bin and adds that folder to your PATH. Open a new terminal to use it. No root. The same command works in WSL.

Check
$ purlview --version
Upgrade
Run the install command again. Upgrading ends active shares.
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ curl -fsSL https://purlview.com/install.sh | sh -s -- --uninstall

Other ways to install

APT

For Debian and Ubuntu. Adds the signed Purlview repository once; apt then keeps it current.

Install
$ sudo curl -fsSL https://pkg.purlview.com/purlview-archive-keyring.gpg -o /usr/share/keyrings/purlview-archive-keyring.gpg
$ sudo curl -fsSL https://pkg.purlview.com/deb/purlview-stable.sources -o /etc/apt/sources.list.d/purlview.sources
$ sudo apt update && sudo apt install purlview
Upgrade
$ sudo apt upgrade
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ sudo apt remove purlview

DNF

For Fedora and the RHEL family. Adds the signed Purlview repository once; dnf then keeps it current.

Install
$ sudo curl -fsSL https://pkg.purlview.com/rpm/purlview-stable.repo -o /etc/yum.repos.d/purlview.repo
$ sudo dnf install purlview
Upgrade
$ sudo dnf upgrade
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ sudo dnf remove purlview

Packages

For Debian and Ubuntu, or Fedora and the RHEL family. Install the next release the same way.

Install
$ sudo dpkg -i purlview_<version>_linux_amd64.deb
$ sudo dnf install ./purlview_<version>_linux_amd64.rpm
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ sudo dpkg -r purlview
    $ sudo dnf remove purlview

Archive

One static executable that runs on any distribution.

Download
Download from the release page

x64 purlview_<version>_linux_amd64.tar.gzArm64 purlview_<version>_linux_arm64.tar.gzUnpack it and put purlview on your PATH.

Windows Windows 10 or later, x64 and Arm64

Native installer Recommended

$ irm https://purlview.com/install.ps1 | iex

In PowerShell. Checks the download against checksums.txt, puts purlview in %LOCALAPPDATA%\Programs\purlview and adds that folder to your PATH. No administrator rights.

Check
$ purlview --version
Upgrade
Run the install command again. Upgrading ends active shares.
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ & ([scriptblock]::Create((irm https://purlview.com/install.ps1))) -Uninstall

Other ways to install

Scoop

Adds the idyl-labs bucket once, then installs and updates like any Scoop app.

Install
$ scoop bucket add idyl-labs https://github.com/idyl-labs/scoop-bucket
$ scoop install purlview
Upgrade
$ scoop update purlview
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ scoop uninstall purlview

Archive

Not yet Authenticode signed, so a browser download may show a SmartScreen prompt; the commands above avoid it.

Download
Download from the release page

x64 purlview_<version>_windows_amd64.zipArm64 purlview_<version>_windows_arm64.zipUnpack it and put purlview.exe on your PATH.

Shell completion

Homebrew and the Linux packages set it up for you. Otherwise, one line for your shell:

bash
$ purlview completion bash > ~/.local/share/bash-completion/completions/purlview
fish
$ purlview completion fish > ~/.config/fish/completions/purlview.fish
PowerShell
$ purlview completion powershell | Out-String | Invoke-Expression

Add it to your $PROFILE to keep it.

Any other shell
$ purlview completion <shell> --help

Verify a download

Every release publishes checksums.txt. Check a download against it, and with cosign installed, check that it came from the release workflow of idyl-labs/purlview, where the CLI is built. The CLI and its installers are open source on GitHub.

Linux
$ sha256sum --ignore-missing -c checksums.txt
macOS
$ shasum -a 256 --ignore-missing -c checksums.txt
Signature
$ cosign verify-blob \
  --certificate-identity "https://github.com/idyl-labs/purlview/.github/workflows/release.yml@refs/tags/v<version>" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --bundle checksums.txt.sigstore.json checksums.txt