82 lines
3.6 KiB
Markdown
82 lines
3.6 KiB
Markdown
PwdStore
|
|
========
|
|
[](https://webchat.freenode.net/?channels=%23Android-Password-Store&uio=d4)
|
|
[](https://gitter.im/zeapo/android-password-store?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
[](https://android-arsenal.com/details/1/1208)
|
|
|
|
This application tries to be 100% compatible with [pass](http://www.passwordstore.org/)
|
|
|
|
You can install the application from:
|
|
|
|
- [F-Droid](https://f-droid.org/repository/browse/?fdid=com.zeapo.pwdstore) (the prefered way)
|
|
- [Play Store](https://play.google.com/store/apps/details?id=com.zeapo.pwdstore) (always lags behind)
|
|
- Using the apk file found at `app/app-release.apk` or build everything from source (always updated before Play Store, but usually after F-Droid)
|
|
|
|
Pull requests are more than welcome (see [TODO](#todo)).
|
|
|
|
Community
|
|
=========
|
|
|
|
A few ways to get in touch:
|
|
|
|
- [Github issues](https://github.com/zeapo/Android-Password-Store/issues), use it if you have a bug report, you do not understand how somehting works or feature request
|
|
- [reddit](https://www.reddit.com/r/androidpwd), want to discuss something and it's midnight, no one on irc and you really want to write more than a couple of lines? reddit is your way!
|
|
|
|
|
|
|
|
|
|
FAQ
|
|
====
|
|
|
|
- **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`.
|
|
|
|
TODO
|
|
=====
|
|
**Urgent**
|
|
- Implement a keyboard to replace the copy/paste and avoid clipboard hijicking (see [#50](https://github.com/zeapo/Android-Password-Store/issues/50))
|
|
|
|
**Less urgent**
|
|
- Create a new category
|
|
- Multi-select (for password deletion)
|
|
- Multiple password stores (multiple git repositories).
|
|
- Solve issues labeld as *enhancement* (see [enhancement issues](https://github.com/zeapo/Android-Password-Store/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement))
|
|
|
|
How-To
|
|
======
|
|
*Note:* This section is work in progress
|
|
|
|
Clone using SSH-key, then decrypt a password
|
|
--------------------------------------------
|
|
|
|
<img src="tutorial_clone_ssh_then_decrypt.gif" alt="Clone And Decrypt" style="width:720px">
|
|
|
|
|
|
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
|
|
|
|
Libraries
|
|
=========
|
|
This project uses three libraries:
|
|
|
|
- [OpenKeyChain](https://github.com/open-keychain/open-keychain) for encryption and decryption of passwords.
|
|
To download the library, run the following commands at the root of the project
|
|
|
|
git submodule init
|
|
git submodule update
|
|
|
|
|
|
- [JGit](http://www.eclipse.org/jgit/) a pretty good git lib
|
|
- [Apache's FileUtils](https://commons.apache.org/proper/commons-io/) for files manipulations
|
|
|
|
|
|
[](https://www.changetip.com/tipme/zeapo)
|