about summary refs log tree commit diff stats
path: root/ayu.mdoc
blob: b5d75d4cd1d2fbea95e6fc95e4cbda7d0d6689cd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.Dd March 23, 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 -n
Add a new entry
.It -c
Copy an entry's text to the clipboard
.It -e
Edit an entry
.It -l
List all entries
.It -r
Remove single entries
.It -R
Remove recursively a directory w/ entries
.It -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
.Ev Sy $ayu_dir
Runtime directory
.Pp
.Ev Sy $ayu_store
Password store
.Pp
.Ev Sy $ayu_clipboard
Clipboard program to be used.
Defaults to
.Xr xclip 1
.Pp
.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.