purlview

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 and puts purlview in ~/.local/bin. No administrator rights; your shell profile is never edited.

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.gz · Intel: purlview_<version>_darwin_amd64.tar.gz. Unpack 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 and puts purlview in ~/.local/bin. No root; your shell profile is never edited. 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

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.gz · Arm64: purlview_<version>_linux_arm64.tar.gz. Unpack 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 and puts purlview in %LOCALAPPDATA%\Programs\purlview. 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

WinGet

Installs for your user alone; no administrator rights.

Install
$ winget install IdylLabs.Purlview
Upgrade
$ winget upgrade IdylLabs.Purlview
Uninstall
  1. Sign out
    $ purlview logout
  2. Remove Purlview
    $ winget uninstall IdylLabs.Purlview

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

Signed with a timestamped Authenticode signature, which Windows checks for you.

Download
Download from the release page

x64: purlview_<version>_windows_amd64.zip · Arm64: purlview_<version>_windows_arm64.zip. Unpack 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 idyl-labs/purlview release workflow.

Linux
$ sha256sum --ignore-missing -c checksums.txt
macOS
$ grep purlview_<version>_darwin_arm64.tar.gz checksums.txt | shasum -a 256 -c
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