Skip to content

A terminal user interface for searching and installing Arch Linux packages

License

Notifications You must be signed in to change notification settings

moson-mo/pacseek

Repository files navigation

pacseek pacseek-bin

GitHub Workflow Status Go Report Card

pacseek

A terminal user interface for searching and installing Arch Linux packages

pacseek is terminal user interface which allows you to browse and search through the Arch Linux package databases as well as the Arch User Repository. Packages can be installed/uninstalled with the ENTER key.

pacseek

Package installation / removal is done with an AUR helper.
In the default configuration, yay is being used.
You can change this in the settings -> Install command / AUR Install command

There are some examples for configuring other helpers or even makepkg.

Features

  • Search for packages in the Arch repositories and AUR
    • by: name / name & description
    • method: contains / starts-with
  • Auto-suggest (disabled by default)
  • Customizable commands for
    • Installing / Removing packages¹
    • Update all packages¹
    • Update repo packages
    • Show PKGBUILD³
  • Adjustable appearance
    • Color schemes
    • Border styles
    • Component sizes / proportions
    • Glyph styles
  • ASCII mode for non unicode terminals
  • Sortable search results by
    • Package name
    • Source
    • Installed state
    • Modified date
    • Popularity²
  • Caching of
    • Search results
    • Package information
  • Configurable AUR /rpc endpoint URL
  • Display PKGBUILD file
  • Search for upgrades / show list of upgradable packages⁴
  • Show a list of all installed packages
  • News feed
    • Shown on upgrades screen
    • Feed URL(s) can be changed
    • Clicking on an item will xdg-open the URL to the article

¹ (By default, yay is being used to install/remove/upgrade packages. You can change this in the settings)
² (only applicable to AUR packages)
³ (by default curl & less are used. Can be changed in the settings)
⁴ (requires fakeroot to be installed)

Libraries used


How to build / run / install

$ git clone https://github.com/moson-mo/pacseek.git
$ cd pacseek
$ go build .
$ ./pacseek

Binaries are available on the Releases page.
Also an AUR package is available.

Navigation / Usage

You can either use the keyboard or mouse to navigate through the different components.
While the search bar is focused, use the ENTER key to search for packages.

With TAB you can navigate to the package list. Use the cursor keys to navigate within the list.
To install/remove a package, press ENTER.

The settings form can be opened with CTRL+S. To quit pacseek, you can use CTRL+Q, CTRL+C or ESC.

Configuration

You change all configuration options from the settings screen (CTRL+S).
The configuration file (json format) can be found at ~/.config/pacseek/config.json

More detailed information regarding usage and configuration can be found in the Wiki or manpage: man pacseek