☠️ Deprecated and unfinished. See passforios instead! Cross-platform mobile implementation of password-store (pass). Work in progress, here be dragons. See the website for more info or to help!
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
App
Tests
android
docs
fastlane
ios
.babelrc
.buckconfig
.editorconfig
.flowconfig
.gitattributes
.gitignore
.vimrc
.watchmanconfig
CONTRIBUTING.md
LICENSE
NOTES.md
README.md
TODO.md
app.json
index.android.js
index.ios.js
package.json

README.md

Passport

Icon

JavaScript Style Guide License

View and manage your pass password store passwords on your iOS and Android devices.

Features

  • Access and decrypt GPG-based files within your Pass-compatible store
  • Copy passwords to pasteboard or display on screen
  • View or copy multi-line Pass content
  • Resets pasteboard contents after 45 seconds when copying data
  • TouchID authentication for storing GPG passphrase
  • Written in React Native and utilises Ignite`

Quick start

  1. Download the app from the App Store or compile for your own device and side-load to your device.

  2. Copy your pass password-store onto your device

    The simplest way to do this is to store your passwords in a git repository, which you can then clone onto your device. Alternatively, you can use SCP, iFile or any other method to transfer the passwords over.

  3. Set up your GPG key:

    1. Export your private key from your desktop, laptop or other computer:
    (desktop)$ gpg --export-secret-key --armor ${KEY_ID} > ${KEY_ID}.asc
    
    1. Copy this file to your iOS device

    2. On the device, import the key:

    (device)$ gpg --import ${KEY_ID}.asc
    
    1. Delete the key file

    2. Test decrypting one of your passwords

    (device)$ gpg -d ~/.password-store/ENTRY.gpg
    
  4. Launch and begin using the Pass app!

Using the app

After launching the app, you will be presented with a listing of files and directories in ~/.password-store. Files starting with '.' are hidden, and .gpg extensions are stripped.

Main Screen

Clicking on a directory will show its contents.

Subdirectory Listing

Clicking on a password file will show a screen with the password file details (name and *'d out password).

Subdirectory Listing

Clicking on the name or password box will copy the respective contents to the pasteboard (clipboard). Since the password is encrypted, you will have to enter you passphrase before it can be copied.

Subdirectory Listing

Building

  1. Obtain the source code and install dependencies:

       git clone https://github.com/davidjb/passport.git
       cd passport
       npm install
    
  2. Run the build for either mobile OS.

    For iOS, run:

    react-native run-ios

    For Android, run Genymotion and then run:

    react-native run-android

  3. Optionally, install to your physical device using either Xcode or (Android).

Contributing

Thanks, all help is greatly appreciated! Check out the CONTRIBUTING.md for details on what to help with and how to easily get started.

Related Articles