Home

Welcome to the Android-Password-Store wiki!

How-To

First time setup

This is a walkthrough of the options you will be presented with the first time you start the app. All of these options can be changed later in the settings.

Create new – select this if you do not already use pass or do not have your password store synchronized with git

Clone existing – if your password store is synchronized with git you can clone it

Regardless of which of the above you pick you will be asked for the repository location:

SD-card – put the password store in a folder you specify. You should select this if you use something like bittorrent sync or syncthing to keep a particular folder on your device synchronized

Hidden (preferred) – put the password store in the app’s private folder located on your device’s internal storage http://developer.android.com/guide/topics/data/data-storage.html#filesInternal. This folder is not viewable unless you are rooted

If you selected ‘Clone existing’ at the first step you will be asked for repository information. As you fill it in make sure the resulting URL looks right.

If you then select ssh-key for your authentication mode you will be prompted to either import your private key or generate a key pair.

Tap the ‘Clone’ button and the app will attempt to clone the git repository. This is where problems usually occur. Search https://github.com/zeapo/Android-Password-Store/issues if you encounter a problem. There is a wide range of possible server configurations and the app has to rely on somewhat outdated versions of libraries so it is sometimes difficult to replicate issues, determine if it’s out of the app’s control, etc.

When you try to create or view a password for the first time you will be prompted to select the OpenPGP provider. You should install and set up OpenKeychain https://github.com/open-keychain/open-keychain if you haven’t already. Scroll to the ‘Crypto’ section of the settings and select everything there.

You should now be ready to use the app.

Autofill

This app can fill password fields in native apps, Google Chrome, and WebViews. When you tap on a password field a dialog will pop up offering to fill the field for you. To enable this feature, find the 'Autofill' section in the settings and turn on the accessibility service.

Under 'App and website settings' you can assign different behaviors for each installed app or website (added with the fab):

Use default - use the setting specified by the checkbox in the main 'Settings' page

Automatically match - attempt to automatically find a matching password by searching for passwords containing the app's name or, for websites, passwords whose names are contained in the website title or URL

Match with... - in the popup only offer to fill using these passwords you specify. Tap the '+' button to add another password, tap a password to remove it from the list

Never match - never show the autofill dialog in this app/website