Home

Awesome

PacUI

PacUI provides useful and advanced Pacman and Yay/Pikaur/Aurman/Pakku/Trizen/Paru/Pacaur/Pamac-cli commands in a convenient and easy to use text interface.

PacUI is aimed at experienced/intermediate/advanced users of Arch Linux (and Arch-based distributions, including Manjaro), who have at least basic knowledge of their Linux system, Pacman and Yay/Pikaur/Aurman/Pakku/Trizen/Paru/Pacaur/Pamac-cli. Absolute beginners are probably overwhelmed by the choices PacUI offers.

This fork of an older version of pacli called PacUI follows the KISS principle: The whole script is contained within one file, which consists of easy to read bash code with many helpful comments. PacUI offers many more features over pacli in order to enhance comfort and speed of CLI based package management.

Table of Contents

Screenshots

UI of PacUI:

Screenshot 01

Installing the package "cantata" from system repositories by entering its name:

Screenshot 02

Installation

Dependencies

PacUI has the following hard dependency:

If you want PacUI to fully work, these dependencies are needed as well:

By default, Pacman is used for package management. If you want to enable the use of the AUR, PacUI optionally requires at least one of these AUR helpers:

PacUI supports even more features, if these packages are installed:

Execute without prior Installation

If possible, read chapter Dependencies first and install any dependencies you need. PacUI file can be downloaded and run without prior installation:

wget https://raw.githubusercontent.com/excalibur1234/pacui/master/pacui
bash pacui

I find this feature of PacUI invaluable for fixing systems. Here are two examples:

Manual Installation

Please read chapter Dependencies first and decide which packages to install to suit your needs.

PacUI can be manually installed (i.e. executing the same steps as described in the PKBUILD file) as follows:

  1. Download 'pacui' file:
wget https://raw.githubusercontent.com/excalibur1234/pacui/master/pacui
  1. Install 'pacui' file manually:
sudo cp pacui /usr/bin/
  1. Make 'pacui' file executable:
sudo chmod +x /usr/bin/pacui

Manjaro

In Manjaro, you can simply install the stable version of PacUI from the Manjaro repositories:

sudo pacman -S pacui

There is also an (often outdated) development version available:

sudo pacman -S pacui-git

Arch Linux

PacUI is no longer available on the AUR. PKGBUILDs are still availble (see PKGBUILD_AUR file) and Pacui can be executed without installation or manually installed (see above).

chaotic-aur

Both the stable and -git version of PacUI are in chaotic-aur. After adding chaotic-aur to your list of repositories, PacUI can be installed using the same commands as within Manjaro (see above).

Usage

Start PacUI with UI

After successful installation, type the following command into your terminal in order to start PacUI with a simple UI:

pacui

Start PacUI without UI: Using Options

Using PacUI without its UI requires less keystrokes and can therefore be much quicker. An overview of all PacUI options is displayed with pacui h.

For example, you want to display the Reverse dependency Tree of a package. Please note the marked letters "R" and "T" in PacUI's corresponding UI option. PacUI does not care, whether you use upper or lower case letters as options or whether you use no, one or two dashes in front. Therefore, the following four commands are equivalent:

This principle can be used with all of PacUI's options. Here is another random example (of PacUI's hidden "List Packages by Size" option):

Start PacUI without UI: Using Options and Package Names

You can also use package names in addition to options. For example, you want to install the package "cantata". Then, you can use a command like

pacui i cantata

Instead of a list of all available packages, a much shorter already filtered list is displayed. Simply select the "cantata" package you want to install and press ENTER in order to install it.

If an argument contains special characters, it has to be passed on as string. This can be achieved differently depending on the used shell. For example when using regular expressions in zsh in order to search package file names starting with string "archlinux-":

pacui s '^archlinux-'

Start PacUI without UI: Passing Arguments to AUR helper or Pacman

For advanced use (e.g. in scripting or an alias), PacUI can have a "flag" argument, which gets passed directly to an AUR helper and/or Pacman. Examples:

Multiple installed AUR helpers

If more than one AUR helper is installed, they are automatically used in the same order as listed above (i.e. Yay is used with priority while Pamac-cli is only used as a last resort). A specific AUR helper can be set with the PACUI_AUR_HELPER environment variable.

Environment variables can typically be set by adding them to your /etc/environment file. If this file exists on your system, it can be selected using PacUI's "Edit Config Files" option:

pacui c

Diff program

As described in Detailed PacUI Help, PacUI uses pacdiff for comparing .pac* files and a diff program specified by the DIFFPROG environment variable.

If the DIFFPROG environment variable is not set, PacUI uses its own diff program to (only!) show any differences in old and new .pac* files.

Useful Tips and Recommended Settings

It is highly recommended to use an utility, which notifies the user about available updates alongside of PacUI. Such a lightweight utility is for example update-notifier.

Along with PacUI the following settings are recommended by the author:

Additional Pacman Settings

pacui c
#VerbosePkgLists
#ParallelDownloads = 3

Alias

If you use PacUI without the UI it is recommended to use an alias for PacUI to reduce the amount of necessary typing. Do this by adding the following line to your ~/.bashrc file (if you use bash):

alias p='pacui'

This will set "p" as an alias to "pacui" within your terminal (after a restart of your shell or computer). For example, you can now update your system using

p u

Search syntax

PacUI uses fuzzy finder (fzf) to display lists of items (such as packages, package groups, logs, patchs, etc.) and by starting to type, you can easily search/filter those lists. Regular expressions can be used to improve the search results, e.g.:

Search TermDescription
"sbtrkt"Items that match sbtrkt
"^music"Items that start with music
"git$"Items that end with git
"'wild"Items that include wild
"!fire"Items that do not include fire
"!-git$"Items that do not end with -git

A single bar character term acts as an OR operator. For example, the following query matches entries that start with core or end with go, rb, or py.

"^core|go$|rb$|py$"

Help

Short PacUI Help

For short help, e.g. when using PacUI without UI, use one of the following commands:

Detailed PacUI Help

Choose the "Help" option within PacUI's UI by pressing "H" or "h". pacui --help from the terminal will call PacUI's detailed help page, too.

This help page explains some general stuff such as how to navigate PacUI. It also explains every PacUI option in detail. If you want to look up which commands PacUI uses under the hood and understand them in order to use PacUI correctly, this is the right place for you!

Manjaro Forum Threads