kcp(1)

NAME

kcp - Tool in command-line for KaOS Community Packages

SYNOPSIS

kcp (-hvlusgicxfNSIOdDV) [<app>]

DESCRIPTION

kcp provides a tool to make the use of KaOS Community Packages easier. With this tool, you can:

•   list all packages of KaOS Community Packages,

•   search a package in KaOS Community Packages,

•   download needed files to install a package from KaOS Community Packages,

•   install a package of KaOS Community Packages.

COMMAND OPTIONS

-h, --help
    Display the list of the available options

-v, --version
    Display the current version of kcp

-u, --update-database
    Refresh the local database. The database is a file (see CREATED FILES chapter) which contains the following informations:

•   The name of a package,

•   Its description,

•   Its installed version (if installed),

•   Its latest version in KaOS Community Packages,

•   Its popularity.

-l, --list
    Display the list of all packages. By default, it displays all informations contained in the database (name, remote/local version, popularity & description)

-s, --search <app>
    Display the list of all packages which contain the keyword <app> in the name or the description.

-g, --get <app>
    Download the package <app> from KaOS Community Packages in the current directory.

-i, --install <app>
    Download, compile and install the package <app> from KaOS Community Packages.

-V, --information <app>
    Display information on a given package.

SPECIFIC OPTIONS

-f, --force-update
    By default, displaying list of packages uses the informations from the local database. With this option, the database is refreshed before displaying the list. It can be used only if -l or -s option is used.

-x, --sort
    On packages’ display operation, sort the results by popularity, then, by name. This option can be used only with -l or -s options.

-N, --only-name
    On packages’ display operation, display only the name of the packages. This option can be used only with -l or -s options.

-S, --only-starred
    On packages’ display operation, display only the packages which are popular. This option can be used only with -l or -s options.

-I, --only-installed
    On packages’ display operation, display only the packages which are installed on the system. This option can be used only with -l or -s options.

-O, --only-outdated
    On packages’ display operation, display only the packages which are installed on the system and whose installed version isn’t the same as KaOS Community Packages version. This option can be used only with -l or -s options.

-d, --asdeps
    Install packages non-explicitly; in other words, fake their install reason to be installed as a dependency. This is useful to install dependencies before building the package.

--debug
    For internal use only. Display useful logtraces, in order to identify a potential problem.

CONFIGURATION

The program can be set through a .conf file in INI format. By default The /etc/kcp/kcp.conf is used for all users of the system. If you want override some settings or all settings for a specific user, you need to copy this file to the $XDG_CONFIG_HOME/kcp/ dir. If the environnment variable $XDG_CONFIG_HOME is not set, it uses $HOME/.config/kcp/ instead.

All parameters are commented in /etc/kcp/kcp.conf.

CREDITS

This is free and unencumbered software released into the public domain.
    http://unlicense.org/ for more information.

SEE ALSO

For more information regarding kcp, see the following:

The official code repository at
    <git://codeberg/bvaudour/kcp>

You can contact the project by emailing
    <benjamin.vaudour@gmx.fr>

REPORTING BUGS

Bugs in kcp may be reported to the issue-tracker at
    <https://codeberg.org/bvaudour/kcp/issues>