Skip to content
moson-mo edited this page Aug 22, 2022 · 10 revisions

You can use both, keyboard and mouse to navigate between the different components in pacseek.

Components

pacseek contains 3 main components.

The left part consists of the search-bar (1) and the result-list (2).
On the right, the package details of selected package in the result-list is displayed (3).

image

Searching

When you start pacseek, the cursor resides in the search-bar.
To search for a package, enter a search term and hit Enter.

The results of you search query will be displayed in the result-list.
You can navigate to the list with either Down or TAB.

To navigate within the list and select another package, use the arrow keys Up and Down.
When the very first record is selected and you press Up, the search-bar will be focused again.
In case you are somewhere in the middle of the list and want to jump back to the search-bar, press Ctrl + Up or TAB.

To list all installed packages press Ctrl + L or use the parameter -i when starting pacseek.

Sorting

The result-list can be sorted by either clicking on a column header or by using keyboard.
To change the order, simply sort again.

By default, the list is sorted by package name in ascending order.

Possible sort options:

Key binding Sorts by
Shift + N package name
Shift + S source/repository
Shift + I installed state
Shift + M last modified date
Shift + P popularity

Installing / Removing a package

To install or remove a package, make sure that the result-list is focused.
Navigate to the package and then press ENTER.
This will execute the Install/Uninstall command and suspend pacseek until the execution finished.

Upgrading

To run the upgrade command, hit Ctrl + U.
If you chose to use separate commands for the AUR, the AUR upgrade command is executed with Ctrl + A.

You can also generate a list with upgradable packages with Ctrl + G or flag -u when starting pacseek.
This will download/sync to a temporary database (similar to checkupdates from pacman-contrib)
and perform AUR lookups to display a list of upgradable packages.

Settings

To open the settings form, press Ctrl + S. It will open on the right side where the package details are shown.
Navigate to the settings form with TAB or Ctrl + Right.
You can navigate back to the previously selected component with Ctrl + Left.

To navigate though the different options on the form, use either TAB or Ctrl + Down.
Going upwards to the previous option can be done with Ctrl + Up.
(You can also simply use Down and Up unless you end up on a drop-down, so it's recommended to use Ctrl...)

Checkbox and drop-down values can be changed with Space or Enter.

To save your changes, navigate to the "Apply & Save" button and press Enter.

The individual settings are explained in the Configuration section...

Resizing components

In some cases you might change the size / ratio between the result-list and the details components.
For example if you have long package names in the result-list.

This can be done with Shift + Left/Right

resize

Command line options

The following options can be used with pacseek:

Option Description
-r Limit searching to a comma separated list of repositories
-s Search term
-a ASCII mode
-m Monochrome mode
-u Show upgrades after startup
-i show installed packages after startup

The -a, (ASCII mode) option can be used if your terminal emulator does not support Unicode characters.

Examples:

Immediately start searching for linux, but only within the core repository

  • $ pacseek -s linux -r core

Search for firefox in community and extra

  • $ pacseek -s firefox -r community,extra

Search for firefox in all available repositories

  • $ pacseek -s firefox
  • $ pacseek firefox (old way of searching still works, but might be removed at some point)

Don't start a search, but limit all results in this session to core and extra

  • $ pacseek -r core,extra
Clone this wiki locally