Android-Password-Store/README.md
yowtsi 594ad0a15e Update README.md with note to use bare repos only
Also update link to official pass website.
2014-11-01 23:05:48 +01:00

2.8 KiB

PwdStore

This application tries to be 100% compatible with pass

You can install the application from:

  • F-Droid (the prefered way)
  • Play Store (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)

Community

A few ways to get in touch:

  • Github issues, use it if you have a bug report, you do not understand how somehting works or feature request
  • IRC : on irc://chat.freenode.net/Android-Password-Store (that means channel #Android-Password-Store on freenode), some of us hangout there
  • reddit, 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!

How-To

Note: This section is work in progress

Clone using SSH-key, then decrypt a password

Clone And Decrypt

Make sure to only clone from bare repositories (see git-clone(1) for how to create a bare repository from an existing one). Otherwise the clone will fail.

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 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 a pretty good git lib

  • Apache's FileUtils for files manipulations

TODOs

  • Create a new category
  • Multi-select (for password deletion)
  • Multiple password stores (multiple git repositories).
  • More UI enhancements
  • Clean-up the hard-coded strings

Needed

  • Icons: the current ones are CC, but would be great to have our own icons
  • UI enhancements: any UI changes or suggestions are welcome

Bitdeli Badge