Skip to content

Installation

Brett Estrade edited this page Nov 15, 2026 · 12 revisions

Download and installation

If Vim isn't installed and you can't add packages, use the standalone download. That's the route for a restricted account without root, gcc, or even make. You still need permission to run scripts in your account and an interactive shell/terminal; CGI access alone doesn't provide a full-screen editor.

Requirements

  • Full Perl 5.10+, including its standard modules (POSIX, Digest::SHA, File::Temp, Getopt::Long, Pod::Usage and the other bundled libraries).
  • A POSIX tty and ANSI/VT100 terminal for interactive editing.
  • Writable temporary disk space; see Large Files.
  • Optional Perl::Tidy, for formatting only.

No privileged installation is required. Minimal OS packages sometimes split the standard Perl library into separate packages. A stripped-down Perl binary alone is insufficient; this is distinct from needing CPAN dependencies for pvim.

Standalone file

pvim-standalone.pl is the complete editor, including its POD and CLI help. It has the same bytes as the pvim download. All pvim packages are already embedded in that file, so no additional fat-packing step or extraction is required. It uses the host's core Perl library; it does not embed a Perl interpreter or the optional formatter.

mkdir -p "$HOME/.local/bin"
curl -fL https://github.com/oodler577/pvim/releases/download/v0.1.13/pvim-standalone.pl -o "$HOME/.local/bin/pvim"
chmod +x "$HOME/.local/bin/pvim"
"$HOME/.local/bin/pvim" -v
"$HOME/.local/bin/pvim" file.pl

If ~/.local/bin is in your PATH, run pvim file.pl. Otherwise use its full path, or add that directory to your shell's PATH configuration. The executable selects the Perl interpreter on PATH through its shebang.

Check downloads

Download SHA256SUMS alongside the exact release asset, then compare its entry:

curl -fLO https://github.com/oodler577/pvim/releases/download/v0.1.13/SHA256SUMS
sha256sum "$HOME/.local/bin/pvim"

For a full release directory containing all listed assets, sha256sum -c SHA256SUMS checks every entry. macOS also provides shasum -a 256. Checksums detect a mismatch; they are not a separate cryptographic signature.

Upgrade and remove

To upgrade, quit pvim, download the desired release, verify it, and replace your user-owned installed file. There is no package database or installed module tree. To uninstall the example installation: rm "$HOME/.local/bin/pvim".

Git checkout

git clone git@github.com:oodler577/pvim.git
cd pvim
git checkout master
./pvim file.pl

See Perl Features for the optional formatter and Portability for actual test coverage.

CPAN-format tarball (future App::Pvim)

App::Pvim is prepared for future CPAN publication, but has not been uploaded by this work. To install the GitHub release's CPAN-format tarball into your account:

tar -xzf App-Pvim-0.1.13.tar.gz
cd App-Pvim-0.1.13
perl Makefile.PL INSTALL_BASE="$HOME/.local/pvim"
make test
make install
"$HOME/.local/pvim/bin/pvim" -v

This needs make and standard Perl build tools. There is no C code in pvim to compile, so pvim itself needs no gcc. You need neither root nor Dist::Zilla on the consuming machine. The standalone download remains the option when you want to avoid a build/install step entirely. See Releases.

Clone this wiki locally