Homura (ほむら)

A password manager, like any other, unlike any other. It is an almost compatible rewrite of Kanako in Go.

Named after Homura Akemi from Puella Magi Madoka Magica.

Building

Homura requires Go >= 1.26.4 to build. If there are multiple build tags, separate them with commas.

Dependencies

• A text editor, it will launch anything set in $EDITOR, or vi otherwise
• xclip, in case the built-in feature does not work in a particular environment.

Features

• Adding entries
• Copying entries to clipboard (can be disabled with no_clip)
• Encryption and decryption with multiple backends (selectable between age, pgp and saltpack at build-time)
• Displaying entries
• Generating passwords (base32, base64, and hex, can be disabled with no_gen)
• Handling one time passwords (both RFC 4226 and RFC 6238, can be disabled with no_otp)
• Pretty-printing the store's contents
• Removing entries (even recursively)

Non-goals

• Integration with any version control system

• Rationale: Even if the passwords are encrypted, you are not supposed to expose the store to the internet, however, if you do that in an offline way, it should be relatively safe.

• Key-pair generation

• Rationale: There are existing tools for that, use them, they exist for a reason.

Usage

Read the sample configuration file in the examples/ directory, modify it as you must, and copy it to ~/.config/homura.ini