/paru

AUR helper based on yay

Primary LanguageRustGNU General Public License v3.0GPL-3.0

Paru

An AUR helper and pacman wrapper

paru paru-bin paru-git

Description

Paru is an AUR helper written in Rust and based on the design of yay. It aims to be your standard pacman wrapping AUR helper with minimal interaction.

asciicast

Installation

sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si

General Tips

  • Man pages: For documentation on paru's options and config file see paru(8) and paru.conf(5) respectively.

  • Color: Paru only enables color if color is enabled in pacman. Enable color in your pacman.conf.

  • File based review: To get a more advanced review process enable FileManager with your file manager of choice in paru.conf.

  • Flip search order: To get search results to start at the bottom and go upwards, enable BottomUp in paru.conf.

  • Editing PKGBUILDs: When editing PKGBUILDs, you can commit your changes to make them permanent. When the package is upgraded, git will try to merge your changes with upstream's.

  • PKGBUILD syntax highlighting: You can install bat to enable syntax highlighting during PKGBUILD review.

Examples

paru <target> -- Interactively search and install <target>.

paru -- Alias for paru -Syu.

paru -Sua -- Upgrade AUR packages.

paru -Qua -- Print available AUR updates.

paru -G <target> -- Download the PKGBUILD and related files of <target>.

paru -Gp <target> -- Print the PKGBUILD of <target>.

paru -Gc <target> -- Print the AUR comments of <target>.

paru --gendb -- Generate the devel database for tracking *-git packages. This is only needed when you initially start using paru.

Debugging

Paru is not an official tool. If paru can't build a package, you should first check if makepkg can successfully build the package. If it can't, then you should report the issue to the maintainer. Otherwise, it is likely an issue with paru and should be reported here.