2018-09-28 12:52:27 +00:00
Password Store
2014-08-06 19:35:03 +00:00
========
2015-01-05 16:28:23 +00:00
[![Android Arsenal ](https://img.shields.io/badge/Android%20Arsenal-Android--Password--Store-blue.svg?style=flat )](https://android-arsenal.com/details/1/1208)
2019-10-02 05:14:16 +00:00
[![GitHub workflow ](https://github.com/password-store/Android-Password-Store/workflows/CI%20builds/badge.svg )](https://github.com/password-store/Android-Password-Store/actions)
2018-04-01 13:12:08 +00:00
[![Backers on Open Collective ](https://opencollective.com/Android-Password-Store/backers/badge.svg )](#backers) [![Sponsors on Open Collective ](https://opencollective.com/Android-Password-Store/sponsors/badge.svg )](#sponsors)
2017-01-11 16:20:34 +00:00
2014-11-01 22:05:48 +00:00
This application tries to be 100% compatible with [pass ](http://www.passwordstore.org/ )
2014-08-06 19:35:03 +00:00
2014-10-29 22:34:16 +00:00
You can install the application from:
2019-09-17 09:53:56 +00:00
- [F-Droid ](https://f-droid.org/repository/browse/?fdid=com.zeapo.pwdstore )
- [Play Store ](https://play.google.com/store/apps/details?id=com.zeapo.pwdstore )
2014-10-29 22:34:16 +00:00
2018-09-28 12:52:27 +00:00
Pull requests are more than welcome (see [TODO ](https://github.com/zeapo/Android-Password-Store/projects/1#column-228844 )).
Features
========
- Clone an existing pass repository (ssh-key and user/pass support)
- List the passwords
- Handle the directories as categories
- Decrypt the password files (first line is the password, the rest is extra data)
- Add a new password to the current category (or no category if added at the root)
- Pull and Push changes to the remote repository
- Ability to change remote repository info
2014-12-04 23:18:17 +00:00
2016-04-25 21:25:10 +00:00
How-To
======
2018-10-14 08:24:55 +00:00
See the [wiki ](https://github.com/zeapo/Android-Password-Store/wiki/First-time-setup ) for a newer written version of the following gif walkthrough
2014-12-14 15:21:37 +00:00
2014-11-04 21:35:38 +00:00
FAQ
====
2018-10-14 08:24:55 +00:00
**Q:** What kind of repository can I clone from?
**A:** Make sure to only clone from bare repositories (see [git-clone(1) ](http://git-scm.com/docs/git-clone ) for how to create a bare repository from an existing one). Otherwise the clone will fail.
**Q:** I get a "Permission Denied" error when trying to import my ssh-key, why?
**A:** ssh-key files are usually created with permissions set to `600` , meaning that only the creator of this key has the right to read from it. The application needs a read access, at least temporarily, make the permissions to `644` , import the key, then set them back to `600` .
**Q** I get the error *No encrypted data with known secret key found in stream*
**A** In OpenKeyChain ** (under the left drawer) Apps > Password Store > Accounts > (select the account) > Account key** select the key used to encrypt your passwords.
2014-11-04 21:35:38 +00:00
2016-04-25 21:25:10 +00:00
Community
=========
2018-09-28 12:52:27 +00:00
Ways to get in touch:
2015-07-19 12:26:09 +00:00
2018-09-28 12:52:27 +00:00
- [Github issues ](https://github.com/zeapo/Android-Password-Store/issues ), use it if you have a bug report, you do not understand how something works or you want to submit a feature request.
2015-03-14 16:05:16 +00:00
2019-01-02 14:06:24 +00:00
## Contributing Translations
Interested in helping to translate Password Store? Contribute here:
https://www.transifex.com/android-password-store/android-password-store/
2014-08-06 19:35:03 +00:00
Libraries
=========
2018-09-28 12:52:27 +00:00
Libraries that this project uses:
2014-08-06 22:07:42 +00:00
2014-08-15 20:57:07 +00:00
- [OpenKeyChain ](https://github.com/open-keychain/open-keychain ) for encryption and decryption of passwords.
2018-09-28 12:52:27 +00:00
- [JGit ](http://www.eclipse.org/jgit/ ) git library.
- [Apache's FileUtils ](https://commons.apache.org/proper/commons-io/ ) for file manipulations.
2018-04-01 13:12:08 +00:00
## Contributors
2018-10-14 08:24:55 +00:00
This project exists thanks to all the people who contribute. Want to contribute? See if you can [find an issue ](https://github.com/zeapo/Android-Password-Store/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc ) you wanna close, then send a PR!
< a href = "https://github.com/zeapo/Android-Password-Store/graphs/contributors" > < img src = "https://opencollective.com/Android-Password-Store/contributors.svg?width=890&button=false" / > < / a >
2018-04-01 13:12:08 +00:00
## Backers
Thank you to all our backers! 🙏 [[Become a backer ](https://opencollective.com/Android-Password-Store#backer )]
< a href = "https://opencollective.com/Android-Password-Store#backers" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/backers.svg?width=890" > < / a >
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor ](https://opencollective.com/Android-Password-Store#sponsor )]
< a href = "https://opencollective.com/Android-Password-Store/sponsor/0/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/0/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/1/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/1/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/2/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/2/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/3/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/3/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/4/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/4/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/5/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/5/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/6/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/6/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/7/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/7/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/8/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/8/avatar.svg" > < / a >
< a href = "https://opencollective.com/Android-Password-Store/sponsor/9/website" target = "_blank" > < img src = "https://opencollective.com/Android-Password-Store/sponsor/9/avatar.svg" > < / a >