Passphrase generator based on diceware made available by the EFF.

René Maya c9fd334d34 "Add checksum for version 0.5.0" %!s(int64=5) %!d(string=hai) anos
bin db3cc37b16 Change api for adding expansions to add %!s(int64=6) %!d(string=hai) anos
checksum c9fd334d34 "Add checksum for version 0.5.0" %!s(int64=5) %!d(string=hai) anos
dev 10f9e93f85 Fix tag task %!s(int64=5) %!d(string=hai) anos
lib f6091c0d5d Increase version %!s(int64=5) %!d(string=hai) anos
test 611623b15d Remove whitespace from expectation %!s(int64=5) %!d(string=hai) anos
.autotest 8eb66729b4 Extract lorca_env env var to minitest config %!s(int64=5) %!d(string=hai) anos
.gitignore 5537d42943 Add wip task %!s(int64=5) %!d(string=hai) anos
.gitlab-ci.yml 54e364799d Fix CI file %!s(int64=5) %!d(string=hai) anos
.ignore.sample 5537d42943 Add wip task %!s(int64=5) %!d(string=hai) anos
ChangeLog.md dc7b9c87bc Update ChangeLog %!s(int64=6) %!d(string=hai) anos
Gemfile 2957a55ac8 Init lorca %!s(int64=6) %!d(string=hai) anos
License.md c90731bd7f Change license file extension for rdoc compatibility %!s(int64=6) %!d(string=hai) anos
Manifest.md 006f27103c Add security notes as part of the gem %!s(int64=5) %!d(string=hai) anos
Rakefile 8eb66729b4 Extract lorca_env env var to minitest config %!s(int64=5) %!d(string=hai) anos
ReadMe.md 387d61f7fb Update installation and update instructions %!s(int64=5) %!d(string=hai) anos
Security.md 387d61f7fb Update installation and update instructions %!s(int64=5) %!d(string=hai) anos
_expand_lib_path.rb fe7d33ba49 Start cli dev %!s(int64=6) %!d(string=hai) anos
lorca.gemspec c87bd03b6a Update bundler %!s(int64=5) %!d(string=hai) anos

ReadMe.md

Lorca

Version pipeline status

Details

Lorca is a gem for generating passphrases based on the algorithm originally described in EFF Dice-Generated Passphrases. It uses EFF's long word list. The generator can be used from the command line interface, or added as a library.

Passphrases, unlike passwords, are meant to be memorized. Check out these links for a few ideas on how to memorize them:

Passphrases are great password manager keys.

Quick Start

Command line interface

Generate, and copy to clipboard, an 8-word passphrase.

$ lorca -p

As Lorca is only capable of writing to the clipboard, it's up to the user to paste it, and store it, somewhere safe.

For more details on how to use the CLI

$ lorca

System Requirements

  • *nix OS.
  • xsel or xclip (linux)
  • Ruby 2.4+

Installation

CLI

To use Lorca as a command line interface:

$ gem fetch lorca -v <version>
$ ruby -rdigest/sha2 -e "puts Digest::SHA512.new.hexdigest(File.read('lorca-<version>.gem'))"

Compare it with the hash in checksum/lorca-<version>.gem.sha512 to verify the integrity of the fetched gem. If the checksum matches

$ gem install lorca -v <version>

Gem

To use Lorca as a gem add it to the project's Gemfile:

gem "lorca"

And then run

$ bundle install

For details on the API check out the online documentation.

Updates

Subscribe to the update notification feed. Whenever there's a new release available read the ChangeLog.md for details on what changed since the last release.

CLI

Fetch and verify gem, as above,

$ gem fetch lorca -v <version>
$ ruby -rdigest/sha2 -e "puts Digest::SHA512.new.hexdigest(File.read('lorca-<version>.gem'))"

then

$ gem update lorca
$ gem cleanup lorca

Gem

$ bundle update lorca

License

Copyright (c) 2018-2019, René Maya. Licensed ISC. Read attached License.md file for details.