Kanako (神奈子)

The infinitely adaptable password manager, written in Bourne Shell.
Named after one of the deities of the ​Moriya Shrine, ​Kanako Yasaka, from ​Mountain of Faith

Supported back-ends

• ​age
• ​cream
• ​gpg
• ​salty

Setting it up

1. Copy ​kanako.conf.example to ~/.config/kanako/kanako.conf and edit accordingly, there are all sorts of examples for each backend supported.
2. Create ~/.kanako and ~/.kanako-store with mkdir -p, the former stores your key pair, the latter your password store.

Using the password store

Listing all existing entries

$ kanako -l

/home/user/.kanako-store/
|--- Git
|    |--- github.com
           |--- password
           |--- username
[...]

Copying entries to the clipboard

You need to uncomment the proper fields to use either xclip or wl-copy.\ Note: Complete support for Wayland is not a goal (and in fact, it's inviable)

kanako -c Git/github.com/password

Adding entries to the store

You have to set $EDITOR , if unset, the default is vi , which may or may not be available on your system.

$ kanako -n Social/misskey.io/password
<editor screen omitted for brevity>

Removing entries from the store

You can remove them one at a time, with -r, or recursively, with -R.
Both ways require that rm supports the -i and -I flags, respectively.

Download

• ​Latest master

Git repository

You can ​browse the git repository or clone it:

$ git clone https://git.chaotic.ninja/yakumo.izuru/kanako

Extensions

• ​kanako-menu - quick graphical front-end, requires dmenu, but can also use bmenu instead.
• ​kanako-totp - time-based one time password addon, based on ​rgz.ee's code, requires oathtool from oath-toolkit.

Documentation

See the man pages: kanako(1), kanako.conf(5)

Credit & License

kanako was written by ​Izuru Yakumo of Yakumo Laboratories.

This program and the extensions are licensed under the ​Beerware License (Revision 42.1) -- based on Poul-Henning Kamp's license

/*
 * ----------------------------------------------------------------------------
 * "THE BEER-WARE LICENSE" (Revision 42.1):
 * <yakumo.izuru@chaotic.ninja> wrote this file. As long as you retain this notice you
 * can do whatever you want with this stuff. If we meet some day, and you think
 * this stuff is worth it, you can buy me a bottle of sake in return Izuru Yakumo
 * ----------------------------------------------------------------------------
 */