PACSEEK(1)

NAME
pacseek - A TUI for searching and installing Arch Linux packages

SYNOPSIS
pacseek [options] [search-term]

DESCRIPTION

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.

Package installation/removal is done with an AUR helper. Make sure you have one installed. In the default configuration, yay is being used. You can change this in the settings.

OPTIONS

-r repo1,repo2 ...
    Limit searching to a comma separated list of repositories

-s search-term
    Search term when used with the -r option

-a  ASCII mode

-m  Monochrome mode

-u  Show upgrades after startup

-i  Show installed packages after startup

-h, --help
    Display help and exit

KEY BINDINGS

Enter
    Search;
    Install or remove a selected package

Tab, Ctrl+Up/Down/Left/Right
    Navigate between boxes

Up/Down, j/k
    Scroll through the package list

Shift+Left/Right
    Change size of package list

Ctrl+s
    Open/Close settings

Ctrl+n
    Show help/key bindings

Ctrl+u
    Perform sysupgrade

Ctrl+a
    Perform AUR upgrade (if configured)

Ctrl+w
    Wipe cache

Ctrl+p
    Show PKGBUILD for selected package

Ctrl+o
    Open URL for selected package

Ctrl+g
    Show list of upgradable packages

Ctrl+l
    Show list of all installed packages

Ctrl+b
    Show about/version information

Esc, Ctrl+q
    Quit

Shift+n
    Sort by package name

Shift+s
    Sort by source/repository

Shift+i
    Sort by installed state

Shift+m
    Sort by last modified date

Shift+p
    Sort by popularity (AUR packages)

CONFIGURATION

All configurations files are formatted in JSON.

  General settings

When pacseek is started the first time, it will generate a configuration file ~/.config/pacseek/config.json. You can either manually edit this file or use the settings screen make changes.

Save any changes that you've made with the Apply & Save button.

"AurRpcUrl": "string"
    The URL to the aurweb/RPC endpoint. This endpoint provides REST APIs that are used for searching. The default is https://aurapi.moson.org/rpc (not the official AUR one).

"AurTimeout": number
    How long to wait for a response from the AUR/RPC endpoint (in milliseconds). If the timeout is exceeded only the list of repository packages are returned. The default is 5000.

"AurSearchDelay": number
    The delay (in milliseconds) that is applied before we start querying for package details (mostly obsolete in the latest versions of pacseek). It will only be applied when the cache is disabled or the entries in the cache have expired and you are navigating through the result list. In that case, it will query package information again from the AUR but wait for a certain amount of time before doing so. That's being done to not run unnecessary queries (e.g. if you quickly navigate through the result list). The default is 500.

"AurUseDifferentCommands": bool
    Use separate commands repository and AUR packages installing/upgrading. Once enabled, the new commands should be configured in the AurInstallCommand and AurUpgradeCommand options. The default is false.

"AurInstallCommand": string
    Install command for AUR packages when AurUseDifferentCommands is enabled.

"AurUpgradeCommand": string
    Upgrade command for AUR packages when AurUseDifferentCommands is enabled.

"DisableAur": bool
    When enabled, The AUR will not be queried when searching. Only the repositories defined in pacman.conf will be searched. The default is false.

"MaxResults": number
    The maximum number of results that are displayed in the result list. Note that when SearchMode is set to StartsWith, it is limited to 100 results from the AUR. This is a limitation of an API call that is being used (using the official endpoint has an even lower maximum of 20 results). The default is 500.

"PacmanDbPath": "string"
    The path to the pacman database files. The default is /var/lib/pacman/.

"PacmanConfigPath": "string"
    The path to the pacman configuration file The default is /etc/pacman.conf.

"InstallCommand": "string"
    The command that is being run when installing a package. The package name is appended to this command. You can also use the placeholder {pkg} in your command which will be replaced by the package name (in this case the package name will not being appended). The default is yay -S.

"UninstallCommand": "string"
    The command that is being run when uninstalling a package. The default is yay -Rs.

"SysUpgradeCommand": "string"
    The command that is being run when upgrading packages with Ctrl+u The default is yay.

"SearchMode": "string"
    There are two search modes available. With the Contains (default) option, it will show results where the name/description contains the search-term at any position. When using the StartsWith option, only those packages are shown where the very beginning of a package name/description matched the search-term.

"SearchBy": "string"
    When set to Name (default), only the package name will be matched against the search-term. Setting this to Name & Description will match the the search-term with the description as well.

"CacheExpiry": number
    The time (in minutes) until the cached search and package info data expires. The default is 10.

"DisableCache": bool
    Search results will be cached so that we do not query the AUR for package details each time you navigate to another package in the result list. Enabling this option will completely disable caching and force pacseek to run a request every time you search or select another package. Disabling the cache is not recommended since it wasting server resources (this option may be removed in the future). The default is false.

"ColorScheme": "string"
    The color schemes available are Arch Linux (default), Endeavour OS, Red, Green, Blue, Orange, Monochrome. If you want to define your own color scheme, set it to Custom. This will generate a file ~/.config/pacseek/colors.json in which you can change the color for various UI elements.

"Transparent": bool
    When checked, pacseek will use a transparent background color instead of black. The default is false.

"BorderStyle": "string"
    Choose how the borders are being drawn. The styles available are Double (default), Thick, Single, Round.

"GlyphStyle": "string"
    The glyph styles available are Plain, Angled, Round, Curly, Pipes, ASCII, Plain-No-X, Angled-No-X (default), Round-No-X, Curly-No-X, Pipes-No-X, ASCII-No-X. If you want to define your own glyph style, set it to Custom. This will generate a file ~/.config/pacseek/glyphs.json in which you can the glyphs used for various UI elements.

"SaveWindowLayout": bool
    When checked, the current layout is saved The default is false.

"ShowPkgbuildCommand": "string"
    The command that is being executed when clicking on Show PKGBUILD in the details or by pressing Ctrl+p. The term {url} will be replaced by the PKGBUILD url (it should be included in your custom command). This option is only applicable when ShowPkgbuildInternally is disabled The default is curl -s "{url}" | less.

"ShowPkgbuildInternally": bool
    When enabled, the PKGBUILD file will be displayed within pacseek. The default is true.

"DisableNewsFeed": bool
    When checked, the news feed will be disabled. The default is false.

"FeedURLs": "string"
    The RSS feed URL(s) for displaying news items. Multiple URL's can be specified by separating them with a semi-colon. This option is only applicable when DisableNewsFeed is unchecked The default is https://archlinux.org/feeds/news/.

"FeedMaxItems": number
    The maximum number of news items to display. This option is only applicable when DisableNewsFeed is unchecked The default is 5.

"EnableAutoSuggest": bool
    When enabled, a list of package names is shown while typing The default is false.

"ComputeRequiredBy": bool
    When enabled, it will compute the list of Required by packages and display it in the details. This is resource intensive and should be enabled only if you really need it. The default is false.

"PackageColumnWidth": number
    The width for the package column. Set it to 0 to dynamically adjust the width. The default is 0.

"SepDepsWithNewLine": bool
    When enabled, pacseek will separate the list of Dependencies (in the details) with a new line instead of comma. The default is true.

  Glyph customization

These settings are used after setting the GlyphStyle option to Custom. This will generate a file at ~/.config/pacseek/glyphs.json which should be edited with the following options

Glyph options

    •   "Package": "string"

    •   "Installed": "string"

    •   "NotInstalled": "string"

    •   "PrefixState": "string"

    •   "SuffixState": "string"

    •   "Settings": "string"

    •   "Pkgbuild": "string"

    •   "Help": "string"

    •   "Upgrades": "string"

  Color scheme settings

These settings are used after setting the ColorScheme option to Custom. This will generate a file at ~/.config/pacseek/colors.json which should be edited with the following options

Color options
    These options should be set with hexadecimal color codes (e.g. ffff00 for yellow).

    •   "Accent": "string"

    •   "Title": "string"

    •   "SearchBar": "string"

    •   "PackagelistSourceRepository": "string"

    •   "PackagelistSourceAUR": "string"

    •   "PackagelistHeader": "string"

    •   "SettingsFieldBackground": "string"

    •   "SettingsFieldText": "string"

    •   "SettingsFieldLabel": "string"

    •   "SettingsDropdownNotSelected": "string"

Syntax highlighting

    "StylePKGBUILD": "string"
        Syntax highlighting for the PKGBUILD when ShowPkgbuildInternally is enabled. The available styles for this option are abap, algol, algol_nu, api, arduino, autumn, borland, bw, colorful, dracula, emacs, friendly, fruity, github, igor, lovelace, manni, monokai, monokailight, murphy, native, paraiso-dark, paraiso-light, pastie, perldoc, pygments, rainbow_dash, rrt, solarized-dark, solarized-dark256, solarized-light, swapoff, tango, trac, vim, vs, xcode. These styles can previewed here (https://xyproto.github.io/splash/docs/all.html).

FILES

~/.config/pacseek/config.json
    The default configuration file

~/.config/pacseek/colors.json
    Custom color scheme settings

REPORTING BUGS
Report bugs to GitHub Issues (https://github.com/moson-mo/pacseek/issues).

AUTHORS
Mario Oenning (mo-son@mailbox.org)

SEE ALSO
See the pacseek wiki (https://github.com/moson-mo/pacseek/wiki) for more information pacman(8), pacman.conf(5)