supplantr/passless repository overview

⁠passless

passless manages a user-edited GPG-encrypted file containing arguments for the lesspass⁠ command-line client.

⁠Packages

• RPM package available from copr⁠.

  Install with:

  dnf copr enable jcrd/passless
  dnf install passless
  

  Copy

⁠Usage

usage: passless [options] [SITE]

options:
  -h         Show help message
  -f CONFIG  Path to config file
  -i FILE    Encrypt existing file
  -e         Edit config file
  -l LOGIN   Get password of SITE with given login
  -c         Copy password to clipboard
  -s         Show git commit log
  -p         Do not push commits to git remote
  -v         Show version

⁠Automatic sync with remote git repository

If passless detects that its configuration file exists in a git repository, it will:

• pull changes from remote before editing
• commit after editing and re-encryption
• push commits unless the -p flag is present (allows amending commits before push)

Set up a local git repository using the remote origin and branch master:

cd ~/.config/passless
git init
git remote add origin <remote-url>
git branch --set-upstream-to origin/master

⁠Configuration

The configuration file is an INI file where section names are sites and section keys correspond to lesspass command-line arguments.

If a configuration file doesn't exist, the -e flag will create one using a default template.

An existing plain configuration file can be encrypted using the -i flag.

Example:

[example.com]
login=myusername
symbols=false
counter=2

See below for valid keys.

• master_password=

The master password. Corresponds to lesspass MASTER_PASSWORD argument.

• login=

The site login. Corresponds to lesspass LOGIN argument.

• length=

The generated password length. Corresponds to lesspass --length flag.

• counter=

Password counter. Corresponds to lesspass --counter flag.

• lowercase=

Include lowercase in password if set to true. Corresponds to lesspass --lowercase or --no-lowercase flags.

• uppercase=

Include uppercase in password if set to true. Corresponds to lesspass --uppercase or --no-uppercase flags.

• digits=

Include digits in password if set to true. Corresponds to lesspass --digits or --no-digits flags.

• symbols=

Include symbols in password if set to true. Corresponds to lesspass --symbols or --no-symbols flags.

• password=

Use this password instead of generating one.

⁠License

This project is licensed under the MIT License (see LICENSE⁠).