path: root/ayu.mdoc

.Dd May 7, 2022
.Dt ayu 1
.Os
.Sh NAME
.Nm ayu
.Nd an actually boring password manager
.Sh DESCRIPTION
My own take with password managers, this one uses
.Xr age 1
as backend, instead of 
.Xr gpg 1
for encryption.
.Pp
This program is generally stable by now, and can be used as replacement to either
.Xr angou 1
or
.Xr pass 1
.Pp
There may be breaking changes but shouldn't be much.
.Pp
This silly thing could've been written in C or something
but there's already a Go variant using age's library.
.Pp
So it's not like I'm gonna care.
.Sh USAGE
.Bl -tag -width 11n -compact
.It add, -n
Add a new entry
.It copy, -c
Copy an entry's text to the clipboard
.It edit, -e
Edit an entry
.It list, -l
List all entries
.It del, -r
Remove single entries
.It delr, -R
Remove recursively a directory w/ entries
.It view, -v
View an entry
.Bl
.Sh CAVEATS
You have to generate your own keypair using 
.Xr age-keygen(1)
.Pp
The private key should be placed on 
.Em ~/.ayu/private_key
and the public key to 
.Em ~/.ayu/public_key
for the utility to work
.Sh ENVIRONMENT VARIABLES
.Bl -tag -width 11n -compact
.It Ev Sy $ayu_clipboard
Clipboard program to be used
.It Ev Sy $ayu_dir
Runtime directory
.It Ev Sy $ayu_editor
Default editor used by this program
.It Ev Sy $ayu_store
Password store
.El
.Sh SEE ALSO
.Xr age 1
.Xr age-keygen 1 
.Xr less 1
.Xr sh 1
.Xr tree 1
.Xr vi 1
.Xr xclip 1
.Rs
.%A Rob Pike
.%T "UNIX Style, or cat -v Considered Harmful"
.%J "USENIX Summer Conference Proceedings"
.%D 1983
.Re
.Sh AUTHORS
.An Aoi Koizumi
.Mt novaburst@kalli.st
.Sh BUGS
Under the Wayland display server, 
.Nm ayu 
.Sy -c
won't work well because of 
"Permmission denied" errors.
.Pp
However
.Xr xsel 1
on X11 should work fine.