QtPass 1.4.0
Multi-platform GUI for pass, the standard unix password manager.
No Matches


Can't save a password

  • Is folder initialised? Easiest way is to use the [Users] button and make sure you can encrypt for someone (eg. yourself)
  • Are you using git? If not, make sure it is switched off.

I have an issue with GNOME keyring

  • Disable GNOME keyring
  • Create a ~/.gnupg/gpg-agent.conf containing:
default-cache-ttl 600
max-cache-ttl 7200

Also, the following is useful to add to your .bashrc if you are using Yubikey NEO on Ubuntu:

# OpenPGP applet support for YubiKey NEO
if [ ! -f /tmp/gpg-agent.env ]; then
killall gpg-agent;
eval $(gpg-agent --daemon --enable-ssh-support > /tmp/gpg-agent.env);
. /tmp/gpg-agent.env

I don't get a passphrase / PIN dialog

  • You'll need to install pinentry-qt (or -qt4 or -qt5 or even -gtk) and possibly set the full path to that executable in your ~/.gnupg/gpg-agent.conf for example: pinentry-program /usr/bin/pinentry-qt4
  • On some esotheric systems it might be necessary to create a symbolic link /usr/bin/pinentry to your pinentry application of choice eg: ln -s /usr/bin/pinentry-qt5 /usr/bin/pinentry
  • On macOS pinentry-program /usr/local/bin/pinentry-mac works after installing pinentry-mac from homebrew.

I have an other issue with gpg

  • Possibly you have you key only in gpg and not in gpg2
gpg --export [ID] > public.key
gpg --export-secret-key [ID] > private.key
gpg2 --import public.key
gpg2 --import private.key
rm public.key private.key

Where [ID] is your gpg key-id.

  • It might be the case where it is the other way around, exchange gpg and gpg2 accordingly . .

Git doesn't work on Windows

git for Windows comes with an ssh-askpass compatible command, git gui--askpass (located in /mingw64/libexec/git-core/git-gui--askpass on PortableGit version, presumably some place similar for the installed version).

Git has issues with GPG SSH Authentication

This tutorial might resolve your issues. https://github.com/git-for-windows/git/wiki/OpenSSH-Integration-with-Pageant

Where is the configuration stored?

QtPass tries to use the native config choice for the OS it's running.

  • Linux and BSD: $HOME/.config/IJHack/QtPass.conf
  • macOS: $HOME/Library/Preferences/com.IJHack.QtPass.plist
  • Windows registry: HKEY_CURRENT_USER\Software\IJhack\QtPass

These settings can be over-ruled by a qtpass.ini file in the folder where the application resides. So called "portable config".

There are some things to take care of when trying to sync on some systems (especially OSX, with regards to text and binary .plist files).

More information: http://doc.qt.io/qt-5/qsettings.html#platform-specific-notes

Where can I ask for help?

Can I import from KeePass, LastPass or X?

I don't see icons on the buttons

You do not have the Qt SVG library installed. Please install using your favorite package manager.

I get icons that do not fit my (X11) default

  • On some WindowManagers, Qt doesn't know what icon set to use. A trick:
export DESKTOP_SESSION=gnome
  • Another possible reason is, that the currently installed Qt Version gives problems (e.g. on Linux Mint 17.3) Then you'll have to install the current version via your package manager or if this is not up-to-date, download it from https://www.qt.io/download/ install it and run:
(sudo) make install

where PATHTOYOURINSTALLATION is the path you selected in the qt installer (default /home/YOURUSER/Qt/ ) and 5.5 has to be adapted for the Qt version you downloaded.

I don't like the design, what gives?

  • It's all on GitHub, clone, change and send a pull request.
  • Open an issue and point out defects or better yet propose changes.

QtPass is not in my native language

  • Unfortunately, QtPass might not support your native language, or the translations might be incomplete. Check if newer versions of QtPass support it.
  • If translations are available but aren't working, try to set the language manually (see below) or open an issue.

How do I set the language manually?

QtPass uses the system language. Changing it depends on your system:

  • on Linux: LANGUAGE=fr qtpass will run QtPass in French.

How can I help improve QtPass?

I would like to donate

  • Time:
    • Read contributing documentation.
    • Fork, clone hack and send a pull request.
    • Find an issue to work on..
    • Participate in our bug bounty, you submit an issue and help us fix it, I send you a bounty.
  • Money:
    • IJhack takes donations in Bitcoin