KWALLET-QUERY(1)

✨ NAME ✨

okay so bestie, welcome to kwallet-query — it's the KDE Wallet command-line manipulation tool 💅 and yes she serves.

🫶 SYNOPSIS 🫶

kwallet-query OPTIONS wallet

🌸 DESCRIPTION 🌸

kwallet-query is literally that girl when your shell scripts need to read or update the KDE Wallet. the way it works?? it goes in and manipulates the entries you'd normally see chillin' in the KDE Wallet Manager utility 🎀

its only parameter is walletname — that's the wallet our girl should read or update. and what mode she's in? that's all decided by the options you hand her. no cap. ✨

💖 OPTIONS 💖

• -h, --help — pops up a short help message. quick lil "hi here's how to use me" moment 🎀
• -l, --list-entries — lists the password entries. these are the folder names you'd see in the KDE Wallet Manager utility. and ooh — if you also pass the -f option, she'll only show you the subfolders inside that specified folder 🦋
• -r, --read-password Entry — reads the contents of the given Entry from the Folder section of the wallet and drops it right onto standard output. and maps?? maps get exported as a JSON object, periodt 👑
• -w, --write-password Entry — writes secrets into the given Entry under the Folder section of the wallet you named. the secrets come in from standard input, bestie. maps take in a well-formed JSON object as input.

⚠️ IMPORTANT: the previous wallet entry value is getting OVERWRITTEN by this option. like, gone. so be careful when you use it, fr fr 💀

• -f, --folder Folder — sets the wallet folder to whatever Folder value you give it. by default it's Passwords 🌈
• -v, --verbose — outputs more information while she's doing the operation, which is genuinely so helpful for debugging. lowkey iconic 🙈

🔥 EXIT STATUS 🔥

• 0 — success!! she ate 💅✨
• 1 — the wallet wallet was not found. she's just... not there 😭
• 2 — the wallet wallet could not be opened. for example, that's a sign of a bad password entry, or some other problem with the KDE Wallet system. vibe check failed 💀
• 3 — the Folder section was not found inside the wallet wallet. maybe the wallet file is corrupt?? 🫣
• 4 — the read or write operation has failed for some reason. it's giving mystery. it's giving ✨unexplained✨ 😭

🐛 BUGS 🐛

please report all bugs on the KDE bug reporting website: bugs.kde.org. and when you submit your bug-report, make sure you select “kwallet-query” — don't be shy, pick the right one bestie 🎀

👑 AUTHOR 👑

kwallet-query was originally written by Valentin Rusu and is part of KDE.

🧚 COPYING 🧚

Copyright (C) 2015 Valentin Rusu. free use of this software is granted under the terms of the GNU General Public License (GPL). slay 💜

🌟 AUTHOR (again, because she deserves two shoutouts) 🌟

• Valentin Rusu <kde@rusu.info> — original author 🌸

okay that's the whole thing!! and just so you know, this lil page is from Frameworks 5.11, dated 2015-06-14 — so she's vintage, she's classic, she's still got main character energy. go forth and manage those wallets, bestie 🫶💖✨