Compatibility

Linux

To run psh you need a Linux-based system that is compatible with zsh and its dependencies.

The following requirements should be met to use psh:

• zsh is supported by your distribution
• In addition your system should support git, imagemagick, xclip, curl
• If there're dependencies that need to be installed: You have the permissions to use sudo
• Bash (or zsh) is installed on your system so you can run the psh script

You should be able to install psh on the following distributions without issues:

• Arch Linux
• Manjaro Linux
• Ubuntu
• Debian
• PopOs!

Most things used by psh are available on a wide-range of versions of these distributions. This is why no specific version numbers have been added to the list above. psh is only tested on the current lastest release of the above distributions before release.

As always with new tools, it is recommended to check compatibility in a virtual machine before installing psh on your day to day work machine.

Windows

Though this tool is written using shellscripts that are designed for bash/zsh, this does not mean that Windows is not supported. If you have enabled the Windows Subsystem for Linux you're ready to go! The installation procedure is simillar to the one on native Linux. Please use WSL2 when using psh.

Please check the above list of Linux distributions and notes regarding compatibility.

macOS

macOS is supported starting with version 2.0.0 of psh. However, support is experimental and may cause more problems than you encounter when using psh with native Linux.