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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
From: Ilias Tsitsimpis <iliastsi@debian.org>
Date: Mon, 22 Aug 2022 11:25:02 +0300
Subject: Add missing files
---
goobook.1.rst | 101 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 101 insertions(+)
create mode 100644 goobook.1.rst
diff --git a/goobook.1.rst b/goobook.1.rst
new file mode 100644
index 0000000..d841038
--- /dev/null
+++ b/goobook.1.rst
@@ -0,0 +1,101 @@
+=========
+ goobook
+=========
+
+-------------------------------------------------------------------
+access your Google contacts from mutt or the command line
+-------------------------------------------------------------------
+
+
+:Author: This manual page has been written by Dariusz Dwornikowski and Christer Sjöholm
+:Date: 2020-09-02
+:Manual section: 1
+:Manual group: User Manuals
+
+.. :Copyright: public domain
+.. :Version: 0.1
+
+
+SYNOPSIS
+--------
+**goobook** [ options ] COMMAND
+
+
+DESCRIPTION
+-----------
+**goobook** can be used to access your Google contacts from the command line. It can also
+be easily integrated into MUAs such as mutt. It can be used from mutt the same
+way as abook.
+
+
+OPTIONS
+-------
+
+-h, --help
+ show the help message and exit
+
+-c FILE, --config FILE
+ specify alternative configuration file
+
+-v, --verbose
+ be verbose about what is going on (stderr)
+
+-V, --version
+ print version and exit
+
+-d, --debug
+ output debug information to stderr
+
+
+COMMAND
+-------
+
+authenticate
+ Allow goobook to access your Google contacts using OAuth2.
+
+add [NAME] [EMAIL] [PHONE]
+ Add a new Google contact. If NAME and EMAIL is not specified, read an email address from stdin and add the From: address to your Google contacts.
+
+config-template
+ Display a config template of that can be written to **~/.config/goobookrc**.
+
+dump_contacts
+ dump all your contacts to XML (stdout).
+
+dump_groups
+ dump your contact groups to XML (stdout).
+
+dquery QUERY_STRING
+ Search contacts for QUERY_STRING, nice vcard like output.
+ QUERY_STRING is a Python flavoured regexp where all ' ' is replaced with .*.
+
+query [-s|--simple] QUERY_STRING
+ Search contacts for QUERY_STRING, mutt compatible plain text output.
+ --simple output format was requested for use with notmuchmail.
+ QUERY_STRING is a Python flavoured regexp where all ' ' is replaced with .*.
+
+reload
+ Reload contacts from Google and update cache.
+
+
+CONFIGURATION
+-------------
+| For most users it will be enough to run:
+|
+| **goobook** authenticate --help
+|
+| and follow the instructions
+
+| To have access to more advanced options, you can generate a config file by doing:
+|
+| **goobook** config-template > ~/.config/goobookrc
+
+An example config can look like this::
+
+ [DEFAULT]
+ cache_expiry_hours: 24
+
+
+SEE ALSO
+--------
+Website: https://pypi.python.org/pypi/goobook/
|
