kanako (神奈子)

The infinitely adaptable password manager, written in pure Bourne Shell.
Named after one of the Moriya Shrine gods, Kanako Yasaka from Touhou 10: Mountain of Faith

Supported backends

• 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
[...]

Showing entries

$ kanako -v Git/github.com/password
VzGu5HTOKfvZD47mrSB02Xrkkce4UteMOyzjeTRT2074BZ4kj4UIllvp2uyDlgcWfUDyxKoacbKDu7Nu

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.

kanako -c Git/github.com/password

Adding entries to the store

You have to set $EDITOR, if unset, the default is vi

$ kanako -n Social/mastodon.social/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 Git
• Version 2.0

Both ways contain a typical Makefile and an mkfile (if you like to use Plan 9’s mk(1) instead), which should just work.

Git repository

You can browse the git repository or clone it:

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

Extensions for kanako

• 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 manual pages

Credit & License

kanako was written by Izuru Yakumo of chaotic.ninja.

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
 * ----------------------------------------------------------------------------
 */

Generated with aya 0.6.0@aaf177d