kwallet-query
Query and manage KDE Wallet contents
TLDR
List all entries in the Passwords folder of kdewallet
List all entries in a specific folder
List all available folders
Display help
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)