LinuxCommandLibrary

kwallet-query

Query and manage KDE Wallet contents

TLDR

List all entries in the Passwords folder of kdewallet

$ kwallet-query [kdewallet] [[-l|--list-entries]]
copy

List all entries in a specific folder
$ kwallet-query [kdewallet] [[-l|--list-entries]] [[-f|--folder]] [folder_name]
copy

List all available folders
$ kwallet-query [kdewallet] [[-l|--list-entries]] [[-f|--folder]] ""
copy

Display help
$ kwallet-query [[-h|--help]]
copy

SYNOPSIS

kwallet-query [options] command [command arguments]

PARAMETERS

--help
    Show help about options

--help-all
    Show all help, including hidden options

--help-kde
    Show KDE specific options

--version
    Show program version

--list
    List available wallets

--create walletname user description
    Create a new wallet

--close walletname
    Close a wallet

--open walletname
    Open a wallet

--folder walletname foldername
    List entries in a folder

--entry walletname foldername entryname
    Read an entry

--deleteentry walletname foldername entryname
    Delete an entry

--renameentry walletname foldername oldentryname newentryname
    Rename an entry

--createfolder walletname foldername description
    Create a new folder

--deletefolder walletname foldername
    Delete a folder

--renamefolder walletname oldfoldername newfoldername
    Rename a folder

--change-password walletname
    Change wallet password

--check-password walletname
    Check wallet password

--isEnabled
    Check if the KDE Wallet is enabled

DESCRIPTION

The `kwallet-query` command-line utility is used to interact with the KDE Wallet system. KDE Wallet is a secure storage system for passwords, web form data, and other sensitive information. `kwallet-query` allows users to query the contents of wallets, create new wallets, list wallets, and perform other administrative tasks from the command line. It provides a non-graphical interface for managing KDE Wallets, which can be useful in scripts or environments where a GUI is not available.

The tool relies on the `kwalletd5` daemon to function. Operations such as opening, closing, reading, and writing to wallets are facilitated through communication with this daemon. Because of the reliance on `kwalletd5`, the command's effectiveness depends on a functioning KDE environment and a correctly configured wallet system. Incorrect parameters can potentially expose sensitive information or cause unexpected behavior with wallet management.

Common use cases include scripting password retrieval, checking wallet existence, and automating wallet management tasks within a larger system administration context. Although powerful, careful consideration should be given to security implications when automating `kwallet-query` in a production environment. For instance, ensure appropriate user permissions and avoid storing passwords directly in scripts. The command is particularly suited to systems requiring scripting access to KDE wallet functions, however graphical interfaces may be more appropriate for general user administration.

CAVEATS

Requires a running KDE environment and kwalletd5 daemon. Sensitive information (e.g., passwords) may be exposed if not used carefully in scripts. Ensure proper user permissions.

SECURITY CONSIDERATIONS

Important: When using `kwallet-query` in scripts, avoid hardcoding passwords directly in the script. Consider using environment variables or prompting the user for input. Ensure that the script has appropriate file permissions to prevent unauthorized access. Always handle sensitive data with care.

EXAMPLES

1. List all available wallets: `kwallet-query --list`
2. Read password from entry: `kwallet-query --entry mywallet myfolder myentry`
3. Create a new folder: `kwallet-query --createfolder mywallet myfolder "Folder description"`

HISTORY

The `kwallet-query` command is a part of the KDE Frameworks and has evolved alongside the KDE desktop environment. It was developed as a command-line interface to interact with the KDE Wallet system, providing a way to manage wallet data without relying on a graphical user interface. Its usage has grown with the increasing adoption of KDE and the need for scripting wallet management tasks.

SEE ALSO

kwalletd5(1), kdialog(1)

Copied to clipboard