passmgr

README

passmgr

passmgr is a simple portable password manager.

Usage

Just call passmgr from your command line. The application will tell you how to proceed.

Read the command documentation for more detailed instructions and examples.

Install

Download the latest release for your platform, or build from source: go get github.com/urld/passmgr/cmd/passmgr

Dependencies

• github.com/atotto/clipboard
• github.com/bgentry/speakeasy
• golang.org/x/crypto/scrypt

Platforms

• OSX
• Windows
• Linux (requires xclip or xsel command to be installed, probably works on other *nix platforms too)

Limitations

• no protection against keyloggers
• no protection against cliboard spies

TODO

• look into improved clipboard handling hn comment

Documentation

Overview

Package passmgr defines a store for credentials.

Index

• type Store
• type Subject

Types

type Store

type Store interface {

	// List retrieves a list of all Subjects known to the store.
	// The Secrets map of the returned Subjects is empty. To retrieve the
	// complete Subject including its secrets, the Load method needs to be
	// used.
	List() []Subject

	// Load looks up a Subject, identified by its User and URL fields.
	// It returns the complete Subject including its secrets and a flag
	// indicating whether the lookup was successful or not.
	Load(Subject) (s Subject, ok bool)

	// Store adds a new Subject to the store, or updates an existing one.
	Store(Subject)

	// Delete removes a subject from the store. It returns false if the
	// Subject to delete could not be found.
	Delete(Subject) bool
}

Store provides access to stored credentials.

type Subject

type Subject struct {
	User    string
	URL     string
	Secrets map[string]string
}

Subject contains various secrets for a given user name. Usually the URL and User fields are used as unique identifiers.