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
- Sign out
$
purlview logout - Remove Purlview
$
curl -fsSL https://purlview.com/install.sh | sh -s -- --uninstall
- Sign out
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
- Sign out
$
purlview logout - Remove Purlview
$
brew uninstall --cask purlview
- Sign out
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.gzIntelpurlview_<version>_darwin_amd64.tar.gzUnpack it and putpurlviewon 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
- Sign out
$
purlview logout - Remove Purlview
$
curl -fsSL https://purlview.com/install.sh | sh -s -- --uninstall
- Sign out
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
- Sign out
$
purlview logout - Remove Purlview
$
sudo apt remove purlview
- Sign out
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
- Sign out
$
purlview logout - Remove Purlview
$
sudo dnf remove purlview
- Sign out
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
- Sign out
$
purlview logout - Remove Purlview
$
sudo dpkg -r purlview$
sudo dnf remove purlview
- Sign out
Archive
One static executable that runs on any distribution.
- Download
- Download from the release page
x64
purlview_<version>_linux_amd64.tar.gzArm64purlview_<version>_linux_arm64.tar.gzUnpack it and putpurlviewon 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
- Sign out
$
purlview logout - Remove Purlview
$
& ([scriptblock]::Create((irm https://purlview.com/install.ps1))) -Uninstall
- Sign out
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
- Sign out
$
purlview logout - Remove Purlview
$
scoop uninstall purlview
- Sign out
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.zipArm64purlview_<version>_windows_arm64.zipUnpack it and putpurlview.exeon 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-ExpressionAdd it to your
$PROFILEto 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