QTPass Guide

QTPass Guide

 * Windows 10 is assumed.
 * Yubikey 5 smartcard is assumed.
 * Key generation is outside the scope of this article.
 * Ctrl-S is responsible for making this, but you can join in if you like.

Installation
Download software - git, gpg, qtpass (Preparation for install) TODO
 * git
 * gpg
 * qtpass

Install software - git, gpg, qtpass TODO
 * git
 * gpg
 * qtpass

Install using Chocolatey (package manager): https://chocolatey.org/install
 * Install Chocolatey package manager:
 * Install QTPass package:

Configure git
 * TODO Git setup

Configure GPG
 * TODO Kleopatra setup
 * Verify by listing installed keys

Configure QTPass TODO: Figure out how to make PWGen work.
 * The settings window is opened by clicking on the slider icon at the top of the main window.
 * Set path to Git executable
 * Set path to GPG executable
 * Set path to PWGen executable
 * Set key to use, the window to do this is opened by clicking on the person sillouette icon at the top of the main window.
 * Create a profile in the settings window "Profiles" tab.
 * (If needed) Initialize the git repo at the storage location:

Testing QTPass
TODO TODO
 * Create a test entry in a test folder

TODO
 * Read back test entry

Using a smartcard

 * TODO yubikey 5 smartcard

Using QTPass
TODO normal basic usage
 * Add new password / credentials
 * Read saved password / credentials

Renaming an entry in the UI can rename the file to what you tell it to rename to, omitting the .gpg extention that is normally present on the file itself. This can be fixed by going to the password store folder and adding the .gpg file extention
 * Renaming a password entry

Migration into QTPass
TODO bulk import of credentials

First line should be the password itself (Does QTPass do this for the user?)
 * Pick a consistant naming & organization scheme

TODO
 * Tools for mass-import

TODO
 * Manual import

"could not read encryption key to use, .gpg-id file missing or invalid."
"void ImitatePass::Insert(QString file, QString newValue, bool overwrite) {" https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L95 or "void ImitatePass::reencryptPath(const QString &dir) {" https://github.com/IJHack/QtPass/blob/8f2b87b36bd74f1c104653bf22150185125c365c/src/imitatepass.cpp#L298 TODO
 * Tracing error cause:
 * Message originates in either of these two functions:
 * Resolution:

"fatal: not a git repository (or any of the parent directories): .git"
"fatal: not a git repository (or any of the parent directories): .git"
 * Error message:
 * Tracing error cause:

Manually initializing a git repo in the new password store location fixes this. In folder of password storage:
 * Resolution: TODO

"fatal: not a git repository (or any of the parent directories): .git"
After enabling the use of PWGen for password creation, attempting to create a password results in PWGen opening with an error message followed by possible crash of QTPass. PWGen encountered 1 error(s) during startup: 1) Unknown command line switch(es): "-1"; "--secure"; "--capitalize"; "--numerals".
 * Symptoms:
 * Error message:

PWGen probably changed how it accepts arguments? TODO
 * Tracing error cause:
 * Resolution:

Handy seeming links
QTPass homepage:
 * https://qtpass.org/
 * https://github.com/IJHack/QtPass

PWGen-win homepage:
 * http://pwgen-win.sourceforge.net/
 * https://sourceforge.net/projects/pwgen-win/
 * http://pwgen-win.sourceforge.net/downloads.html

Appears to be modern home of Kleopatra / Windows GPG:
 * https://gpg4win.org/get-gpg4win.html
 * https://gpg4win.org/documentation.html

Appears to be older home of Kleopatra / Windows GPG:
 * https://www.openpgp.org/software/kleopatra/
 * https://docs.kde.org/stable5/en/pim/kleopatra/index.html

Pass homepage:
 * https://www.passwordstore.org/

GoPass:
 * https://www.gopass.pw/
 * https://github.com/gopasspw/gopass
 * https://github.com/gopasspw/gopass/releases

Smartcard-related:
 * https://developers.yubico.com/PGP/
 * https://developers.yubico.com/PGP/Git_signing.html